Home

Awesome

PermissionsKit

Universal API for request permission and get its statuses — available .authorized, .denied & .notDetermined.

<p float="left"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/camera.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/photos.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/notifications.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/location.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/microphone.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/calendar.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/contacts.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/reminders.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/motion.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/music.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/speech.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/bluetooth.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/health.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/tracking.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/faceid.png" width="38"> <img src="https://cdn.sparrowcode.io/github/permissionskit/icons/siri.png" width="38"> </p>

iOS Dev Community

<p float="left"> <a href="https://twitter.com/i/communities/1730194338489987403"> <img src="https://cdn.sparrowcode.io/github/badges/x-community.png?version=1" height="52"> </a> <a href="#apps-using"> <img src="https://cdn.sparrowcode.io/github/badges/download-on-the-appstore.png?version=4" height="52"> </a> </p>

Navigate

Permissions

IconPermissionKey for Info.plistGet StatusMake Request
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/bluetooth.png" width="38">BluetoothNSBluetoothAlwaysUsageDescription, NSBluetoothPeripheralUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/calendar.png" width="38">CalendarNSCalendarsUsageDescription, NSCalendarsFullAccessUsageDescription, NSCalendarsWriteOnlyAccessUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/camera.png" width="38">CameraNSCameraUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/contacts.png" width="38">ContactsNSContactsUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/faceid.png" width="38">FaceIDNSFaceIDUsageDescription☑️
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/health.png" width="38">HealthNSHealthUpdateUsageDescription, NSHealthShareUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/location.png" width="38">LocationNSLocationAlwaysAndWhenInUseUsageDescription NSLocationWhenInUseUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/music.png" width="38">Media LibraryNSAppleMusicUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/microphone.png" width="38">MicrophoneNSMicrophoneUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/motion.png" width="38">MotionNSMotionUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/notifications.png" width="38">Notification
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/photos.png" width="38">Photo LibraryNSPhotoLibraryUsageDescription, NSPhotoLibraryAddUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/reminders.png" width="38">RemindersNSRemindersUsageDescription, NSRemindersFullAccessUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/siri.png" width="38">SiriNSSiriUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/speech.png" width="38">Speech RecognizerNSSpeechRecognitionUsageDescription
<img src="https://cdn.sparrowcode.io/github/permissionskit/icons/tracking.png" width="38">TrackingNSUserTrackingUsageDescription

Installation

Ready to use on iOS 12+. Supports iOS, macOS, visionOS, tvOS & watchOS. Working with UIKit and SwiftUI.

Swift Package Manager

In Xcode go to Project -> Your Project Name -> Package Dependencies -> Tap Plus. Insert url:

https://github.com/sparrowcode/PermissionsKit

Next, choose the permissions that you need. But don't add all of them, because apple will reject app. Or adding it to the dependencies of your Package.swift:

dependencies: [
    .package(url: "https://github.com/sparrowcode/PermissionsKit", .upToNextMajor(from: "11.0.0"))
]

and choose valid targets.

CocoaPods:

This is an outdated way. I advise you to use SPM. However, I will continue to support Cocoapods for some time.

<details><summary>Cocoapods Installation</summary>

CocoaPods is a dependency manager. For usage and installation instructions, visit their website. To integrate using CocoaPods, specify it in your Podfile:

pod 'PermissionsKit/NotificationPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'

Due to Apple's new policy regarding permission access you need to specifically define what kind of permissions you want to access using subspecs.

pod 'PermissionsKit/CameraPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/ContactsPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/CalendarPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/PhotoLibraryPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/NotificationPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/MicrophonePermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/RemindersPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/SpeechRecognizerPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/LocationPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/MotionPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/MediaLibraryPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/BluetoothPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/TrackingPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/FaceIDPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/SiriPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
pod 'PermissionsKit/HealthPermission', :git => 'https://github.com/sparrowcode/PermissionsKit'
</details>

Why Modules

If you put all your code into one package and compile it, the Apple Review Team will see a lot of calls to the permissions API. Most likely, they will ask you to provide a valid reason for why you really need those permissions. Using modules allows you to compile only the parts of the code that are actually in use. Just select only what you need.

[!WARNING] Import only the permissions you really need.

Request Permission

import PermissionsKit
import NotificationPermission

Permission.notification.request {
    
}

Get Status Permission

import PermissionsKit
import NotificationPermission

let authorized = Permission.notification.authorized

[!WARNING] For FaceID permission no way detect if request .authorized or .notDetermined accurate. Status .denied detect well. For now for both states return .notDetermined.

Keys in Info.plist

You need to add some strings to the Info.plist file with descriptions per Apple's requirements. You can get a plist of keys for permissions as follows:

let key = Permission.bluetooth.usageDescriptionKey

[!NOTE] Do not use the description as the name of the key. Xcode can't build this.

Localisation

If you use xliff localization export, keys will be create automatically. If you prefer do the localization file manually, you need to create InfoPlist.strings, select languages on the right side menu and add keys as keys in plist-file. See:

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

Apps Using

<p float="left"> <a href="https://apps.apple.com/app/id1487937127"><img src="https://cdn.sparrowcode.io/github/apps-using/id1487937127.png?version=2" height="65"></a> <a href="https://apps.apple.com/app/id1624477055"><img src="https://cdn.sparrowcode.io/github/apps-using/id1624477055.png?version=2" height="65"></a> <a href="https://apps.apple.com/app/id1625641322"><img src="https://cdn.sparrowcode.io/github/apps-using/id1625641322.png?version=2" height="65"></a> <a href="https://apps.apple.com/app/id1625641322"><img src="https://cdn.sparrowcode.io/github/apps-using/id6449774982.png?version=2" height="65"></a> <a href="https://apps.apple.com/app/id875280793"><img src="https://cdn.sparrowcode.io/github/apps-using/id875280793.png?version=2" height="65"></a> <a href="https://apps.apple.com/app/id743843090"><img src="https://cdn.sparrowcode.io/github/apps-using/id743843090.png?version=2" height="65"></a> <a href="https://apps.apple.com/app/id537070378"><img src="https://cdn.sparrowcode.io/github/apps-using/id537070378.png?version=2" height="65"></a> <a href="https://apps.apple.com/app/id1617055933"><img src="https://cdn.sparrowcode.io/github/apps-using/id1617055933.png?version=2" height="65"></a> <a href="https://apps.apple.com/app/id1596657751"><img src="https://cdn.sparrowcode.io/github/apps-using/id1596657751.png?version=2" height="65"></a> <a href="https://apps.apple.com/app/id1459483980"><img src="https://cdn.sparrowcode.io/github/apps-using/id1459483980.png?version=2" height="65"></a> <a href="https://apps.apple.com/app/id1544749600"><img src="https://cdn.sparrowcode.io/github/apps-using/id1544749600.png" height="65"></a> <a href="https://apps.apple.com/app/id6452079114"><img src="https://cdn.sparrowcode.io/github/apps-using/id6452079114.png" height="65"></a> </p>

If you use a PermissionsKit, add your app via Pull Request.