Swift macOS开发：Accessibility API获取选中文本遇AXError: cannotComplete

1. 核对权限配置细节 #

• 确认Info.plist中已添加NSAccessibilityUsageDescription键，且填写了明确的权限用途说明。系统依赖该描述向用户发起权限申请，缺失或描述模糊可能导致权限实际未生效。
• 检查App Sandbox设置：在Xcode的Signing & Capabilities面板中，确保App Sandbox下的Accessibility选项已勾选，避免沙箱过度限制辅助功能访问。

2. 修复AXIsProcessTrustedWithOptions返回false的问题 #

• 即使系统设置显示已授权，权限数据库可能存在缓存异常：打开系统偏好设置→安全性与隐私→隐私→辅助功能，先取消应用的勾选，重启应用后重新勾选授权。
• 调试场景下，需确保Xcode进程也被加入辅助权限列表。系统可能将Xcode调试进程与你的应用进程视为独立实体，未授权Xcode会导致调试时权限校验失败。
• 用AXIsProcessTrusted()做快速测试，排除AXIsProcessTrustedWithOptions参数配置错误的可能：

  BOOL isTrusted = AXIsProcessTrusted();
  NSLog(@"Accessibility trusted: %d", isTrusted);
  

3. 排查AXError: cannotComplete的其他诱因 #

• 验证目标应用元素是否支持kAXSelectedTextAttribute：使用Xcode自带的Accessibility Inspector（路径：Xcode→Open Developer Tool→Accessibility Inspector）查看目标应用的元素结构，确认选中文本对应的元素是否包含Selected Text属性。部分非原生Mac应用（如Electron应用）的辅助元素实现可能不完整。
• 确保AXUIElement获取逻辑正确：先获取前台活跃应用的元素实例，再尝试读取选中文本，示例代码：

  // 获取前台应用PID
  pid_t frontAppPID;
  OSStatus status = AXUIElementCopyAttributeValue(AXUIElementCreateSystemWide(), kAXFrontmostApplicationAttribute, (CFTypeRef *)&frontAppPID);
  if (status != kAXErrorSuccess) {
      return nil;
  }
  
  AXUIElementRef frontApp = AXUIElementCreateApplication(frontAppPID);
  CFTypeRef selectedText;
  status = AXUIElementCopyAttributeValue(frontApp, kAXSelectedTextAttribute, &selectedText);
  if (status == kAXErrorSuccess) {
      NSString *text = (__bridge NSString *)selectedText;
      // 处理文本逻辑
      CFRelease(selectedText);
  } else {
      NSLog(@"AXError code: %d", status);
  }
  CFRelease(frontApp);
  

• 部分系统隐私类应用（如密码管理器）会主动限制辅助访问，即使授权也无法获取其选中文本，这是应用自身的安全限制。

4. 沙箱权限的额外检查 #

• 若开启App Sandbox，需确认Entitlements文件中已添加com.apple.security.accessibility权限并设为true。通过Xcode Capabilities面板添加Accessibility权限时会自动生成该配置，手动配置时易遗漏。

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