khoi-backyard / zlphotobrowser Goto Github PK

This project forked from longitachi/zlphotobrowser

轻量级照片选择框架，支持预览/相册内拍照及录视频、拖拽/滑动选择，编辑裁剪图片/视频，支持多语言国际化等功能; A lightweight and pure Swift implemented library for select photos from album. Support select multiple photos, video, gif, livePhoto. Support edit image and crop video.

License: MIT License

Objective-C 0.43% Ruby 0.20% Swift 99.36% C 0.02%

zlphotobrowser's Introduction

重要说明

框架自 4.0.0 版本起，升级为纯Swift编写框架，支持最低版本由 iOS8 升级到了 iOS10
添加并增强了一些实用功能（例如图片编辑、预览界面下方小视图显示及拖拽排序等等）
删除一些功能（网络图片及视频的预览，force touch 等等）具体使用请下载demo查看

Swift 版本兼容 oc app调用；如需使用之前的oc版本（oc版本不再维护），请点这里

Swift及OC详细使用方法请查看Wiki

功能介绍

你想要的应有尽有，部分功能如下，更多功能请查看 ZLPhotoConfiguration 中的参数定义（没有的话欢迎提 issue ，功能建议好的话会采纳并着手开发）

如果你在使用中有好的需求及建议，或者遇到什么bug，欢迎随时issue，我会及时的回复

框架支持

iOS 10.0
Swift 5.x
Xcode 12.x

使用示例

快速选择

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

直接进入相册选择

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

需要注意的地方，你需要在你app的 Info.plist 中添加如下键值对

//如果不添加该键值对，则不支持多语言，相册名称默认为英文
Localized resources can be mixed YES
//或者右键plist文件Open As->Source Code 添加
CFBundleAllowMixedLocalizations

//相册使用权限描述
Privacy - Photo Library Usage Description
//相机使用权限描述
Privacy - Camera Usage Description
//麦克风使用权限描述
Privacy - Microphone Usage Description

更新日志

更多更新日志

● 4.0.8: 编辑图片添加滤镜功能;
● 4.0.7: 支持设置图片裁剪比例; 自定义相机支持录制时切换摄像头; 新增已选照片边框功能; 新增是否允许预览大图功能；其他细节优化及已知bug修复；
● 4.0.5: 适配iOS14 limited权限; 优化图片预览显示; 优化大长/宽图编辑; 
● 4.0.4: 优化图片编辑体验，记录之前编辑状态; 添加是否允许拍照参数; 优化降序照片获取顺序; fix #510, fix #513; 修复其他已知bug;
● 4.0.2: 新增框架样式设置(新增一种仿微信的样式); 编辑图片添加马赛克功能; 添加下拉返回动画; 自定义相机支持最短录制时间设置; 优化gif照片的回调;
● 4.0.1: 优化视频编辑功能; 增加自定义列数功能; 修复一些bug;
● 4.0.0: 框架升级为纯`Swift`编写，最低支持右`iOS8`升级到`iOS10`;
...

使用方法

Manually
- 1.直接把Sources文件夹拖入到你的工程中
Cocoapods
- 1.在Podfile 中添加 pod 'ZLPhotoBrowser'
- 2.执行 pod install
如找不到最新版本，可首先执行pod repo update
Carthage
- 1.在Cartfile 中添加 github "longitachi/ZLPhotoBrowser" ~> 4.0.0
- 2.执行 carthage update ZLPhotoBrowser --platform iOS
Swift Package Manager (该方式集成暂时有问题，图片及多语言资源无法读取，请暂时先用其他方式)
- 1. 选择 File > Swift Packages > Add Package Dependency，输入 https://github.com/longitachi/ZLPhotoBrowser.git
- 1. 输入对应版本号（SPM 最低版本为 4.0.5）
- 1. 等Xcode下载完成后确定即可