📱 App

📱 在 Capgo Cloud 中管理您的 Capgo 应用设置与配置。

➕ 添加

别名： a

npx @capgo/cli@latest app add

➕ 在 Capgo Cloud 中添加新应用，请使用 com.test.app 格式的唯一 app ID。 若未提供参数，所有选项均可从配置中自动推断。

示例：

npx @capgo/cli@latest app add com.example.app --name "My App" --icon ./icon.png

选项：

参数	类型	描述
-n	string	在 Capgo Cloud 中显示的 App 名称
-i	string	在 Capgo Cloud 中显示的 App 图标路径
-a	string	API 用于关联您的账户的密钥
—supa-host	string	自定义 Supabase host URL（用于自托管或 Capgo 开发）
—supa-anon	string	自定义 Supabase anon key（用于自托管）

🗑️ 删除

npx @capgo/cli@latest app delete

🗑️ 从 Capgo Cloud 中删除应用，可选择指定版本以仅删除该 bundle。

示例：

npx @capgo/cli@latest app delete com.example.app

选项：

参数	类型	描述
-a	string	API 用于关联您的账户的密钥
—supa-host	string	自定义 Supabase host URL（用于自托管或 Capgo 开发）
—supa-anon	string	自定义 Supabase anon key（用于自托管）

📋 列出

别名： l

npx @capgo/cli@latest app list

📋 列出您在 Capgo Cloud 账户下注册的所有应用。

示例：

npx @capgo/cli@latest app list

选项：

参数	类型	描述
-a	string	API 用于关联您的账户的密钥
—supa-host	string	自定义 Supabase host URL（用于自托管或 Capgo 开发）
—supa-anon	string	自定义 Supabase anon key（用于自托管）

🐞 调试

npx @capgo/cli@latest app debug

🐞 监听 Capgo Cloud 中的 live update 事件来调试您的应用。 也可以选择指定某台设备，以进行详细诊断。

示例：

npx @capgo/cli@latest app debug com.example.app --device DEVICE_ID

选项：

参数	类型	描述
-a	string	API 用于关联您的账户的密钥
-d	string	用于调试的具体设备 ID
—supa-host	string	自定义 Supabase host URL（用于自托管或 Capgo 开发）
—supa-anon	string	自定义 Supabase anon key（用于自托管）

⚙️ 设置

npx @capgo/cli@latest app setting

⚙️ 以编程方式修改 Capacitor 配置。 使用 —string 或 —bool 指定设置路径（例如 plugins.CapacitorUpdater.defaultChannel）。

示例：

npx @capgo/cli@latest app setting plugins.CapacitorUpdater.defaultChannel --string "Production"

选项：

参数	类型	描述
—bool	string	以布尔值形式修改设置，例如：—bool true
—string	string	以字符串形式修改设置，例如：—string “Production”

⚙️ 设置

别名： s

npx @capgo/cli@latest app set

⚙️ 更新 Capgo Cloud 中现有 App 的设置，例如名称、图标或 bundle 的保留周期。 保留周期设为 0 表示永久存储。

示例：

npx @capgo/cli@latest app set com.example.app --name "Updated App" --retention 30

选项：

参数	类型	描述
-n	string	在 Capgo Cloud 中显示的 App 名称
-i	string	用于 Capgo Cloud App 图标的本地图片路径 (png, jpg, webp, svg)
-a	string	API 用于关联您的账户的密钥
-r	string	保留旧 bundle 的天数 (0 = 无限制，默认: 0)
—expose-metadata	string	向 plugin 暴露 bundle 元数据 (link 和 comment) (true/false，默认: false)
—preview	boolean	为该 app 启用 bundle 和 channel 的预览二维码
—no-preview	boolean	为该 app 禁用 bundle 和 channel 的预览二维码
—allow-device-custom-id	boolean	允许设备为该 app 设置自定义 device ID
—no-allow-device-custom-id	boolean	禁止此应用使用自定义设备 ID
—block-provider-infra-requests	boolean	拦截此应用的 provider 基础设施请求
—no-block-provider-infra-requests	boolean	允许此应用的 provider 基础设施请求
—build-timeout-minutes	string	Native Build 超时时间（分钟，范围 5-360，默认：15）
—ios-store-url	string	此应用的 iOS App Store URL
—android-store-url	string	此应用的 Google Play Store URL
—default-upload-channel	string	此应用的默认 upload channel 名称
—default-download-channel	string	此应用的默认 download channel 名称 (将 channel 设置为 public=true)
—disable-download-channels	boolean	禁用此应用的 Capgo download channels (将所有 channel 设置为 public=false)
—supa-host	string	自定义 Supabase host URL（用于自托管或 Capgo 开发）
—supa-anon	string	自定义 Supabase anon key（用于自托管）