AREK is a clean and easy to use wrapper over any kind of iOS permission written in Swift.

Why AREK could help you building a better app is well described by Apple <a href="https://developer.apple.com/ios/human-interface-guidelines/interaction/requesting-permission/">here</a>:

Request personal data only when your app clearly needs it.
...
Explain why your app needs the information if it’s not obvious.
...
Request permission at launch only when necessary for your app to function.
...

Every goal could be easily reached using AREK.

show a native popup used to avoid burning the possibility to ask to iOS the real permission
show a popup to invite the user to re-enable the permission if it has been denied
manage through an easy configuration how many times to ask the user to re-enable the permission (Only once, every hour, once a day, weekly, always😷)

🚨 AREK is a Swift 4.2 and Xcode 10 compatible project 🚨

Important!

If you want to use it with Xcode 10, swift 4.2, point to the version 4.0.1
If you want to use it with Xcode 9, point to any prior version

Build Status

| Branch | Status | | ------------- | ------------- | | Master | | | Develop | |

Implemented permissions
How to use AREK
Permissions Configuration
How to install AREK
How to contribute
TODO
License and Credits

Implemented permissions

[x] Camera
[x] Bluetooth
[x] CloudKit
[x] Contacts
[x] Events (Calendar)
[x] Health
[x] Location (Always)
[x] Location (When in use)
[x] Media Library
[x] Microphone
[x] Motion
[x] Notifications
[x] Photo
[x] Reminders
[x] Siri
[x] Speech Recognizer

How to use AREK

Check permission status

    let permission = ArekPhoto()

    permission.status { (status) in
        switch status {
        case .authorized:
            print("! ✅ !")
        case .denied:
            print("! ⛔️ !" )
        case .notDetermined:
            print("! 🤔 !" )
        case .notAvailable:
            print("! 🚫 !" )
        }
    }

Request a permission

    let permission = ArekEvent()

    permission.manage { (status) in
        switch status {
        case .authorized:
            symbol = "✅"
        case .denied:
            symbol = "⛔️"
        case .notDetermined:
            symbol = "🤔"
        case .notAvailable:
            return "🚫"
        }
    }

Permissions Configuration

General configuration

Each permission type included in AREK is configurable through the ArekConfiguration struct. Each permission has a default configuration, so if you are happy with the basic configuration you don't have to care about how it works behind the scenes.

An ArekConfiguration is made up by:

frequency: ArekPermissionFrequency (.Always, .EveryHour, .OnceADay, .OnceAWeek, .JustOnce) This frequency value is related to how often you want to the user to re-enable a permission if that one has been disallowed.

Set by default to .OnceADay

presentInitialPopup: Bool This is an initial popup used to ask kindly to the user to allow a permission. This is useful to avoid burning the possibility to show the system popup.

Set by default to true

presentReEnablePopup: Bool This is the popup used to kindly to the user to re-enable that permission. The frequency value is related to this popup.

Set by defaul to true

Configure the initial and the re-enable popup: `ArekPopupData`

ArekPopupData is the struct used to configure both the pre-permission popup and the re-enable popup. These popups could be instances of the amazing PMAlertController by Codeido or native iOS alerts.

The configuration is the following:

public struct ArekPopupData {
    var title: String!
    var message: String!
    var image: String!
    var type: ArekPopupType!

    public init(title: String = "", message: String = "", image: String = "", type: ArekPopupType = .codeido) {
        self.title = title
        self.message = message
        self.image = image
        self.type = type
    }
}

This is an example of the ArekContacts pre-enable popup using PMAlertController: <br /> <img src="https://github.com/ennioma/arek/blob/master/code/Assets/arek_contacts.png" width="150">

If you want to present a native UIAlertController set the type to .native otherwise if you want to setup a PMAlertController set the type to .codeido.

Localized Strings

AREK by convention expects to find localized strings in your Localizable files in order to configure the UI.

In the following table there are the configurations for:

Pre-permission popup title
Pre-permission popup message
Re-enable popup title
Re-enable popup message
Popup image for that permission
Allow button title
Deny button title

Messages related to the iOS native permission popup should be configured following the conventions described <a href="https://developer.apple.com/library/content/documentation/General/Reference/InfoPlistKeyReference/Articles/CocoaKeys.html#//apple_ref/doc/uid/TP40009251-SW1">here</a>.

Arek

Install / Use

README

Build Status

Table of Contents

Implemented permissions

How to use AREK

Check permission status

Request a permission

Permissions Configuration

General configuration

Configure the initial and the re-enable popup: `ArekPopupData`

Localized Strings

Arek

Install / Use

README

Build Status

Table of Contents

Implemented permissions

How to use AREK

Check permission status

Request a permission

Permissions Configuration

General configuration

Configure the initial and the re-enable popup: ArekPopupData

Localized Strings

Configure the initial and the re-enable popup: `ArekPopupData`