PermissionsService 0.9.5

PermissionsService 0.9.5

TestsTested
LangLanguage SwiftSwift
License BSD
ReleasedLast Release Oct 2017
SwiftSwift Version 4.0
SPMSupports SPM

Maintained by Yuriy Trach, Max Vitruk, Sergiy Loza, OverSwift, Hellen Soloviy.


Downloads

Total2,145
Week182
Month764

Installs

Apps30
Apps WeekApps This Week 6
Pod Tries1
powered by Segment

GitHub

Stars12
Watchers13
Forks5
Issues0
Contributors5
Pull Requests0

Code

Files16
LOCLines of Code 465







An easy way to do permissions requests & handling automatically.

  1. Why do you need it?
  2. Features
  3. Supported Permission Types
  4. Installation
    1. CocoaPods
    2. Carthage
  5. How To Use
  6. Configurations
    1. Custom alert messages
    2. Location permission
  7. Requirements
  8. Author
  9. License

Why do you need it?

This library is an easy way to handle notDetermined, authorised, restricted and denied cases without doing it by yourself. No more need to do error handling for restricted and denied cases, create and present to user specific alerts.
Of cause, it is not a silver bullet, but a good tool for your project!

Features

  • Customise or localise alerts messages via Configuration
  • Automatic alert creating and presenting
  • Opportunity for users to easily change permissions in Settings
  • CoreLocation permission returns you completion block with user's decision
  • Example project for easy understanding of framework

Supported Permission Types

  • Camera
  • Contacts
  • Events
  • Gallery
  • Location
  • MediaLibrary
  • Microphone
  • Reminder
  • Siri
  • SpeechRecognition

Note!

There is an important note about installing, because of Apple's policy. Due to this policy regarding permission access, binaries may be rejected due to a perceived attempt to access privacy-sensitive data without a usage key, and then further rejected for not actually requesting permissions. This error will be when you'll try uploading to itunesconnect.

But there is a solutuion. You need to provide custom build flags before building the dynamic framework to only compile with permissions you request.

  1. Go to your project root directory and add xcconfig file named PermissionConfiguration.xcconfig.
    Example of such file you can find here.

  2. Comment lines which you don't want to use like this:

    
    PERMISSION_CAMERA            = PERMISSION_CAMERA
    PERMISSION_CONTACTS          = // PERMISSION_CONTACTS
    

Here you can see an example of using only Camera permission. Contacts permission will be unavailable.

  1. Now you can run carthage update --platform iOS to compile framework.

If you'll need to change available permissions, go to PermissionConfiguration.xcconfig file and modify it. Then update the framework again.

How To Use

  1. Configure your project in all ways needed for chosen permission type. For example, in a case of a gallery, add a specific key to your .plist file.

  2. Implement Permissible protocol in your class. If it's not a UIVIewController class you should implement showAlert(_:) method, but if it is - there is a default implementation and you can leave it empty.

  3. Add Permission<T: PermissionService> object with a type you needed and use prepare(_:) method for request permission and presenting alert to the user.

  Permission<Gallery>.prepare(for: self, callback: { (granted) in
      if granted {
          //present library
      } else {
          //perform specific functions 
      }
    })

This case if show a simple variant of use with default permission settings.

Be aware that Calendar permission service named Events.

  1. Enjoy!

Configurations

This library gives you an opportunity to do some customising or configurations if you need it.

Configurate messages

You can add custom alerts messages for denied and restricted cases by creating new struct which conform to ServiceMessages protocol.

struct CameraMessages: ServiceMessages {
    
    let deniedTitle = "Access denied"
    let deniedMessage = "You can enable access to camera in Privacy Settings"
    let restrictedTitle = "Access restricted"
    let restrictedMessage = "Access to camera is restricted"
    
}

To use your custom messages you need to use DefaultConfiguration class. Let's init it!

   let config = DefaultConfiguration(with: CameraMessages())

And now put it in prepare(_:) method, like this:

  Permission<Camera>.prepare(for: self, with: config) { (granted) in
     if granted {
         print("Granted")
     } else {
         print("Error")
     }

 }

Location permission types

As you can know, you can request two types of user location permission: WhenInUse and Always.
For choosing it you need to use configurations too. Class LocationConfiguration is a subclass of DefaultConfiguration and have the same way to use.

You can init it only with type

      let config = LocationConfiguration(.always)

Or you can use it with your messages

     let config = LocationConfiguration(.always, with: CustomLocationMessages())

And then simply put it in your prepare(_:) method as you already did with DefaultConfiguration.

  Permission<Location>.prepare(for: self, with: config) { (granted) in
     if granted {
         print("Granted")
     } else {
         print("Error")
     }

 }

Requirements

Author

Lemberg Solutions

iOS Platform

License

ios-permissions-service is available under the BSD license. See the LICENSE file for more info.