sparrowcode /PermissionsKit

Universal API for request permission and get its statuses.

★ 5,813⑂ 479👁 90⑃ 98● 257▤ 140
SwiftMITCreated 2017-02-16x.com/sparrowcode_ios
下载:12.0.012.0.0 ↓12.0.02026-09-12
+0
日增长
5,813
stars
479
forks
90
watchers
98
prs
257
issues
140
releases

README

PermissionsKit

Universal API for requesting permissions and reading their status — .authorized, .denied & .notDetermined. Each permission ships as a separate product, so the app compiles only the ones it actually uses.

 Installation

In Xcode: File → Add Package Dependencies → paste URL:


https://github.com/sparrowcode/PermissionsKit


Then pick the products you need. Add only those — every permission API you link is visible to App Review, and unused ones invite questions about why the app needs them.

 Permissions

| Permission | Product | Key for Info.plist |
| :--------- | :------ | :------------------- |
| Bluetooth | BluetoothPermission | NSBluetoothAlwaysUsageDescription, NSBluetoothPeripheralUsageDescription |
| Calendar | CalendarPermission | NSCalendarsUsageDescription, NSCalendarsFullAccessUsageDescription, NSCalendarsWriteOnlyAccessUsageDescription |
| Camera | CameraPermission | NSCameraUsageDescription |
| Contacts | ContactsPermission | NSContactsUsageDescription |
| FaceID | FaceIDPermission | NSFaceIDUsageDescription |
| Health | HealthPermission | NSHealthUpdateUsageDescription, NSHealthShareUsageDescription |
| Location | LocationPermission | NSLocationAlwaysAndWhenInUseUsageDescription, NSLocationWhenInUseUsageDescription |
| Media Library | MediaLibraryPermission | NSAppleMusicUsageDescription |
| Microphone | MicrophonePermission | NSMicrophoneUsageDescription |
| Motion | MotionPermission | NSMotionUsageDescription |
| Notification | NotificationPermission | — |
| Photo Library | PhotoLibraryPermission | NSPhotoLibraryUsageDescription, NSPhotoLibraryAddUsageDescription |
| Reminders | RemindersPermission | NSRemindersUsageDescription, NSRemindersFullAccessUsageDescription |
| Siri | SiriPermission | NSSiriUsageDescription |
| Speech Recognizer | SpeechRecognizerPermission | NSSpeechRecognitionUsageDescription |
| Tracking | TrackingPermission | NSUserTrackingUsageDescription |

 Usage

Request a permission:

swift
import PermissionsKit
import NotificationPermission

Permission.notification([.alert, .badge, .sound]).request {
    // Called once the user answers the system dialog.
}


Read its status:

swift
import PermissionsKit
import CameraPermission

let authorized = Permission.camera.authorized


 [!WARNING]
 FaceID can't tell .authorized from .notDetermined — both come back as .notDetermined. Only .denied is reliable.

 Keys in Info.plist

Apple requires a usage description for most permissions. Get the key for a permission:

swift
let key = Permission.bluetooth.usageDescriptionKey


 [!NOTE]
 Use the key itself, not the description text — Xcode won't build otherwise.

 Localisation

An xliff export creates the keys for you. Doing it by hand means adding an InfoPlist.strings file, selecting the languages in the inspector, and writing the keys there:


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

Top issues

Latest release

12.0.0 12.0.0 2026-09-12
Maintenance release after a long pause. Mostly a cleanup, but it changes what the package requires and how it is installed, hence the major bump.

 Breaking

- Deployment targets are now iOS 15, tvOS 15, watchOS 9 and macOS 13. Xcode 26 no longer builds for anything older.
- The package builds in Swift 6 language mode. Completion closures are @MainActor — a permission dialog is UI work, and calling request { } from a view controller keeps working unchanged.
- CocoaPods support is gone. The podspec, the subspecs and the PERMISSIONSKIT_ build flags went with it; Swift Package Manager is the only

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON