#macOS 权限 ## 关键限制 * ❌ 不要假设已授予权限 → ✅ 在使用受保护的 API 之前始终进行检查 * ❌ 拒绝后不要重复提示 → ✅ 引导用户进入系统设置 * ❌ 不要因缺少权限而阻止整个应用程序 → ✅ 优雅地降级，提供减少的功能 * ❌ 不要忘记 PrivacyInfo.xcprivacy → ✅ App Store 提交所需 ## 权限类型许可 |检查API |需要用于 ---|---|--- 无障碍 | `AXIsProcessTrusted()` |全局热键、文本插入、CGEvent 屏幕录制 | `CGPreflightScreenCaptureAccess()` |屏幕截图、窗口列表全磁盘访问|尝试访问+处理错误 |读取其他应用数据相机 | `AVCaptureDevice.authorizationStatus（用于：.video）` |相机访问麦克风| `AVCaptureDevice.authorizationStatus（用于：.audio）` |音频捕捉地点 | `CLLocationManager().authorizationStatus` |定位服务联系方式 | `CNContactStore.authorizationStatus（对于：.contacts）` |联系方式 ## 辅助功能权限导入应用程序服务 // 不提示检查 func isAccessibilityGranted() -> Bool { AXIsProcessTrusted() } // 检查并提示用户（显示系统对话框） func requestAccessibilityPermission() -> Bool { 让选项 = [kAXTrustedCheckOptionPrompt.takeRetainedValue() as String: true] 返回 AXIsProcessTrustedWithOptions（选项作为 CFDictionary） } // 打开系统设置→隐私→辅助功能 func openAccessibilitySettings() { NSWorkspace.shared.open(URL(string: "x-apple.systempreferences:com.apple.preference.security?Privacy_Accessibility")!) } ## 屏幕录制权限导入核心图形 // 检查（macOS 15+） func isScreenRecordingGranted() -> Bool { CGPflightScreenCaptureAccess() } // 请求（macOS 15+） func requestScreenRecording() -> Bool { CGRequestScreenCaptureAccess() } // 打开设置 func openScreenRecordingSettings() { NSWorkspace.shared.open(URL(string: "x-apple.systempreferences:com.apple.preference.security?Privacy_ScreenCapture")!) } ## 相机/麦克风导入AVFoundation func checkCameraPermission() 异步 -> Bool { 切换 AVCaptureDevice.authorizationStatus(for: .video) { case .authorized: 返回 true case .notDetermined: 返回等待 AVCaptureDevice.requestAccess(for: .video) case .denied, .restricted: 返回 false @未知默认值：返回 false } } ## 优雅的降级模式结构功能可用性{ var canInsertText: Bool { AXIsProcessTrusted() } var canUseGlobalHotkey: Bool { AXIsProcessTrusted() } var canCaptureScreen: Bool { CGPreflightScreenCaptureAccess() } var degradedFeatures: [字符串] { var 特征：[String] = [] if !canInsertText { features.append("文本插入到其他应用程序中") } if !canUseGlobalHotkey { features.append("全局键盘快捷键") } 返回特征 } } 结构 PermissionBanner: 查看 { 让可用性：功能可用性 var body: 一些视图 { if !availability.degradedFeatures.isEmpty { VStack(对齐方式: .leading, 间距: 8) { Label("部分功能需要权限", systemImage: "lock.shield") .字体(.标题) ForEach(availability.degradedFeatures, id: \.self) { 特征 Text("• \(特征)") .字体(.标题) } Button("打开系统设置") { openAccessibilitySettings() } .buttonStyle(.borderedProminent) } .padding() .glassEffect(.regular.tint(.orange), in: .rect(cornerRadius: 12)) } } } ## 权限加入流程结构 OnboardingPermissionView: 查看 { @State private varaccessibilityGranted = AXIsProcessTrusted() 让计时器 = Timer.publish(every: 1, on: .main, in: .common).autoconnect() var body: 一些视图 { VStack（间距：20）{ 图像（系统名称：accessibilityGranted？“checkmark.circle.fill”：“lock.circle”） .font(.system(大小：48)) .foregroundStyle（accessibilityGranted？.green：.orange） Text(accessibilityGranted ? "已授予权限！" : "需要辅助功能权限") .字体(.标题2) 如果！accessibilityGranted { Text(“此应用程序需要辅助功能访问权限才能将文本插入其他应用程序并注册全局快捷方式。”) .multilineTextAlignment(.center) 按钮（“打开系统设置”）{ 请求可访问性权限() } .buttonStyle(.borderedProminent) } } .onReceive(定时器) { _ in AccessibilityGranted = AXIsProcessTrusted() } } } ## 隐私清单 (PrivacyInfo.xcprivacy) <字典> NSPrivacyTracking <假/> NSPrivacyTrackingDomains <数组/> NSPrivacyCollectedDataTypes <数组/> NSPrivacyAccessedAPITypes <数组> <字典> NSPrivacyAccessedAPIType NSPrivacyAccessedAPICategoryUserDefaults NSPrivacyAccessedAPITypeReasons <数组><字符串>CA92.1 ## 常见错误和修复错误|修复 ---|--- 拒绝后反复提示|先检查状态，如果拒绝则引导至设置应用程序未经许可崩溃 |在调用受保护的 API 之前始终进行检查用户找不到权限设置 |通过 URL 打开特定的系统设置窗格缺少隐私清单 |将 PrivacyInfo.xcprivacy 添加到应用程序包 ## 参考文献 * [辅助功能 API]() * [TCC 和隐私]()

Mac 权限

包含技能