沙盒环境下Mac应用无障碍权限提示不显示问题排查

核心结论 #

Catalina（10.15）系统下，沙盒化的Mac应用完全支持无障碍权限，你的问题大概率是配置缺失、代码调用时机错误或签名不规范导致的。

1. 必加的沙盒权限配置 #

在项目的Entitlements.plist中添加以下键值对，这是沙盒应用触发无障碍权限请求的前提：

<key>com.apple.security.accessibility</key>
<true/>

如果没有这个配置，系统会直接忽略应用的权限请求，不会在「隐私与安全」列表中显示你的应用。

2. 修正权限请求代码的调用逻辑 #

• 调用时机：必须在应用主线程、且应用完成初始化后调用（比如在applicationDidFinishLaunching:方法中，而非更早的启动阶段），沙盒环境下过早调用会导致权限提示不触发。
• 参数正确性：确保AXIsProcessTrustedWithOptions的参数包含强制提示开关：

  NSDictionary *accessibilityOptions = @{(id)AXTrustedCheckOptionPrompt: @YES};
  BOOL isAccessibilityTrusted = AXIsProcessTrustedWithOptions((CFDictionaryRef)accessibilityOptions);
  

  只有传入AXTrustedCheckOptionPrompt为YES，系统才会弹出权限申请窗口。

3. 验证签名与Entitlements嵌入情况 #

使用终端命令检查应用的签名是否正确包含了无障碍权限配置：

codesign -d --entitlements - /Applications/YourApp.app

输出结果中必须包含com.apple.security.accessibility = true，否则说明签名时未正确嵌入Entitlements文件，需调整Xcode的签名设置：

• 确保项目「Build Settings」中「Code Signing Entitlements」指向正确的Entitlements文件；
• Debug/Release模式下的签名配置均需勾选「Enable Entitlements」。

4. setup_hotkey函数的排查要点 #

• 必须在AXIsProcessTrustedWithOptions返回YES后，再执行CGEventTapCreate、CFMachPortCreateRunLoopSource等快捷键配置代码，沙盒下无权限时调用这些API会直接失败，且不会触发权限提示；
• 确认CGEventTapCreate的参数符合沙盒要求：使用kCGEventTapOptionDefault，事件掩码仅包含你需要监听的快捷键事件，避免过度权限请求；
• 确保事件源被添加到主线程的RunLoop中，否则无法正常接收快捷键事件：

  CFRunLoopAddSource(CFRunLoopGetMain(), runLoopSource, kCFRunLoopCommonModes);
  

5. 系统层面的重置方案 #

如果上述配置都正确但仍无效果，可重置系统隐私权限数据库：

tccutil reset Accessibility

执行后重启应用，重新触发权限请求即可。

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