🔹 构建

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

🚀 初始化

别名： onboarding

npx @capgo/cli@latest build init

设置 iOS 构建凭证（自动创建证书和配置文件）。在 macOS 上，它还可以为您创建 App Store Connect API 密钥，带有指导。

🔹 请求

npx @capgo/cli@latest build request

从 Capgo Cloud 请求本机构建。 此命令将压缩您的项目目录并将其上传到 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-password	string	iOS：证书密码（如果证书没有密码，则可选）
—apple-id	string	iOS: Apple ID邮箱用于应用特定密码上传（App Store Connect密钥的替代方案API）
—apple-app特定密码	string	iOS: TestFlight上传的应用特定密码（xxxx-xxxx-xxxx-xxxx）
—apple-app ID	string	iOS: App Store Connect应用ID（与—apple-id和—apple-app特定密码一起使用）
—apple-key ID	string	iOS: App Store ConnectAPI密钥ID
—apple-发行者 ID	string	iOS: App Store Connect发行者ID
—apple-key内容	string	iOS: App Store ConnectAPI密钥（.p8）
—App Store Connect团队ID	string	iOS: App Store Connect Team ID
—ios-scheme	string	iOS: Xcode 系统安程床一行 (default: App)
—ios-target	string	iOS: Xcode 系统安程床丁行和笔记程床一行 (default: same as scheme)
—ios-distribution	string	iOS: 台为给管球器
—ios-provisioning-profile	string	iOS: 网络管球程床业路形为网络管球程床一行网络管球程床丁行网络管球程床一行网络管球程床丁行 (repeatable)
—android-keystore-file	string	中国: Base64结筘管球类书
—keystore-key-alias	string	Android: Keystore key别名
—keystore-key密码	string	Android: Keystore key密码
—keystore-store密码	string	Android: Keystore store密码
—play-config-json	string	Android: Base64-encoded Google Play服务账户JSON
—android-flavor	string	Android: 产品风味（例如生产）用于构建。如您的项目具有多个风味，则必填。
—no-playstore-upload	boolean	跳过此构建的Play Store上传（清空保存的play配置）。需要—output-upload。
—output-upload	boolean	Override 本次构建的输出上传行为 (启用). 优先级: CLI > env > saved credentials
—no-output-upload	boolean	Override 本次构建的输出上传行为 (禁用). 优先级: CLI > env > saved credentials
—output-retention	string	Override 本次构建的输出链接有效期 (1h 到 7d). 示例: 1h, 6h, 2d. 优先级: CLI > env > saved credentials
—skip-build-number-bump	boolean	跳过自动构建号/版本 code 自动递增. 使用项目文件中的版本号.
—no-skip-build-number-bump	boolean	Override 保存的凭据以重新启用本次构建的自动构建号递增.
-a,	string	API 密钥用于链接到您的帐户
—supa-host	string	自定义 Supabase 主机 URL（用于自主托管或 Capgo 开发）
—supa-anon	string	自定义 Supabase 匿名密钥（用于自主托管）
—verbose	boolean	启用详细日志的verbose输出

🔹 凭据

npx @capgo/cli@latest build credentials

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

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

继续从构建

如果您正在使用 build 来规划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.