# ZLPhotoBrowser
**Repository Path**: lyb5834/ZLPhotoBrowser
## Basic Information
- **Project Name**: ZLPhotoBrowser
- **Description**: 方便易用的相册多选框架，支持预览/相册内拍照、预览快速多选照片，3DTouch预览照片，编辑裁剪图片，编辑视频，混合多选image、gif、Live Photo及video；相册混合选择；原图功能；支持多语言国际化（中文简/繁，英语，日语）；在线下载iCloud端图片；自定义最大选择量及最大预览量；自定义照片升序降序排列；自定义照片显示圆角弧度；支持预览网络及本地图片
- **Primary Language**: Objective-C
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-12-28
- **Last Updated**: 2021-12-28
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
[](http://cocoadocs.org/docsets/ZLPhotoBrowser)
[](http://cocoadocs.org/docsets/ZLPhotoBrowser)
[](http://cocoadocs.org/docsets/ZLPhotoBrowser)
----------------------------------------
### 框架整体介绍
* [功能介绍](#功能介绍)
* [更新日志](#更新日志)
* [使用方法(支持cocoapods安装)](#使用方法)
* [问答](#问答)
* [效果图](#效果图)
### 功能介绍
- [x] 支持横竖屏 (已适配iPhone X)
- [x] 预览快速选择、可设置预览最大数
- [x] 直接进入相册选择
- [x] 支持滑动多选
- [x] 裁剪图片(可自定义裁剪比例)
- [x] 编辑视频
- [x] 查看、选择gif、LivePhoto(iOS9.0)、video
- [x] 3D Touch预览image、gif、LivePhoto、video
- [x] 混合选择image、gif、livePhoto、video
- [x] 在线下载iCloud照片
- [x] 控制选择video最大时长
- [x] 多语言国际化(中文简/繁、英文、日文)
- [x] 相册内拍照按钮实时显示镜头捕捉画面
- [x] 已选择图片遮罩层标记
- [x] 预览已选择照片
- [x] 预览网络及本地照片
- [x] 相册内图片自定义圆角弧度
- [x] 自定义升序降序排列
- [x] 多张拍照
### Feature
- [ ] 支持预览网络图片时长按下载
> 如果您在使用中有好的需求及建议，或者遇到什么bug，欢迎随时issue，我会及时的回复
### 更新日志
```
● 2.4.3: 适配iPhone X，优化初次启动进入相册速度，预览网络图片可设置是否显示底部工具条及导航右侧按钮;
● 2.4.2: 新增编辑视频功能;
● 2.4.1: 新增仿iPhone相册滑动多选功能;
● 2.4.0: 新增预览网络及本地图片api，并可进行选择删除;
● 2.3.3: 删除废弃文件，新增在已选择图片上显示遮罩层标记功能;
● 2.3.2: 新增设置导航颜色api，适配横屏，适配iPad;
● 2.2.9: 新增单选模式下选择图片后直接进入编辑界面功能，提供设置裁剪比例api;
● 2.2.8: 更新编辑图片功能，增加裁剪比例选项(1:1, 3:4, 2:3, 9:16,等比例，开发者可根据需求，按照规则自行添加所需比例);
● 2.2.6: ①：可混合选择image、gif、livephoto、video类型;
②：支持video、gif、livephoto类型的多选;
③：支持控制video最大选择时长;
● 2.2.3: 新增图片编辑功能;
● 2.2.1: 新增3D Touch预览功能 (需设备支持);
```
### 框架支持
最低支持：iOS 8.0
IDE：Xcode 9.0 及以上版本 (由于适配iPhone X使用iOS11api，所以请使用Xcode 9.0及以上版本)
### 使用方法
第一步：
* Manually
* 1.直接把PhotoBrowser文件夹拖入到您的工程中
* 2.导入 Photos.framework及PhotosUI.framework
* 3.项目依赖 `SDWebImage`，所以需要导入该框架
* 4.导入 "ZLPhotoActionSheet.h"
* Cocoapods
* 1.在Podfile 中添加 `pod 'ZLPhotoBrowser'`
* 2.执行 `pod setup`
* 3.执行 `pod install` 或 `pod update`
* 4.导入 \
第二步：
- 在项目plist配置文件中添加如下键值对
```objc
//如果不添加该键值对，则不支持多语言，相册名称默认为英文
Localized resources can be mixed YES
//或者右键plist文件Open As->Source Code 添加
CFBundleAllowMixedLocalizations
//相册使用权限描述
Privacy - Photo Library Usage Description
//相机使用权限描述
Privacy - Camera Usage Description
```
代码中调用
```objc
#import "ZLPhotoActionSheet.h"
ZLPhotoActionSheet *actionSheet = [[ZLPhotoActionSheet alloc] init];
//设置照片最大预览数
actionSheet.maxPreviewCount = 20;
//设置照片最大选择数
actionSheet.maxSelectCount = 10;
actionSheet.sender = self;
[actionSheet setSelectImageBlock:^(NSArray * _Nonnull images, NSArray * _Nonnull assets, BOOL isOriginal) {
//your codes
}];
//调用相册
[actionSheet showPreviewAnimated:YES];
//预览网络图片
[actionSheet previewPhotos:arrNetImages index:0 hideToolBar:YES complete:^(NSArray * _Nonnull photos) {
//your codes
}];
```
### 问答
* 关于 `@available(9.0, *)` 报错 ([#90](https://github.com/longitachi/ZLPhotoBrowser/issues/90))
> 该错误会出现在XCode 9.0以下版本，把该代码替换为 `[UIDevice currentDevice].systemVersion.floatValue >= 9.0` 即可
* 从 `pod 2.4.3` 以下版本更新到 `pod 2.4.3` 以上版本报如下错误 `Terminating app due to uncaught exception 'NSUnknownKeyException', reason: '[ setValue:forUndefinedKey:]: this class is not key value coding-compliant for the key verLeftSpace.'`
> 由于 `pod 2.4.3` 版本删除对应xib，所以请执行 `command+shift+k` clean项目，重启Xcode即可
### 效果图
- 多语言国际化效果图
- iPhone X
- 3DTouch预览效果图
- 编辑视频预览图
- 编辑图片预览图
- 滑动多选预览图
- 混合选择预览图
- 横屏预览图
- 预览网络图片
- 遮罩层
- 预览快速多选效果图
- 直接进入相册选择相片效果图
- 预览大图及缩放效果图
- 拍照
- 相册内混合选择效果图
- 预览已选择照片效果图
- 原图功能效果图
