📱 应用

📱 在 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	自主托管或 Capgo 开发环境的自定义 Supabase 主机 URL
--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)
—自定义匿名密钥	string	自定义 Supabase 匿名密钥（用于自主托管）

📋 列表

别名： l

npx @capgo/cli@latest app list

📋 列表所有在Capgo中注册的应用程序

示例：

npx @capgo/cli@latest app list

选项:

参数	类型	描述
-a	string	API
__CAPGO_KEEP_0__	string	自定义 Supabase 主机 URL（用于自主托管或Capgo开发）
自定义 Supabase 匿名密钥（用于自主托管）	string	调试

🐞 —supa-host

npx @capgo/cli@latest app debug

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

示例：

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

选项：

参数	类型	描述
-a	string	API key to link to your account
-d	string	The specific device ID to debug
—supa-host	string	Custom Supabase host URL (for self-hosting or Capgo development)
—supa-anon	string	Setting

⚙️ Section titled “ ⚙️ Setting”

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 匿名密钥（适用于自托管）