📦 打包

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

⬆️ 上传

别名： u

npx @capgo/cli@latest bundle upload

⬆️ 将新应用程序包上传到 Capgo Cloud 进行分发。 版本必须大于 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	将文件上传到 Capgo 云而不是链接到外部 URL
—iv-session-key	string	设置包 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	将 bundle URL 打印到标准输出
—no-key	boolean	忽略签名密钥并发送清晰的更新
—no-code-check	boolean	忽略检查源 code 和索引文件是否在根目录中
—display-iv-session	boolean	在控制台中显示用于加密更新的 IV 和会话密钥
-b,	string	要上传的 bundle 版本号
—link	string	链接到外部资源（例如 GitHub 的发布）
—评论	string	关于此版本的评论，可能是发布说明，提交哈希，提交消息等。
—最小更新版本	string	最小版本要求才能更新到此版本。仅当在频道中设置为元数据时才使用
—基于原生包的最小更新版本	boolean	上传时忽略元数据（node_modules）检查
上传时忽略校验和检查	boolean	强制CRC32校验和上传（覆盖自动检测）
—强制CRC32校验和上传（覆盖自动检测）	boolean	—强制CRC32校验和上传（覆盖自动检测）
—强制CRC32校验和上传（覆盖自动检测）	boolean	—强制CRC32校验和上传（覆盖自动检测）
—超时	string	上传过程超时时间（秒）
—多部分	boolean	[已弃用] 使用 —tus 代替。使用多部分协议进行 S3 上传
—压缩包	boolean	使用 zip 压缩包上传到 Capgo 云（遗留）
—TUS	boolean	使用 TUS 上传压缩包到 Capgo 云
—TUS 分块大小	string	TUS 可恢复上传的分块大小（默认：自动）
—部分	boolean	[已弃用] 使用 —delta 代替。上传增量更新
—部分上传	boolean	[DEPRECATED] 使用 —delta-only 代替。仅上传增量更新，跳过完整包
—delta	boolean	上传 delta 更新（仅更改的文件）以实现实时、超快更新，而不是大型 zip 下载
—delta-only	boolean	仅上传 delta 更新，无完整包，以实现最大速度（适用于大型应用）
—no-delta	boolean	禁用 delta 更新，即使启用了直接更新
—加密校验和	string	用于仅在上传外部包时使用的加密校验和（签名）
—自动设置包	boolean	设置包在 capacitor.config.json
—dry-upload	boolean	将捆绑包上传过程设置为干燥模式，表示不会上传文件，但会在数据库中添加一行（Capgo用于内部测试）
—package-json	string	多包仓库中的package.json文件路径（用逗号分隔）
—node-modules	string	多包仓库中的node_modules目录路径（用逗号分隔）
—encrypt-partial	boolean	对delta更新文件进行加密（自动启用Updater > 6.14.4）
—delete-linked-bundle-on-upload	boolean	在您尝试上传的频道中找到当前链接的捆绑包，然后删除它
—no-brotli-patterns	string	不压缩的文件模式（用逗号分隔的glob模式，例如“”.jpg,.png
—禁用Brotli压缩	boolean	完全禁用Brotli压缩，即使更新器版本支持它
—版本存在时退出	boolean	如果包版本已经存在，退出成功，适用于CI/CD工作流程中的多包仓库
—自我分配	boolean	允许设备自动加入此频道（更新频道设置）
—自主主机	string	自定义Supabase主机URL（用于自主托管或Capgo开发）
—自主匿名	string	自定义Supabase匿名密钥（用于自主托管）
—verbose	boolean	详细日志输出

🧪 兼容性

npx @capgo/cli@latest bundle compatibility

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

终端窗口

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

参数：

options	类型	描述
-a,	string	API key to link to your account
-c,	string	Channel to check the compatibility with
—text	boolean	输出文本而不是表情符号
—package-json	string	多包项目的package.json文件路径（逗号分隔）
—node-modules	string	多包项目的node_modules目录路径（逗号分隔)
—supa-host	string	自定义 Supabase 主机 URL（用于自主托管或 Capgo 开发）
—supa-anon	string	自定义 Supabase 匿名密钥（用于自主托管）

🔹 ReleaseType

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目录路径（逗号分隔)
—自定义主机	string	Custom Supabase host URL (for self-hosting or Capgo development)
—自定义匿名	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用于链接到您的帐户的密钥
—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 key 链接到您的帐户
—supa-host	string	自定义 Supabase 主机 URL（用于自主托管或 Capgo 开发）
—supa-anon	string	自定义 Supabase 匿名密钥（用于自主托管）

🧹 Cleanup

别名： 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	强制删除
—ignore-channel	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

示例：

终端窗口

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

选项：

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

🔹 压缩包

npx @capgo/cli@latest bundle zip

🗜️ 生成您的应用程序包的压缩包。 返回用于加密的校验和。使用 —json 获取机器可读输出。

示例：

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

选项：

参数	类型	描述
-p,	string	capacitor配置文件中设置的webDir所在的文件夹路径，如果未提供则使用此路径
-b,	string	打包版本号，用于命名zip文件
-n,	string	zip文件名称
-j,	string	以JSON输出
--no-code-check	boolean	忽略检查源code和根文件夹中的index是否存在
--key-v2	boolean	使用加密 v2
—package-json	string	多仓库的package.json文件路径（用逗号分隔）