ivanvorobei/SPPermissions
SPPermissions
SPPermissions is a Swift library that centralizes permission status checks and request flows across iOS and macOS system services. It provides a unified API for checking the current authorization state of any system permission and requesting access through the appropriate system dialog, all through a single interface.
The library uses typed enums to map each system permission to a distinct case, allowing developers to check status and request authorization with a single method call and closure-based callback. It automatically derives the required Info.plist usage-description keys from the permission enum cases, eliminating manual string management, and supports localized permission prompt strings through InfoPlist.strings lookup for multi-language deployments.
SPPermissions covers the full lifecycle of permission management, including status checking, request handling, Info.plist configuration, and localization for both iOS and macOS platforms. The library includes utilities for configuring required usage-description strings and retrieving the exact Info.plist key for any permission.
Features
- iOS Permission Request APIs - Provides a unified API that checks and requests system permissions for all iOS capabilities.
- Permission Enum Abstractions - Maps each system permission to a typed enum case for unified status checks and requests.
- Swift Permission Managers - Centralizes permission status checks and request flows across iOS system services in Swift.
- iOS Authorization Status Checkers - Returns the current authorization state for any iOS system permission as authorized, denied, or undetermined.
- System Permission Status Checks - Checks the current authorization state of any system permission with a simple method call.
- Permission Request Workflows - Provides a unified API for requesting any iOS or macOS system permission through a single method call.
- Authorization Status Queries - Ships a status-checking API that returns the current authorization state for any system permission.
- iOS Permission Lifecycles - Manages the full lifecycle of iOS system permissions from request through status monitoring.
- macOS Permission Lifecycles - Manages the full lifecycle of macOS system permissions from request through status monitoring.
- Permission - Exposes a unified request function that dispatches to the correct system dialog per permission type.
- String Localization - Resolves permission prompt text from InfoPlist.strings using the app's current locale.
- Permission Configurators - Adds required usage-description strings to Info.plist so system permission prompts can be shown.
- Info.plist Key Derivations - Derives required Info.plist usage-description keys from permission enum cases at runtime.
- Alerts and Modals - Interface for requesting and checking system permissions.
- User Permissions - Swift-based permission management with multiple UI styles.
