capgo-native-builds

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Capgo Native Builds

Capgo原生构建

Use Capgo native builds for iOS and Android cloud build requests.

使用Capgo原生构建来请求iOS和Android的云构建。

When to Use This Skill

使用本Skill的场景

User wants a hosted native iOS or Android build
User needs Capgo build credentials configured or updated
User needs signed build artifacts and temporary output download links

用户需要托管式的iOS或Android原生构建
用户需要配置或更新Capgo构建凭证
用户需要签名后的构建产物以及临时输出下载链接

Procedures

操作流程

Step 1: Prepare Credentials

步骤1：准备凭证

Before requesting a build, save credentials locally with the Capgo CLI.

Use the credential workflow that matches the platform:

iOS -> certificate, provisioning profiles, App Store Connect credentials
Android -> keystore and Play config

在请求构建前，使用Capgo CLI在本地保存凭证。

选择与平台匹配的凭证工作流：

iOS -> 证书、配置描述文件、App Store Connect凭证
Android -> 密钥库和Play配置

Step 2: Request the Build

步骤2：请求构建

Prefer the Capgo build flow:

bash

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

Use

--platform android

for Android builds.

Add

--output-upload

when the user needs a time-limited download link for the build output.

优先使用Capgo构建流程：

bash

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

Android构建使用

--platform android

参数。

如果用户需要构建输出的限时下载链接，添加

--output-upload

参数。

Step 3: Adjust Build Inputs

步骤3：调整构建输入

Handle platform-specific build inputs as needed:

iOS scheme, target, distribution mode, provisioning profile mapping
Android flavor, keystore alias, Play config

Only add flags that the project actually needs.

根据需要处理平台特定的构建输入：

iOS scheme、target、分发模式、配置描述文件映射
Android flavor、密钥库别名、Play配置

仅添加项目实际需要的参数。

Step 4: Manage Credentials

步骤4：管理凭证

Use the Capgo CLI credential commands for updates:

```
build credentials save
```
```
build credentials list
```
```
build credentials update
```
```
build credentials clear
```
```
build credentials migrate
```

Keep credentials local unless the user explicitly wants project-local storage.

使用Capgo CLI的凭证命令进行更新：

```
build credentials save
```
```
build credentials list
```
```
build credentials update
```
```
build credentials clear
```
```
build credentials migrate
```

除非用户明确要求项目本地存储，否则将凭证保留在本地。

Error Handling

错误处理

For iOS signing failures, re-check certificate, provisioning mapping, and App Store Connect fields before retrying the build.
For Android signing failures, re-check the keystore path, alias, and passwords before changing build logic.
For missing output artifacts, verify
```
--output-upload
```
and retention settings first.

对于iOS签名失败，在重试构建前重新检查证书、配置描述文件映射和App Store Connect字段。
对于Android签名失败，在更改构建逻辑前重新检查密钥库路径、别名和密码。
对于缺失的输出产物，首先验证
```
--output-upload
```
参数和保留设置。