ZLPhotoBrowser: An Objective-C repository from Longroader

框架整体介绍

功能介绍
更新日志
使用方法(支持cocoapods安装)
问答
效果图

功能介绍

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.导入 <ZLPhotoActionSheet.h>

第二步：

在项目plist配置文件中添加如下键值对

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

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

代码中调用

#import "ZLPhotoActionSheet.h"
    
ZLPhotoActionSheet *actionSheet = [[ZLPhotoActionSheet alloc] init];
//设置照片最大预览数
actionSheet.maxPreviewCount = 20;
//设置照片最大选择数
actionSheet.maxSelectCount = 10;
actionSheet.sender = self;

[actionSheet setSelectImageBlock:^(NSArray<UIImage *> * _Nonnull images, NSArray<PHAsset *> * _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)

该错误会出现在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: '[<ZLThumbnailViewController 0x15bed0d10> setValue:forUndefinedKey:]: this class is not key value coding-compliant for the key verLeftSpace.'