macOS应用及Helper未显示在登录项允许后台列表的问题

基础信息 #

• 应用支持前台（NSApplicationActivationPolicyRegular）/后台（NSApplicationActivationPolicyAccessory）双模式，依赖Helper登录项实现后台自启
• 环境：Xcode 15.3（15E204a）、macOS 14.2.1，设备为2019款16英寸MacBook Pro（2.3GHz Intel Core i9 8核）
• Helper配置：Info.plist已设置<key>LSBackgroundOnly</key><true/>和<key>LSUIElement</key><true/>

异常现象 #

1. 应用归档公证后放入/Applications，删除DerivedData中Debug版本确保仅一份存在
2. 首次前台启动应用，点击“设置为登录项”菜单时，执行代码：

   SMAppService *service = [SMAppService loginItemServiceWithIdentifier:@"com.mydomain.Helper"];
   

   返回service.status == SMAppServiceStatusNotFound，应用未出现在「系统设置>登录项>允许后台」列表

临时修复方式 #

执行sudo sfltool resetbtm后重启，「允许后台」列表重置，应用出现在列表中且处于开启状态；此时调用SMAppService返回SMAppServiceStatusEnabled，可正常切换后台模式，注销后Helper能正常启动应用。但该方法无法用于用户分发，删除应用再放回/Applications后问题复现。3台同版本macOS设备测试结果一致。

疑问 #

1. 遗漏了哪些必要配置？
2. 为何应用放入/Applications后无法自动出现在允许后台列表？

解答 #

可能遗漏的配置 #

• 签名与标识符一致性：Helper必须和主应用使用同一开发者ID证书签名，且Helper的CFBundleIdentifier必须与代码中调用的com.mydomain.Helper完全匹配（大小写、域名后缀都不能错）。
• 应用组与沙箱权限：如果主应用开启App Sandbox，需在主应用和Helper的Entitlements.plist中添加相同的com.apple.security.application-groups权限；同时主应用需开启对应文件权限，确保能正确读取嵌入的Helper。
• 主应用的登录项声明：主应用的Info.plist中需通过SMLoginItemEnabled键声明Helper的标识符，示例：

  <key>SMLoginItemEnabled</key>
  <dict>
      <key>com.mydomain.Helper</key>
      <true/>
  </dict>
  

• Helper的嵌入路径：Helper必须放在主应用的Contents/Library/LoginItems目录下，确保SMAppService能正确定位到Helper的路径（可通过[service url]验证路径是否正确）。

无法自动出现在后台列表的原因 #

• Launch Services缓存未更新：macOS的Launch Services会缓存应用信息，删除应用再放回后，缓存未同步，导致系统无法识别Helper的登录项配置。sfltool resetbtm是强制重置后台管理数据库，让系统重新扫描应用配置。
• 未触发合法的注册流程：macOS要求登录项必须由用户主动触发注册（比如通过主应用UI操作调用[service enableWithError:]），仅复制应用到/Applications不会自动触发注册。首次调用SMAppService返回NotFound，说明系统未检测到Helper的合法配置，无法完成注册流程。
• 公证后的权限同步延迟：公证后的应用需要系统完成权限同步，首次启动时若未正确触发Helper的注册逻辑，系统不会将其加入后台列表。需确保主应用在调用SMAppService前，先验证Helper的存在性与路径正确性。

内容的提问来源于stack exchange，提问作者Leonardo