📦捆绑包

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

⬆️ 上传

别名： 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用于链接到您的帐户
-p,	string	要上传的文件夹路径，如果未提供则使用capacitor.config中的webDir
-c,	string	链接到频道
-e,	string	将链接到外部 URL 而不是上传到 Capgo Cloud
—iv-session-key	string	设置 IV 和会话密钥用于外部 URL 包装
—s3-region	string	您的 S3 存储桶的区域
—s3-apikey	string	API 的 S3 端点的密钥
—s3-apisecret	string	API 的 S3 端点的密钥
—s3-endpoint	string	S3 端点的 URL
—s3-bucket-name	string	AWS S3 桶的名称
__CAPGO_KEEP_0__	string	S3 端点的端口
__CAPGO_KEEP_0__	boolean	禁用 S3 上传的 SSL
__CAPGO_KEEP_0__	string	自定义私钥路径 (v2 系统)
__CAPGO_KEEP_0__	string	私钥 (v2 系统)
__CAPGO_KEEP_0__	boolean	将 bundle URL 打印到 stdout
__CAPGO_KEEP_0__	boolean	忽略签名密钥并发送清晰更新
—无需code检查	boolean	忽略检查源code和根目录中的索引是否调用了notifyAppReady()方法
—显示IV会话	boolean	在控制台中显示用于加密更新的IV和会话密钥
-b,	string	要上传的捆绑包的版本号
—链接	string	链接到外部资源（例如GitHub的发布）
—评论	string	关于此版本的评论，可能是发布说明、提交哈希、提交消息等
—最小更新版本	string	仅用于在禁用自动更新时更新到此版本的最小版本。仅在渠道中设置为元数据时使用
—auto-min-update-version	boolean	基于本机包设置最小更新版本
—ignore-metadata-check	boolean	上传时忽略元数据（node_modules）检查
—ignore-checksum-check	boolean	上传时忽略校验和检查
—force-crc32-checksum	boolean	强制CRC32校验和上传（覆盖自动检测）
—timeout	string	上传过程超时时间（以秒为单位）
—multipart	boolean	[DEPRECATED] 使用 —tus 代替。使用多部分协议进行 S3 上传
—zip	boolean	使用 zip 压缩包上传到 Capgo 云（遗弃）
—tus	boolean	使用 TUS 上传包到 Capgo 云
—tus-chunk-size	string	TUS 可恢复上传的字节块大小（默认：自动）
—partial	boolean	[DEPRECATED] 使用 —delta 代替。上传增量更新
—partial-only	boolean	[DEPRECATED] 使用 —delta-only 代替。仅上传增量更新，跳过完整包
—delta	boolean	上传增量更新 (仅更改的文件) 以实现即刻、超快的更新而不是大型 zip 下载
—增量更新	boolean	仅上传增量更新而不使用完整包以获得最大速度 (适用于大型应用)
—不增量	boolean	禁用增量更新，即使启用了直接更新
—加密校验和	string	加密校验和 (签名)。仅在上传外部包时使用
—自动设置包	boolean	设置包在 capacitor.config.json 中
—干燥上传	boolean	干燥上传包过程，意味着不会上传文件但会在数据库中添加行 (由 Capgo 内部测试使用)
—package.json	string	多仓库项目的package.json文件路径（逗号分隔）
—node-modules	string	多仓库项目的node_modules目录路径（逗号分隔）
—encrypt-partial	boolean	自动启用更新器（> 6.14.4）时，加密delta更新文件
—delete-linked-bundle-on-upload	boolean	在您尝试上传的频道中找到当前链接的捆绑包并删除它
—no-brotli-patterns	string	要排除的Brotli压缩文件（逗号分隔模式，例如“*.js, *.jpg, *.png”）—disable-brotli禁用Brotli压缩
—disable-brotli	boolean	完全禁用 brotli 压缩，即使更新器版本支持它
—version-exists-ok	boolean	如果捆绑版本已经存在，退出成功，适用于 CI/CD 工作流程中的多包仓库
—self-assign	boolean	允许设备自动加入此频道（更新频道设置）
—supa-host	string	自定义 Supabase 主机 URL（用于自主托管或 Capgo 开发）
—supa-anon	string	自定义 Supabase 匿名密钥（用于自主托管）
—verbose	boolean	启用详细日志的verbose输出

🧪 兼容性

npx @capgo/cli@latest bundle compatibility

🧪 检查一个特定频道的包与 Capgo Cloud 的兼容性，以确保更新是安全的。

示例：

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

选项：

参数	类型	描述
-a,	string	API key 链接到您的帐户
-c,	string	Channel 检查兼容性
—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 key to link to your account
-c,	string	与之比较的频道
—package-json	string	多包仓库的package.json文件路径（逗号分隔）
—node-modules	string	多包仓库的node_modules目录路径（逗号分隔）
—supa-host	string	自主托管或Capgo开发的自定义Supabase主机URL
—supa-anon	string	自定义 Supabase 匿名密钥（用于自主托管）

🗑️ 删除

别名： d

npx @capgo/cli@latest bundle delete

🗑️ 从 Capgo 云中删除特定包， optionally 目标单个版本。

示例：

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

选项：

参数：	类型	描述
-a,	string	API key to link to your account
—supa-host	string	自定义 Supabase 主机 URL（用于自主托管或 Capgo 开发)
—supa-anon	string	自定义 Supabase 匿名密钥（用于自主托管)

📋 列表

别名： l

npx @capgo/cli@latest bundle list

📋 为应用程序在 Capgo Cloud 中列出所有上传的包装.

示例：

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 云中删除旧的捆绑包，保留指定数量的最近版本。 与频道相关的捆绑包除非使用 —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	强制删除
—忽略频道	boolean	删除与频道相关的包（警告：也会删除频道）
—supa-host	string	自定义 Supabase 主机 URL（用于自主托管或 Capgo 开发）
—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	私钥
—checksum	string	包的校验和（用于验证包的完整性）
—package-json	string	多包项目中的package.json文件路径（逗号分隔）

🔹 Zip

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	忽略源code和索引文件夹中是否调用notifyAppReady()的检查
—key-v2	boolean	使用加密v2
—package-json	string	多包仓库的package.json文件路径（逗号分隔)

继续从 bundle 中进行

如果您正在使用 bundle 来规划安全性和合规性，连接它与 Encryption Encryption 的实现细节中 Compliance Compliance 的实现细节中 Capgo 安全扫描器 Capgo 安全扫描器中的产品工作流程 Capgo 安全 为产品工作流程在Capgo安全中 Capgo信任中心 为产品工作流程在Capgo信任中心中