521hellogithub / zlphotobrowser Goto Github PK

This project forked from longitachi/zlphotobrowser

Wechat-like image picker. Support select normal photos, videos, gif and livePhoto. Support edit image and crop video. 微信样式的图片选择器，支持预览/相册内拍照及录视频、拖拽/滑动选择，编辑图片/视频，支持多语言国际化等功能;

License: MIT License

Objective-C 0.32% Ruby 0.09% Swift 99.58% C 0.01%

zlphotobrowser's Introduction

English | 简体中文

ZLPhotoBrowser is a Wechat-like image picker. Support select normal photos, videos, gif and livePhoto. Support edit image and crop video.

Features

If you have good needs and suggestions in use, or encounter any bugs, please create an issue and I will reply in time.

Requirements

iOS 10.0
Swift 5.x
Xcode 12.x

Usage

Preview selection

let ps = ZLPhotoPreviewSheet()
ps.selectImageBlock = { [weak self] (images, assets, isOriginal) in
    // your code
}
ps.showPreview(animate: true, sender: self)

Library selection

let ps = ZLPhotoPreviewSheet()
ps.selectImageBlock = { [weak self] (images, assets, isOriginal) in
    // your code
}
ps.showPhotoLibrary(sender: self)

Pay attention, you need to add the following key-value pairs in your app's Info.plist

// If you don’t add this key-value pair, multiple languages are not supported, and the album name defaults to English
Localized resources can be mixed   YES

Privacy - Photo Library Usage Description

Privacy - Camera Usage Description

Privacy - Microphone Usage Description

Update Log

More logs

● 4.1.7
  Add:
    Add a property to control whether to display the selection button animation when selecting.
    Separate the colors shared by album list interface and perview interface.
    Add a cancel block in the camera view controller.
    Support export video.
● 4.1.6
  Add:
    Add ZLCameraConfiguration class to deploy camera.
    Call select image block after dismiss.
    Optimizing the method of processing images.
  Fix
    UI frame is incorrect when preview the long image.
● 4.1.5
  Add:
    Provide a method to reset the configuration.
    Cancel the image request when operation is cancelled.
...

Languages

🇨🇳 Chinese, 🇺🇸 English, 🇯🇵 Japanese, 🇫🇷 French, 🇩🇪 German, 🇷🇺 Russian, 🇻🇳 Vietnamese, 🇰🇷 Korean, 🇲🇾 Malay, 🇮🇹 Italian.

Installation

There are four ways to use ZLPhotoBrowser in your project:

using CocoaPods
using Carthage
using Swift Package Manager
manual install (build frameworks or embed Xcode Project)

CocoaPods

To integrate ZLPhotoBrowser into your Xcode project using CocoaPods, specify it to a target in your Podfile:

source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '10.0'
use_frameworks!

target 'MyApp' do
  # your other pod
  # ...
  pod 'ZLPhotoBrowser'
end

Then, run the following command:

$ pod install

If you cannot find the latest version, you can execute pod repo update first

Carthage

To integrate ZLPhotoBrowser into your Xcode project using Carthage, specify it in your Cartfile:

github "longitachi/ZLPhotoBrowser"

Then, run the following command to build the ZLPhotoBrowser framework:

$ carthage update ZLPhotoBrowser

Swift Package Manager

Select File > Swift Packages > Add Package Dependency. Enter https://github.com/longitachi/ZLPhotoBrowser.git in the "Choose Package Repository" dialog.
In the next page, specify the version resolving rule as "Up to Next Major" with "4.0.9" as its earliest version.
After Xcode checking out the source and resolving the version, you can choose the "ZLPhotoBrowser" library and add it to your app target.