📱 应用

📱 在 Capgo 中管理您的应用设置和配置，Capgo Cloud

➕ 添加

别名： a

npx @capgo/cli@latest app add

➕ 在 Capgo Cloud 中添加一个新的应用程序，使用唯一的应用程序 ID 格式为 com.test.app。 如果未提供，则所有选项都可以从配置中推断出来。

示例：

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

选项：

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

🗑️ 删除

npx @capgo/cli@latest app delete

🗑️ 从 Capgo Cloud 中删除一个应用，选填指定版本删除特定包。

示例：

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

选项：

参数	类型	描述
-a	string	API 账户关联的密钥
—自定义主机	string	Custom Supabase host URL (for self-hosting or Capgo development)
—自定义 anon	string	自定义 Supabase anon 密钥（用于自主托管）

📋 列表

别名： l

npx @capgo/cli@latest app list

📋 列出您在 Capgo 云中注册的所有应用程序。

示例：

npx @capgo/cli@latest app list

选项:

参数	类型	描述
-a	string	API
__CAPGO_KEEP_0__	string	Custom Supabase host URL (for self-hosting or Capgo development)
自定义 Supabase anon key (用于自主托管)	string	调试

🐞 —自定义主机URL(用于自主托管或__CAPGO_KEEP_0__开发)

npx @capgo/cli@latest app debug

🐞 在 Capgo Cloud 中实时更新事件中监听以调试您的应用。 可选地，针对特定设备进行详细诊断。

示例：

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

选项：

参数	类型	描述
-a	string	API key 到您的帐户
-d	string	用于调试的具体设备 ID
—supa-host	string	自主托管或Capgo开发时的自定义 Supabase 主机 URL
—supa-anon	string	自主托管时的自定义 Supabase 匿名密钥

⚙️ 设置

npx @capgo/cli@latest app setting

⚙️ Modify Capacitor configuration programmatically. Specify setting path (e.g., plugins.CapacitorUpdater.defaultChannel) with —string or —bool.

示例：

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

⚙️ Update settings for an existing app in Capgo Cloud, such as name, icon, or retention period for bundles. Retention of 0 means infinite storage.

示例：

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

选项：

参数	类型	描述
-n	string	应用名称（在Capgo Cloud中显示）
-i	string	本地图像文件路径（png，jpg，webp，svg）用于Capgo Cloud中的应用图标
-a	string	API账户关联密钥
-r	string	保留旧包的天数（0 = 无限，默认：0）
--expose-metadata	string	向插件暴露包元数据（链接和评论）（true/false，默认：false）
--preview	boolean	为此应用启用包和频道预览二维码
—no-preview	boolean	禁用此应用的捆绑和频道预览二维码
—allow-device-custom-id	boolean	允许设备为此应用设置自定义设备ID
—no-allow-device-custom-id	boolean	禁止此应用的自定义设备ID
—block-provider-infra-requests	boolean	阻止此应用的服务提供商基础设施请求
—no-block-provider-infra-requests	boolean	允许此应用的服务提供商基础设施请求
—build-timeout-minutes	string	原生构建超时（分钟，范围：5-360，默认值：15）
—ios-app-store-url	string	iOS App Store URL for this app
—android-app-store-url	string	Google Play Store URL for this app
—default-upload-channel	string	Default upload channel name for this app
—default-download-channel	string	Default download channel name for this app (sets channel public=true)
—disable-download-channels	boolean	Disable Capgo download channels for this app (sets all channels public=false)
—custom-supabase-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	自定义 Supabase 匿名密钥（适用于自托管）