__CAPGO_KEEP_0__

📦 为在 Capgo Cloud 进行部署的应用程序包管理，包括上传、兼容性检查和加密。

⬆️ 上传

别名： u

npx @capgo/cli@latest bundle upload

⬆️ 上传一个新的应用程序包到 Capgo 云进行分发。 版本必须大于 0.0.0 并且唯一。已删除的版本不能重用以保证安全。 外部选项：仅存储一个 URL 链接（对于大于 200MB 的应用程序或隐私要求有用）。 Capgo never 检查外部内容。添加加密以实现无信任安全性。

示例：

npx @capgo/cli@latest bundle upload com.example.app --path ./dist --channel production

选项：

参数	类型	描述
-a,	string	API key连接到您的账户
-p,	string	capacitor.config 中设置的 webDir 如果未提供，则使用该路径
-c,	string	连接到频道
-e,	string	将链接指向外部 URL 而不是上传到 Capgo 云
—iv-session-key	string	设置 bundle URL 外部的 IV 和会话密钥
—s3-region	string	您的 S3 存储桶的区域
—s3-apikey	string	API 的S3终端节点API密钥
—s3-apisecret	string	API 的S3终端节点API密钥
—s3-endpoint	string	S3终端节点的URL
—s3-bucket-name	string	您的AWS S3存储桶的名称
—s3-port	string	您的S3终端节点的端口
—no-s3-ssl	boolean	禁用S3上传的SSL
—key-v2	string	自定义路径（v2系统）私有签名密钥
—key-data-v2	string	私有签名密钥（v2系统）
—bundle-url	boolean	将捆绑包URL打印到标准输出
—no-key	boolean	忽略签名密钥并发送清晰的更新
—no-code-check	boolean	忽略源code和根目录中索引文件是否存在的检查
—display-iv-session	boolean	在控制台中显示用于加密更新的IV和会话密钥
-b,	string	上传的捆绑包版本号
—link	string	链接到外部资源（例如 GitHub 版本）
—comment	string	关于此版本的注释，可能是发布说明、提交哈希、提交消息等
—min-update-version	string	用于更新到此版本的最低版本号。仅在设置为元数据的频道时使用
—auto-min-update-version	boolean	基于原生包设置最小更新版本号
—ignore-metadata-check	boolean	在上传时忽略元数据（node_modules）检查
—忽略校验和检查	boolean	忽略上传时的校验和检查
—强制CRC32校验和	boolean	强制CRC32校验和上传（覆盖自动检测）
—超时	string	上传过程超时（以秒为单位）
—多部分	boolean	[已弃用] 使用 —tus 代替。使用多部分协议进行 S3 上传
—压缩包	boolean	使用 zip 压缩包上传到 Capgo 云（遗留）
—TUS	boolean	使用 TUS 协议上传到 Capgo 云
—tus-分块大小	string	TUS 分块大小（以字节为单位）（默认：自动）
—部分	boolean	[已弃用] 使用 —delta 代替。上传增量更新
—部分仅	boolean	[已弃用] 使用 —delta-only 代替。仅上传增量更新，跳过完整包
—delta	boolean	上传差异更新（仅更改文件）以实现实时、超快更新而不是大型 zip 下载
—delta-only	boolean	仅上传差异更新而不包含完整包以实现最大速度（适用于大型应用）
—no-delta	boolean	即使启用了直接更新，也禁用差异更新
—加密校验和	string	用于上传外部包时的加密校验和（签名）。
—自动设置包	boolean	设置包在 capacitor.config.json 中
—干燥上传	boolean	干燥上传包过程，表示不会上传文件但会在数据库中添加行（由 Capgo 内部测试使用）
—package.json	string	多包项目中的package.json文件路径（用逗号分隔）
—node_modules	string	多包项目中的node_modules目录路径（用逗号分隔）
—部分加密	boolean	加密delta更新文件（自动启用Updater > 6.14.4）
—删除与上传目标通道相关的已链接包	boolean	Locates the currently linked bundle in the channel you are trying to upload to, and deletes it
—不压缩的模式	string	Files to exclude from Brotli compression (comma-separated globs, e.g., “.jpg,.png”)
—完全禁用Brotli压缩	boolean	Completely disable brotli compression even if updater version supports it
—如果包版本已存在则退出	boolean	Exit successfully if bundle version already exists, useful for CI/CD workflows with monorepos
—允许设备自动加入此频道（更新频道设置）	boolean	Allow devices to auto-join this channel (updates channel setting)
—自定义主机	string	自定义 Supabase 主机 URL（用于自主托管或 Capgo 开发）
—自定义匿名	string	自定义 Supabase 匿名密钥（用于自主托管）
—详细日志	boolean	启用详细日志输出

🧪 兼容性

npx @capgo/cli@latest bundle compatibility

🧪 检查 Capgo 云中的特定频道与包的兼容性，以确保更新是安全的。例如：

—自定义主机

npx @capgo/cli@latest bundle compatibility com.example.app --channel production

选项：

参数	类型	描述
-a,	string	API用于链接到您的帐户
-c,	string	频道以检查与其兼容性
—text	boolean	以文本形式输出而不是表情符号
—package-json	string	多仓库项目中的package.json文件路径（逗号分隔)
—node-modules	string	多仓库项目中的node_modules目录路径（逗号分隔)
—supa-host	string	自主托管或Capgo开发时的自定义Supabase主机URL
—supa-anon	string	自主托管时的自定义Supabase匿名密钥

🔹 发布类型

npx @capgo/cli@latest bundle releaseType

根据与渠道最新元数据的兼容性，打印“native”或“OTA”。

示例：

npx @capgo/cli@latest bundle releaseType com.example.app --channel production

选项：

参数	类型	描述
-a,	string	API用于链接到您的帐户
-c,	string	与渠道进行比较的渠道
—package-json	string	多包项目的package.json文件路径（逗号分隔）
—node-modules	string	多包项目的node_modules目录路径（逗号分隔）
—supa-host	string	自主托管或开发环境下的自定义Supabase主机URL（Capgo）
—supa-anon	string	自主托管下的自定义Supabase anon密钥

🗑️ 删除

别名： d

npx @capgo/cli@latest bundle delete

🗑️ 从 Capgo Cloud 中删除特定包，选项性地针对单个版本。

示例：

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

选项：

参数	类型	描述
-a,	string	API 的密钥以链接到您的帐户
—supa-host	string	自定义 Supabase 主机 URL（用于自主托管或 Capgo 开发）
—supa-anon	string	自定义 Supabase 匿名密钥（用于自主托管）

📋 列表

别名： l

npx @capgo/cli@latest bundle list

📋 列出 Capgo 中应用程序的所有已上传的包。

示例：

npx @capgo/cli@latest bundle list com.example.app

选项：

参数	类型	描述
-a,	string	API 链接到您的帐户
—supa-host	string	自定义 Supabase 主机 URL（用于自主托管或 Capgo 开发）
—supa-anon	string	自定义 Supabase 匿名密钥（用于自主托管）

🧹 清理

别名： c

npx @capgo/cli@latest bundle cleanup

🧹 在Capgo Cloud中删除旧的捆绑包，保留最近的版本数。 与频道相关的捆绑包除非使用—ignore-channel选项，否则会被保留。

示例：

npx @capgo/cli@latest bundle cleanup com.example.app --bundle=1.0 --keep=3

选项：

参数	类型	描述
-b,	string	删除应用的包版本号
-a,	string	API用于链接到您的帐户的密钥
-k,	string	保留的版本号
-f,	string	强制删除
—ignore-channel	boolean	即使链接到频道，也删除包（警告：也会删除频道）
—supa-host	string	自主托管或Capgo开发时的自定义Supabase主机URL
—supa-anon	string	自定义 Supabase 匿名密钥（用于自主托管）

🔒 加密

npx @capgo/cli@latest bundle encrypt

🔒 为安全外部存储加密 zip 包。 返回 ivSessionKey 用于上传/解密。使用 ‘bundle zip —json’ 获取校验和。

示例：

npx @capgo/cli@latest bundle encrypt ./myapp.zip CHECKSUM

选项：

参数	类型	描述
—key	string	自定义路径私有签名密钥
—key-data	string	私有签名密钥
-j,	string	以 JSON 格式输出
—package-json	string	多包仓库的 package.json 文件路径（以逗号分隔）

🔓 解密

npx @capgo/cli@latest bundle decrypt

🔓 解密一个加密的捆绑包（主要用于测试）。 打印base64会话密钥进行验证。

示例：

npx @capgo/cli@latest bundle decrypt ./myapp_encrypted.zip CHECKSUM

选项：

参数	类型	描述
—key	string	自定义私钥路径
—key-data	string	私有签名密钥
—校验和	string	包的校验和，用于验证包的完整性
—package-json	string	多包项目的package.json文件路径（逗号分隔）

🔹 压缩包

npx @capgo/cli@latest bundle zip

🗜️ 将您的应用程序包打包成zip文件。 返回用于加密的校验和。使用 —json 获取机器可读输出。

示例：

npx @capgo/cli@latest bundle zip com.example.app --path ./dist

选项:

参数	类型	描述
-p,	string	上传文件夹的路径，如果没有提供则使用capacitor.config中的webDir
-b,	string	打包版本号来命名zip文件
-n,	string	zip文件的名称
-j,	string	输出为 JSON
—no-code-check	boolean	忽略检查 notifyAppReady() 在源 code 和根目录中的索引是否被调用
—key-v2	boolean	使用加密 v2
—package-json	string	多包项目的 package.json 文件路径（以逗号分隔）

继续从捆绑包

如果您正在使用 捆绑包 来规划安全性和合规性，连接它 加密 加密的实现细节 合规 合规的实现细节 Capgo 安全扫描器 Capgo 安全扫描器的产品工作流程 Capgo 安全 Capgo 安全的产品工作流程 Capgo 信任中心 Capgo 信任中心的产品工作流程