SuperAPI AI 工具集

experience-ui-bundle-2gp-deploy

部署与运维

查看项目

更新于 10-15 21:43

技能介绍

用途:将当前项目中已存在的 UI Bundle(位于 <packageDir>/uiBundles/<name>/,<packageDir> 取自 sfdx-project.json 的 packageDirectories,常见为 force-app/main/default)打包为 Salesforce 第二代包(2GP),并在另一组织安装、升级、卸载或发布。适用于 ISV 分发、跨组织共享或依赖目标组织已有元数据的分发场景。

主要能力:按需求覆盖选择 managed、unlocked(带命名空间)、unlocked(org-dependent 无命名空间)三种包风味;设置 sourceApiVersion 与 namespace;构建 bundle 的 dist/;按需接入 CustomApplication 与权限集;通过 sf package create / version create 创建包与可安装版本;通过 sf package install / uninstall / version promote 在订阅方组织或 Dev Hub 操作。资料还包含 ID 图例、运行时模型(origin 隔离、IP 保护、安装与增量升级语义)以及调试排查要点。

必要用法与限制:2GP 需在 Dev Hub 的 Setup 中手动开启“Enable Unlocked Packages and Second-Generation Managed Packages”,CLI 无法替代;未开启时 Package2 查询会报“sObject type 'Package2' is not supported”。操作前须确认 Dev Hub 与订阅方组织,避免误装到 Dev Hub。打包前须先完成 npm install 与 npm run build,否则安装后可能空白渲染。命名空间须已注册并链接到 Dev Hub,否则版本创建失败。--skip-validation 会生成 beta 版本,不能 promote,且 beta 不能升级 beta。unlocked 升级会覆盖订阅方对 bundle 的修改;org-dependent 升级失败无回滚;managed 为锁定替换。promote 在 Dev Hub 执行且不可逆。--wait 可能返回假成功,需用 sf package installed list 复核。其余未提供的细节暂未提供。