通用权限请求API工具PermissionsKit

权限申请老被苹果拒？PermissionsKit 帮你把 16 种权限一次管明白

做 iOS 开发的朋友应该都经历过：App 要调个摄像头、要个定位权限，Info.plist 里配置写错一个键名，审核直接被拒；或者用户拒绝了一次权限，下次再弹窗就被系统静默拦截，用户一脸懵，你也查不出原因。PermissionsKit 就是来解决这堆破事的——它是一个开源工具库，把 iOS 上 16 种系统权限的申请和状态查询统一封装成一套 API，你只需要调用 Permission.camera.request 这样的方法，剩下的系统弹窗、状态回调、Info.plist 键名管理，它都帮你处理好了。

这个项目在 GitHub 上有 5807 个 star，MIT 协议随便用，最近一次更新是 2026 年 10 月，维护很活跃。下面我从开发者角度拆解一下它能干什么、怎么上手、有哪些坑。

适合谁

独立 iOS 开发者：一个人维护 App，最怕的就是苹果审核那关。PermissionsKit 把每个权限拆成独立模块，你用到哪个就引入哪个，审核时不会被问"为什么你的 App 要访问健康数据"这种尴尬问题。

中小型 iOS 开发团队：多个 App 共用一套权限逻辑，用这个库能统一代码规范，新同事接手也快。不用每个项目都重新写一遍权限申请那一坨样板代码。

做海外市场的开发者：App 要上架 App Store，权限描述文案得写英文，本地化还得配 InfoPlist.strings。PermissionsKit 提供了 xliff 导出方案，多语言权限文案管理省不少事。

能解决什么问题

审核被拒问题：苹果要求每个权限都必须有对应的 Info.plist 描述键，漏一个就拒。PermissionsKit 提供了 usageDescriptionKey 方法，代码里直接取键名，不会写错。比如蓝牙权限，它会返回 NSBluetoothAlwaysUsageDescription 这个标准键名。

权限状态判断混乱：系统权限状态有 .authorized、.denied、.notDetermined 三种，不同权限返回逻辑还不一样。比如 FaceID 权限，.authorized 和 .notDetermined 都返回 .notDetermined，只有 .denied 是可靠的——这个坑官方 README 里明确标了警告。用这个库，状态判断逻辑统一封装，你不需要记这些特例。

按需编译：PermissionsKit 每个权限都是独立 product，你只引入需要的。比如你的 App 只需要相机和相册权限，就只加 CameraPermission 和 PhotoLibraryPermission 两个模块，编译体积小，审核时也不会因为引入了没用到的权限而被追问。

怎么开始用

安装很简单，Xcode 里操作：

打开 Xcode → File → Add Package Dependencies → 粘贴仓库地址：

https://github.com/sparrowcode/PermissionsKit

然后选择你需要的 product 添加，比如只需要通知权限：

import PermissionsKit
import NotificationPermission

Permission.notification([.alert, .badge, .sound]).request {
    // 用户回答系统弹窗后回调
}

查询权限状态：

import PermissionsKit
import CameraPermission

let authorized = Permission.camera.authorized

获取 Info.plist 键名：

let key = Permission.bluetooth.usageDescriptionKey

注意：这里拿到的是键名，不是描述文案。描述文案要你自己在 Info.plist 里填，比如 NSCameraUsageDescription 对应的值是"用于拍摄商品照片"这样的说明文字。

本地化的话，手动方式是在 Xcode 里添加 InfoPlist.strings 文件，选择语言，然后写：

"NSCameraUsageDescription" = "Here description of usage camera";

优点和坑

优点：

• 模块化设计：16 种权限各自独立，按需引入，不用的权限完全不进编译产物。这对审核友好，也控制包体积。
• API 统一：申请、查状态、取键名，三种操作一套接口，学习成本低。从 README 看，代码风格很简洁，Permission.camera.authorized 一行搞定。
• 维护活跃：2017 年创建，到现在快 10 年了还在更新，star 5807 说明社区认可度不错，遇到问题有地方问。

坑：

• FaceID 状态判断有坑：官方 README 明确警告，FaceID 的 .authorized 和 .notDetermined 无法区分，都返回 .notDetermined。如果你的业务逻辑依赖"用户是否已授权 FaceID"这个判断，得自己额外处理，不能直接信返回值。
• Info.plist 键名必须用对：README 里强调，要用 usageDescriptionKey 返回的键名，不要自己手写字符串，否则 Xcode 编译不过。这个限制意味着你不能在代码里动态拼接键名，得走它提供的接口。
• 本地化配置略繁琐：多语言权限文案要手动建 InfoPlist.strings 文件、选语言、逐条写键值对。README 建议用 xliff 导出自动生成，但如果你不熟悉 xliff 流程，手动配置容易漏语言。
• 只支持 Swift Package Manager：安装方式是 Xcode 的 Add Package Dependencies，也就是 SPM。如果你项目还在用 CocoaPods 或 Carthage，得先迁移包管理方式才能用。

适合你吗

适合：用 Swift 开发 iOS App、项目通过 SPM 管理依赖、需要处理 2 种以上系统权限的开发者。尤其是被苹果审核问过权限问题的，这个库能帮你把 Info.plist 键名这块的坑填平。

不适合：项目还在用 Objective-C 的（这个库是 Swift 写的）；或者你的 App 只需要一种权限、代码量很小，那自己写十几行也够用，没必要引一个库。另外，如果你对 FaceID 权限状态有强依赖，需要评估一下它"无法区分 authorized 和 notDetermined"这个限制能不能接受。

---

常见问题

PermissionsKit 这个 API 工具是干什么用的？

PermissionsKit 是一个专门为 iOS 开发设计的开源 API 工具库。它把 iOS 系统上 16 种不同的权限（如相机、定位、通知等）的申请、状态查询和配置管理，统一封装成一套简单易用的 API（例如 Permission.camera.request），帮你省去处理 Info.plist 键名和系统弹窗回调的麻烦，旨在减少因权限问题导致的 App Store 审核被拒。

PermissionsKit 这个 API 开放平台是免费的吗？

是的，PermissionsKit 完全免费且开源。它在 GitHub 上采用 MIT 开源协议发布，这意味着你可以随意在个人或商业项目中使用、修改和分发它，无需支付任何费用。该项目拥有超过 5800 个 star，维护活跃，最近更新至 2026 年 10 月。

PermissionsKit 里的 API 密钥是什么意思，需要申请吗？

在 PermissionsKit 的上下文中，并不涉及传统意义上的“API 密钥”。这里的“API”指的是该库提供的一系列编程接口（方法），用于请求系统权限。你不需要申请任何外部密钥，只需在 Xcode 中通过 Swift Package Manager 安装库，并根据需要导入特定权限模块（如 import CameraPermission）即可开始调用。

PermissionsKit 怎么安装？

安装 PermissionsKit 非常简单，仅支持 Swift Package Manager 方式。在 Xcode 中操作：打开项目，点击 File → Add Package Dependencies，然后粘贴其 GitHub 仓库地址（https://github.com/sparrowcode/PermissionsKit），选择你需要的具体权限模块（Product）添加到项目中即可完成安装。

和手动处理权限相比，用 PermissionsKit 有什么优势？

相比手动处理，PermissionsKit 主要有三大优势：1. 统一 API 简化操作，申请、查询状态一行代码搞定；2. 自动管理 16 种权限对应的正确 Info.plist 键名，极大降低因配置错误导致审核被拒的风险；3. 模块化设计，可按需引入，避免无用权限增加编译体积和审核询问。

相关工具推荐

• 为 Django 项目配置内容后台的 Wagtail 开源 CMS
• Adobe 设计的等宽编程字体 Source Code Pro
• GitHub Next 团队开源的 Monaspace 可混搭编程字体