一款满足大多日常开发的照片选择框架

先上部分界面截图一张，gif效果图请拉至文章末尾查看

preview_with_title.png

前言

ZLPhotoBrowser 原是一款 oc 编写的框架，但有一些遗留问题（例如图片编辑功能不好用、新功能扩展不方便），以及感觉多余的功能（网络图片/视频的预览）让这个框架变的不纯粹，并带来一些负担。

所以不在大刀阔斧的对原代码进行改动，索性从 4.0.0 版本起全部由 Swift 进行重构，对原代码进行优化，并删除一些功能，让框架成为一个纯粹的照片选择框架。

功能介绍

你想要的应有尽有，预留给开发者自定义框架参数多达50个（没有的话欢迎提 issue ，功能建议好的话会采纳并着手开发）

• 支持横竖屏
• 自选框架样式
• 预览快速选择（支持拖拽选择，效果参照QQ）
• 相册内部选择（支持滑动选择）
• 图片/Gif/LivePhoto/Video 混合选择
• 自定义最大预览数/选择数/视频最大最小可选时长，控制可否选择原图
• 自定义每行显示列数
• 图片编辑（涂鸦/裁剪/马赛克）（图片编辑可编辑多张；涂鸦颜色可自定义，裁剪工具也可根据需要自行选择）
• 视频编辑（自定义最大裁剪时长）（效果参照微信视频编辑）
• 自定义相机（效果参照微信拍照，点击拍照、长按拍摄；上滑调整焦距；可设置最大录制时间及视频分辨率；可设置闪光灯模式及视频导出格式；可根据自己需要控制是否使用自定义相机）
• 多语言国际化支持（中文简/繁，英文，日文，开发者可选根据系统或自己指定，多语言文案可自定义）
• 已选择照片index
• 已选/不可选 状态下mask阴影遮罩
• 大图界面下方显示已选择照片，可拖拽排序（可根据自己需要控制是否显示）
• 大图界面下拉返回
• 相机内部拍照cell实时显示相机俘获画面
• 可自定义框架字体
• 框架各个部位颜色均可自定义（传入dynamic color即可支持 light/dark mode）
• 框架内图片资源可自定义

还有一些原 oc 框架支持的功能暂未迁移，后续会逐步迁移过来

框架支持

• iOS 10.0
• Swift 5.x
• Xcode 11.x

使用介绍

ZLPhotoConfiguration

该类为框架配置的单例类，你可以根据需求对各个参数进行修改，每个参数均有详细的介绍

ZLPhotoThemeColorDeploy

该类为框架颜色配置类，你可以根据你们app的UI对各个参数进行修改

使用示例

• 快速选择

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

• 直接进入相册选择

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

• 调用自定义相机

let camera = ZLCustomCamera()
camera.takeDoneBlock = { [weak self] (image, videoUrl) in
    // your code
}
self.showDetailViewController(camera, sender: nil)

• 调用编辑图片

let editVC = ZLEditImageViewController(image: image, tools: [.draw, .clip, .mosaic])
editVC.editFinishBlock = { [weak self] (image) in
    // your code
}
self.showDetailViewController(editVC, sender: nil)

• 自定义图片资源

// 与图片名字保持一致即可
ZLPhotoConfiguration.default().customImageNames = ["zl_btn_selected"]

• 自定义文案

// 因需要兼容oc调用，swift的struct不支持添加@objc，所以暂时只能使用这种方式
ZLPhotoConfiguration.default().customLanguageKeyValue = [ZLLocalLanguageKey.previewCamera.rawValue: "相机"]

• 支持light/dark mode颜色定义示例

if #available(iOS 13.0, *) {
    ZLPhotoConfiguration.default().themeColorDeploy.thumbnailBgColor = UIColor.init(dynamicProvider: { (trait) -> UIColor in
        if trait.userInterfaceStyle == .dark {
            return .black
        } else {
            return .white
        }
    })
}

需要注意的地方，你需要在你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

安装方法

框架支持 cocoapods / carthage / swift package manage 三种方式进行安装

• cocoapods

1. 在 Podfile 中添加 pod 'ZLPhotoBrowser'
2. 执行 pod install

如果找不到最新版本，请先执行 pod repo update

• carthage

1. 在 Cartfile 中添加 github "longitachi/ZLPhotoBrowser" ~> 4.0.0
2. 执行 carthage update ZLPhotoBrowser

• swift package manager

1. 选择 File > Swift Packages > Add Package Dependency，输入 https://github.com/longitachi/ZLPhotoBrowser.git
2. 输入对应版本号（注意SPM最低支持版本为 4.0.1 ）
3. 待Xcode下载完成点击确定即可

部分功能Gif效果图

• 快速选择及相册内部选择

快速选择.gif 相册内部选择.gif 预览大图.gif

• 编辑图片，编辑视频

editImage.gif editVideo.gif

• 多语言配置

多语言.gif