Skip to content

nixzhu/Proposer

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Jan 20, 2020
ff56684 · Jan 20, 2020

History

54 Commits
Jan 20, 2020
Jan 20, 2020
Jan 20, 2020
Jul 10, 2015
Sep 15, 2018
Sep 8, 2016
Jan 19, 2020
Jan 20, 2020
Nov 21, 2018

Repository files navigation

Proposer

Proposer provides a single API to request permission for access Camera, Photos, Microphone, Contacts, Reminders, Calendar, Location or Notifications.

Requirements

Swift 4.2, iOS 9.0

(Swift 3, use version 1.1.0)

Example

Only one single API:

proposeToAccess(_:agreed:rejected:)

In real world:

import Proposer
@IBAction func choosePhoto() {
    let photos: PrivateResource = .photos
    let propose: Propose = {
        proposeToAccess(photos, agreed: {
            print("I can access Photos. :]\n")
            if UIImagePickerController.isSourceTypeAvailable(.savedPhotosAlbum) {
                let imagePicker = UIImagePickerController()
                imagePicker.sourceType = .savedPhotosAlbum
                self.present(imagePicker, animated: true, completion: nil)
            }
        }, rejected: {
            self.alertNoPermissionToAccess(photos)
        })
    }
    showProposeMessageIfNeedFor(photos, andTryPropose: propose)
}

When you want to get user's location, thanks to Swift's enum, you can even choose the usage mode:

@IBAction func shareLocation() {
    let location: PrivateResource = .location(.whenInUse)
    let propose: Propose = {
        proposeToAccess(location, agreed: {
            print("I can access Location. :]\n")
        }, rejected: {
            self.alertNoPermissionToAccess(location)
        })
    }
    showProposeMessageIfNeedFor(location, andTryPropose: propose)
}

Depending on your needs, you must add a NSLocationWhenInUseUsageDescription or NSLocationAlwaysUsageDescription to your Info.plist

See the demo for more information.

I recommend you add a UIViewController+Proposer.swift file (like the demo) for show localized alert before the first proposal or when propose failed.

Installation

Feel free to drag Proposer.swift to your iOS Project. But it's recommended to use Carthage (or CocoaPods).

Carthage

github "nixzhu/Proposer"

CocoaPods

pod 'Proposer'

Contact

NIX @nixzhu

License

Proposer is available under the MIT license. See the LICENSE file for more info.