About

Modularize work has proven successful a long time ago. This project is about managing permissions with the customizable visual effects. Beautiful dialog increases the chance of approval (which is important when we request notification). Simple control of this module saves you hours of development. You can start using this project with just two lines of code!

Requirements

Xcode 8 and Swift 3. Ready for use on iOS 8+

Integration

Drop in Sparrow folder to your Xcode project (make sure to enable “Copy items if needed” and “Create groups”).

Or via CocoaPods:

Pod 'Sparrow/Modules/RequestPermission' : git = > 'https://github.com/IvanVorobei/Sparrow.git'Copy the code

How to use

Initialize Assistant as a property in controller. Initialization in any other unit may be unsafe (read more about)

class ViewController: UIViewController {

    var permissionAssistant = SPRequestPermissionAssistant.modules.dialog.interactive.create(with: [.Camera, .PhotoLibrary, .Notification])

    override func viewDidLoad() {
        super.viewDidLoad()
    }
}Copy the code

Now when the module is initialized and configured with the desired permissions, we can generate a visual representation. This is done in one line of code

permissionAssistant.present(on: self)Copy the code

If you want to know if you have received permission, you should call the function:

let isAvailableCamera = permissionAssistant.isAllowPermission(.Camera)Copy the code

Available permissions

Types of presentation

Did you notice that when initialized the Assistant – we chose the module (SPRequestPermissionAssistant.modules.dialog.interactive…) . You can choose an appropriate visual component. They all adapted to the iPad and iPhone for all screens and for all orientations (currently available dialog/interactive and native, but soon I will add number of presentations)

Important

For correct ARC work you need to save an object of class Assistant during the lifetime of parent’s controller. As controller’s property. Otherwise, ARC will destroy files that is responsible for logic and the controller will not respond to events

Delegates

To track events associated with Assistant and its view, implement the protocol SPRequestPermissionEventsDelegate and set the class as delegate

permissionAssistant.eventsDelegate = selfCopy the code

Customize

If you want to change data in a particular module (for example, the text in the top footer) – you should implement a class supporting the protocol. For example, for module dialog/interactive, you should implement the protocol SPRequestPermissionDialogInteractiveDataSourceInterface. Then the class object needs to be passed to the assistant, in this line

let permissionAssistant = SPRequestPermissionAssistant.modules.dialog.interactive.init(with: [.Camera, .PhotoLibrary], dataSourceForController: customDataSource())Copy the code

If you want to write your assistant, using the current skeleton, you should use a more extended initializer. Accordingly PresenterManager and PermissionManager must implement the interfaces

let permissionAssistant = SPRequestPermissionAssistant.init(with: [.Camera, .PhotoLibrary], permissionManager: customPermissionManager(), presenterManager: customPresenterManager())Copy the code

Apps, using Request-Permission

I like the idea to specify applications that use the RequestPermission. Please, contact me via email (you can find it in the section “Contacts”) so that I added app here

License

RequestPermission is released under the MIT license. Check LICENSE.md for details

Other

In the project you can find my library Sparrow. It’s a library, on which the module is written. Unfortunately, to save time in development, I wrote RequestPermission using this library. Don’t worry, within just Swift files and a lot of useful things. Maybe you will like it:)

Contact

hello.ivanvorobei.by

ivanvorobei.by

[email protected]

Support

The project is fully free, I do not impose any restrictions on its use. I’m, just like you, want to do useful things. If you have a desire to help, tell friends about the project or donate. Thanks!