Giter VIP home page Giter VIP logo

proposer's Introduction

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.

proposer's People

Contributors

kailan avatar mohpor avatar nixzhu avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

proposer's Issues

alertMessages not found

Hi, cant find these methods

        self.alertNoPermissionToAccess(photos) 
       showProposeMessageIfNeedFor(photos, andTryPropose: propose)

am I supposed to write them myself ?

Push Notifications?

Thanks for sharing your work!
I would like to if there is any way to prompt user for allowing push notifications?

Swift 4 Cocoapods release

Using Cocoapods we get some Swift 4 compiler errors should seems to be fix on master.
Could we have a new release to have these issues fixed? Thanks.

Carthage

Could you please add support for Carthage?

make Swift 2.0

Create a new branch swift_2.0 I will make a PR to that branch. This way wi will keep both version working. I will make a separate PR for each feature
#4 Relater to the RP

iOS 8 crash Contacts Library not loaded

I have a crash in iOS 8, beacuse the library use Contacts library, but Contacts library is available in iOS 9.0

dyld: Library not loaded: /System/Library/PrivateFrameworks/ContactsPersistence.framework/Versions/A/ContactsPersistence
Referenced from: /System/Library/Frameworks/Contacts.framework/Contacts
Reason: no suitable image found. Did find:
/System/Library/PrivateFrameworks/ContactsPersistence.framework/Versions/A/ContactsPersistence: mach-o, but not built for iOS simulator

Release 1.2.1 breaks build with Swift 4.1

Last version cannot be compiled with Swift 4.1 (Xcode 9.4.1).

Proposer.swift:38:69: error: binary operator '==' cannot be applied to operands of type '() -> AVAudioSessionRecordPermission' and '_'
            return AVAudioSession.sharedInstance().recordPermission == .undetermined

Maybe it would warrant a major version change?

Doesn't ask permission for Contacts

Hi, Thank you for this wonderful library. I however am having some trouble asking for permissions for Contacts. The thing is, when I use this following code, it just assumes that the callback is for the agreed action, and goes into case: .Authorized in private method proposeToAccessContacts in Proposer.swift. It doesn't even take any interaction from user and goes into authorized. Please help.

let contacts: PrivateResource = .Contacts

proposeToAccess(contacts, agreed: { self.delegate?.successAction(self) //Always successful without any user interaction }, rejected: { self.delegate?.failureAction(self) })

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.