You need to enable JavaScript to run this app. Xcode 12上传Mac应用报登录项helper沙箱未启用的ITMS-90296错误
优惠活动
大模型
产品
解决方案
定价
更多

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 的签名授权是否生效:
    codesign -d --entitlements - "/Path/To/Build/Products/MyApp.app/Contents/Library/LoginItems/MyApp Launcher.app"
    
    确认输出的 entitlements 列表中包含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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.03 12:45:07