Xcode 12上传Mac应用报登录项helper沙箱未启用的ITMS-90296错误
根因
Xcode 12 对 Mac App Store 构建的自动签名规则、Apple 上传校验对内嵌可执行组件的要求都做了收紧:
- Xcode 11 及更早版本允许非独立分发的辅助组件(如登录助手)复用主应用的 Provisioning Profile 完成签名,即使其独立 Bundle ID 未在开发者账号注册
- Xcode 12 开始强制要求:所有打包进主应用、面向 Mac App Store 分发的独立可执行 Bundle(包括
Contents/Library/LoginItems下的助手、Contents/PlugIns下的插件),必须满足:- 自身的 Bundle ID 已在开发者账号 Identifiers 模块注册
- 拥有匹配自身 Bundle ID 的有效 Distribution Provisioning Profile,且该 Profile 已授权 App Sandbox 权限
你本地执行 codesign --verify --deep 验证通过,是因为本地校验只检查签名完整性,不会校验 Entitlements 是否被 Provisioning Profile 实际授权。你目前的情况是:Helper 的 Entitlements 文件虽然写了 com.apple.security.app-sandbox = true,但因为 Bundle ID 未注册、没有对应 Profile,该权限未被固化到有效签名链中,因此触发 Apple 的 ITMS-90296 报错。
分步解决方案
- 第一步:注册 Helper 的 Bundle ID
登录开发者账号后台,在「证书、标识符和描述文件」模块,新增注册 Helper 对应的独立 Bundle ID(例如com.mycompany.myapp.launcher),注册时勾选App Sandbox能力,完成保存。 - 第二步:为 Helper 生成对应 Provisioning Profile
选择面向 Mac App Store 分发的 Distribution 类型,匹配刚注册的 Helper Bundle ID,绑定你的开发者账号分发证书,生成并下载对应的 Provisioning Profile 到本地。 - 第三步:调整签名配置
不要给三个组件共用同一份 Entitlements 文件,先单独为 Helper 创建独立的 Entitlements 文件:- 保留已有的
com.apple.security.app-sandbox = true配置 - 移除主应用专属的多余权限(例如网络访问、iCloud、支付等不需要给登录助手的权限)
选中 Helper 的 Target,在「Signing & Capabilities」标签页: - 若使用手动签名:取消「Automatically manage signing」,Team 选择你的开发者团队,Provisioning Profile 选择刚下载的、对应 Helper Bundle ID 的 Distribution Profile,Signing Certificate 选择你的 Mac Distribution 证书
- 若使用自动签名:保持勾选自动管理即可,Xcode 12 会自动匹配已注册的 Bundle ID 生成对应 Profile
- 保留已有的
- 第四步:调整 PlugIn 的签名配置(推荐)
如果 PlugIn 同样拥有独立 Bundle ID 且未注册,按照上述相同流程完成注册和 Profile 配置,避免后续触发同类报错。 - 第五步:重新构建并预校验
执行清理构建目录操作(Shift + Command + K),重新归档构建,可执行以下命令提前校验 Helper 的签名授权是否生效:
确认输出的 entitlements 列表中包含codesign -d --entitlements - "/Path/To/Build/Products/MyApp.app/Contents/Library/LoginItems/MyApp Launcher.app"com.apple.security.app-sandbox且值为true,同时执行以下命令校验 provisioning profile 的匹配性:
若输出包含security cms -D -i "/Path/To/Build/Products/MyApp.app/Contents/Library/LoginItems/MyApp Launcher.app/Contents/embedded.provisionprofile" | grep -a "AppSandbox"<key>com.apple.security.app-sandbox</key><true/>则说明配置生效。 - 第六步:重新上传
通过 Xcode Organizer 或 Application Loader 重新上传构建包即可。
注意:如果你后续需要更新 Xcode 版本,所有内嵌可执行组件的 Bundle ID 都需要保持已注册状态,不要随意修改,否则会再次触发同类校验报错。
内容的提问来源于stack exchange,提问作者Trygve
相关产品推荐
相关产品推荐

