用途:当项目存在 uiBundles/*/src/ 目录且任务涉及创建或配置用于承载 UI bundle 的 Custom Application 时,使用本技能生成并配置 Salesforce CustomApplication 元数据,让应用出现在 Lightning 应用启动器中,供内部用户访问。
主要能力:解析 appName、appNamespace、appLabel 等必需属性并为每个属性提供回退链;通过 salesforce-api-context MCP 工具查询目标组织的 API 版本可用字段,兼容新版本 <uiBundle>{appNamespace}__{appName}</uiBundle> 与旧版本 <webApplication>{appName}</webApplication>;生成 applications/{appName}.app-meta.xml;按需在 .uibundle-meta.xml 中添加 <target>CustomApplication</target>。
使用方式:先解析全部属性,再查询 API 上下文;在配置的 sourceDir(来自 sfdx-project.json 的默认 packageDirectories)下创建目录与元数据文件;按模板替换 {braces} 占位符;部署前验证:sf project deploy validate --metadata CustomApplication UIBundle --target-org ${usernameOrAlias}。
适用场景:为内部用户提供承载 React UI bundle 的 Lightning 启动器入口。
限制与注意:Custom Application 与 Experience Sites 不同,无需 Networks、CustomSite、DigitalExperienceConfig、DigitalExperienceBundle 元数据。appNamespace 与 appName 必须正确对应,否则启动器入口显示空白页。不得修改未以 {braces} 表示的默认属性值。具体定价、平台版本支持范围暂未提供。