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

何时使用该技能

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
```
参数和保留设置是否正确。