Skip to content

Latest commit

 

History

History
100 lines (73 loc) · 3.92 KB

README.md

File metadata and controls

100 lines (73 loc) · 3.92 KB

AvatarImagePicker & AuthSettings

&

Version Carthage Compatible License Platform Swift

Description

AvatarImagePicker is a photo library and camera Image Picker for iOS
written in Swift, it's just a single line of code, support for selecting user's avatar by Camera or Photo Library, editing the selected image. Also, it supports auth verification, if camera or photo library was denied, it will alert the user to the settings for opening it. it means to replace for UIImagePickerController. Compatible with both Swift and Objective-C.

Installation

CocoaPods

pod 'AvatarImagePicker'

Carthage

github "janlionly/AvatarImagePicker"

Swift Package Manager

.package(url: "https://github.com/janlionly/AvatarImagePicker.git", .upToNextMajor(from: "1.3.0")),

Usage

AvatarImagePicker is presented with an actionsheet for camera and photo library, and then presented an ImagePickerController, optional some properties supports to customize, like sourceTypes, presentStyle and dismissAnimated.

Remember to add NSCameraUsageDescription and NSPhotoLibraryUsageDescription's keys for descriptions to your Info.plist

Swift

let picker = AvatarImagePicker.instance

// optional: custom properties
picker.dismissAnimated = false // default is true
picker.sourceTypes = [.camera] // default is [.camera, .photoLibrary]
picker.presentStyle = .overFullScreen // default is .fullScreen

// this method includes authorizing for photolibrary and camera.
picker.present(allowsEditing: true, selected: { (image) in
	// selected image
}) {
	// tapped cancel
   } 


// v1.3.2 updated: support to customize actions for sheet
picker.sourceTypes = [.camera, .customAction]
weak var weakSelf = self
picker.customActions = ["Delete": { weakSelf?.imageView.image = nil }]


// or you can call only auth photolibrary and camera, it will alert the user to go to settings if the photolibrary or camera was denied.
let isAuthSuccess = AuthSettings.authPhotoLibrary(message: "auth photolibrary to get your avatar") {
  print("auth success")
  // go to present image picker controller(photo library), customize your operation here.
}
_ = AuthSettings.authCamera(message: "auth camera to get your avatar") {
  print("auth success")
  // go to present image picker controller(camera), customize your operation here.
}

Objective-C

[[AvatarImagePicker avatarImagePicker] presentWithAllowsEditing:YES selected:^(UIImage * _Nonnull image) {
        // selected image
    } cancel:^{
        // tapped cancel
    }];

Requirements

  • iOS 9.0+
  • Swift 4.2 to 5.2

Author

Visit my github: janlionly
Contact with me by email: janlionly@gmail.com

Contribute

I would love you to contribute to AvatarImagePicker

License

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