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

7,978 阅读4分钟

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

preview.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