Skip to content

A unified API to ask for permissions on iOS

License

Notifications You must be signed in to change notification settings

WebISInc/PAPermissions

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

55 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

#PAPermissions

PAPermissions is a fully customizable and ready-to-run library to handle permissions through a ViewController

Right now it supports out of the box permissions for:

  • Address Book
  • Bluetooth
  • Calendar
  • Camera
  • Contacts
  • Events
  • Location
  • Microphone
  • Motion Fitness
  • Notifications
  • Reminders
  • Custom

Compatibility

PAPermissions requires iOS8+, compatible with both Swift 4 and Objective-C based projects

If you are looking for the Swift 2 version of it, please check out the legacy branch If you are looking for the Swift 3 version of it, please check out the legacy branch

Installation

CocoaPods

CocoaPods is a dependency manager for Cocoa projects.

To integrate PAPermissions into your Xcode project using CocoaPods, specify it in your Podfile:

pod 'PAPermissions'

Then, run the following command:

$ pod install

Manual Installation

Just copy the PAPermissions folder in your project

Run the Example

Clone the repo, cd into Example:

$ pod install

Or open the project (the blue icon) and copy the PAPermissions folder inside.

Screenshots

It can be used with a plain background color

Or with a background image

How it works

Create a new UIViewController, inherit from PAPermissionsViewController and write:

	let microphoneCheck = PAMicrophonePermissionsCheck()
	let cameraCheck = PACameraPermissionsCheck()

	override func viewDidLoad() {
		super.viewDidLoad()

		//Custom settings
		self.locationCheck.requestAlwaysAuthorization = true


		let permissions = [
	          PAPermissionsItem.itemForType(.microphone, reason: "Required to hear your beautiful voice")!,
					  PAPermissionsItem.itemForType(.camera, reason: "Required to shoot awesome photos")!]

		let handlers = [
						PAPermissionsType.microphone.rawValue: self.microphoneCheck,
						PAPermissionsType.camera.rawValue: self.cameraCheck]
		self.setupData(permissions, handlers: handlers)

		self.titleText = "My Awesome App"
		self.detailsText = "Please enable the following"
	}

That's it!

Anyway you no need to import everything, just remove the unnecessary "check" classes and keep the ones you want to use, you will find them in "Checks" folder.

Contacts

We would love to know if you are using PAPermissions in your app, send an email to [email protected]

About

A unified API to ask for permissions on iOS

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Swift 96.9%
  • Ruby 2.1%
  • Objective-C 1.0%