开发指南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>验证至少包括:
- 安装记录引用目标 Bundle 版本。
resolvedLock中模块和平台应用版本准确。- 每个物化资源都有明确成功或失败状态。
- 模块已安装到目标 Runtime,方法可调用。
- 平台应用入口可见,平台网页授权可完成。
- 如果使用 Bundle 生命周期插件,外部资源已经创建且输出配置正确写入目标资源。
- 升级不会改变安装标识、重复创建外部租户或错误复用其他 Runtime 的外部资源。
卸载属于破坏性操作。执行前确认资源台账、共享 Bundle 依赖,以及生命周期插件声明的 外部资源停用、保留和补偿语义。