Skip to content

Latest commit

 

History

History
166 lines (133 loc) · 7.45 KB

README_CN.md

File metadata and controls

166 lines (133 loc) · 7.45 KB

Version Carthage compatible SwiftPM compatible License Platform Language

image

重要说明

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

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

目录

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

如果你仅想使用图片编辑功能，请移步ZLImageEditor

功能介绍

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

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

如果你在使用中有好的需求及建议，或者遇到什么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.1.1 - 4.1.0 Patch:
  Fix:
    修复了预览本地和网络图片时，缩放后滑动会闪退的bug：
● 4.1.0:
  新增:
    编辑图片工具新增文本贴纸和图片贴纸;
    可自定义编辑图片工具顺序;
    可设置视频最大最小选择数;
    自定义相机界面可捏合调整焦距;
    长按保存本地及网络图片;
    修改iOS14 limited权限下，选择更多照片的形式;
  Fix:
    修复请求图片失败导致crash的bug;
● 4.0.9: 
    支持更多国家的语言; 
    完善iOS14 limited authority 权限的适配; 
    提供可以同时预览PHAsset、本地图片/视频及网络图片/视频的功能; 优化部分UI效果; 
    编辑图片可直接跳转裁剪界面;
...

国际化语言

🇨🇳 中文简/繁, 🇺🇸 英语, 🇯🇵 日语, 🇫🇷 法语, 🇩🇪 德语, 🇷🇺 俄语, 🇻🇳 越南语, 🇰🇷 韩语, 🇲🇾 马来语, 🇮🇹 意大利语.

使用方法

  • 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.9）
      1. 等Xcode下载完成后确定即可

效果图

  • 选择 image image image

  • 编辑图片

image

  • 编辑视频

image

  • 多语言

image

  • 自定义相机介绍

image