🔹 构建

🏗️ 通过 Capgo Cloud管理原生iOS/Android构建.

🚀 初始化

别名： onboarding

npx @capgo/cli@latest build init

交互式设置 iOS 构建凭据（自动创建证书和配置文件）

🔹 请求

npx @capgo/cli@latest build request

从 Capgo 云请求原生构建。 此命令将压缩您的项目目录并将其上传到 Capgo 进行构建。 构建将被处理并直接发送到应用商店。 🔒 安全性：凭据永远不会在 Capgo 服务器上存储。它们将在构建完成后自动删除。 可选上传构建输出以获取有限期限下载链接。 📋 必备条件：首先使用以下命令保存凭据： npx @capgo/cli build credentials save --appId <app-id> --platform <ios|android>

示例：

npx @capgo/cli@latest build request com.example.app --platform ios --path .

选项：

参数	类型	描述
—path	string	项目构建目录的路径（默认：当前目录）
—platform	string	目标平台：ios 或 android（必填）
—build-mode	string	构建模式：debug 或 release（默认：release）
—build-certificate-base64	string	iOS：Base64编码的 .p12 证书
——p12-密码	string	iOS: 证书密码（如果证书没有密码则可选）
——apple-id	string	iOS: Apple ID 邮箱
——apple-app-specific-password	string	iOS: App 专用密码
——apple-key-id	string	iOS: App Store Connect API 密钥 ID
——apple-issuer-id	string	iOS: App Store Connect 发行者 ID
——apple-key-content	string	iOS: Base64编码的 App Store Connect API 密钥 (.p8)
——App Store Connect Team ID	string	iOS: App Store Connect Team ID
——iOS Xcode 构建方案	string	iOS: Xcode 构建方案 (默认: App)
——iOS 读取构建设置的 Xcode 目标	string	iOS: Xcode 读取构建设置的目标 (默认: 与方案相同)
——iOS 发布模式	string	iOS: 发布模式
——iOS 证书配置文件	string	iOS: 证书配置文件路径或 bundleId=path 映射 (可重复)
——Android.keystore 文件	string	Android: Base64编码的 keystore 文件
—__CAPGO_KEEP_0__	string	安卓：密钥库密钥别名
—__CAPGO_KEEP_0__	string	安卓：密钥库密钥密码
—__CAPGO_KEEP_0__	string	安卓：密钥库存储密码
—__CAPGO_KEEP_0__	string	安卓：Base64编码的Google Play服务账户JSON
—__CAPGO_KEEP_0__	string	安卓：构建的产品风味（例如生产）。如果您的项目有多个风味，则必填。
—__CAPGO_KEEP_0__	boolean	跳过此构建的Play Store上传（清空保存的Play配置）。需要—output-upload。
—output-upload	boolean	仅此次构建覆盖输出上传行为（启用）。优先级：CLI > env > 保存的凭据
—no-output-upload	boolean	仅此次构建覆盖输出上传行为（禁用）。优先级：CLI > env > 保存的凭据
—output-retention	string	仅此次构建覆盖输出链接有效期（1小时至7天）。示例：1小时，6小时，2天。优先级：CLI > env > 保存的凭据
—skip-build-number-bump	boolean	跳过自动构建号/版本code递增。使用项目文件中的版本号。
—no-skip-build-number-bump	boolean	覆盖保存的凭据，重新启用此次构建的自动构建号递增功能。
-a,	string	API用于链接到您的帐户
—自定义主机	string	Custom Supabase host URL (for self-hosting or Capgo development)
—自定义匿名	string	自定义 Supabase 匿名密钥（用于自主托管）
—详细日志	boolean	启用详细日志输出

🔹 凭据

npx @capgo/cli@latest build credentials

管理本地机器上存储的构建凭据。 🔒安全提示：

• 凭据保存在 ~/.capgo-credentials/credentials.json（全局）或 .capgo-credentials.json（本地）
• 当构建时，发送到 Capgo 但永远不会永久存储
• 从 Capgo 中删除立即后建
• 构建输出可选上传以获取有限时间下载链接 📚 文档: iOS 配置： https://capgo.app/docs/cli/cloud-build/ios/ Android 配置： https://capgo.app/docs/cli/cloud-build/android/

继续从建

如果您正在使用 建 来规划CI/CD自动化，连接它与 Capgo CI/CD 为产品工作流程在 Capgo CI/CD 中 Capgo 本机构建 为产品工作流程在 Capgo 本机构建中 Capgo 集成 为产品工作流程在 Capgo 集成中 CI/CD 集成 CI/CD 集成的实现细节， GitHub 动作集成 for the implementation detail in GitHub Actions Integration.