百积木文档
开发指南Bundle 开发

版本冻结、市场与交付

冻结 Bundle 资源锁,完成审核、市场发布、安装、升级和资源台账验证。

创建定义

先确认本机 CLI:

baijimu --version
baijimu bundle --help
baijimu bundle create --help

把 Manifest 保存为 JSON 文件后创建 Bundle:

baijimu bundle create <workspace> \
  --bundle-id <bundleId> \
  --name <name> \
  --manifest @bundle-manifest.json

发布 Bundle 版本

发布前确保所有模块版本已经在所属 Bundle 内冻结、平台应用版本已经生成,并把精确版本 写入 Manifest:

baijimu bundle version publish <workspace> <bundle> \
  --version <semanticVersion>

发布会校验资源归属、精确版本、依赖和安装适配,并生成不可变 resolvedLock。成功后 不会自动安装或升级任何工作区。模块没有与这条链路平行的审核、市场发布或安装入口。

审核和市场

工作区审核通过后,把指定 Bundle 版本提交公共市场:

baijimu bundle market publish <workspace> <bundle> \
  --version-id <bundleVersionId>

公共市场发布仍需完成市场审核。不要把“Bundle 版本已发布”“工作区审核通过”和 “公共市场已发布”视为同一状态。

安装和升级

baijimu bundle install <workspace> <bundle>

baijimu bundle upgrade <workspace> <bundle> \
  --version-id <bundleVersionId>

安装或升级后查询资源台账:

baijimu bundle resources <workspace> <bundle>

验证至少包括:

  1. 安装记录引用目标 Bundle 版本。
  2. resolvedLock 中模块和平台应用版本准确。
  3. 每个物化资源都有明确成功或失败状态。
  4. 模块已安装到目标 Runtime,方法可调用。
  5. 平台应用入口可见,平台网页授权可完成。
  6. 如果使用 Bundle 生命周期插件,外部资源已经创建且输出配置正确写入目标资源。
  7. 升级不会改变安装标识、重复创建外部租户或错误复用其他 Runtime 的外部资源。

卸载属于破坏性操作。执行前确认资源台账、共享 Bundle 依赖,以及生命周期插件声明的 外部资源停用、保留和补偿语义。

本页内容