README

!Language
)

!image

----------------------------------------

English | 简体中文

ZLPhotoBrowser是一款微信样式的图片选择器，支持预览/相册内拍照及录视频、拖拽/滑动选择，编辑图片/视频，支持多语言国际化等功能。

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

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

 目录
 功能介绍
 框架支持
 使用示例
 更新日志
 国际化语言
 安装方法(支持Cocoapods/Carthage/SPM安装)
 支持
 效果图

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

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

 功能介绍
你想要的应有尽有，部分功能如下，更多功能请查看 ZLPhotoConfiguration 中的参数定义（没有的话欢迎提 issue ，功能建议好的话会采纳并着手开发）
- [x] 支持SwiftUI
- [x] 支持iPad多窗口
- [x] 支持iPhone Duo折叠屏
- [x] 支持横竖屏
- [x] 自选框架样式
- [x] 支持分页加载
- [x] 预览快速选择（支持拖拽选择，效果参照QQ）
- [x] 相册内部选择（支持滑动选择）
- [x] 图片/Gif/LivePhoto/Video 混合选择
- [x] 自定义最大预览数/选择数/视频最大最小可选时长，控制可否选择原图
- [x] 自定义每行显示列数
- [x] 图片编辑（涂鸦/裁剪/图片贴纸/文字贴纸/马赛克/滤镜/色值调整(亮度、对比度和饱和度)）（图片编辑可编辑多张；涂鸦/文字颜色可自定义；裁剪比例可自定义；滤镜效果可自定义；编辑工具可根据需要自行选择）
- [x] 视频编辑（自定义最大裁剪时长）（效果参照微信视频编辑；支持编辑本地视频）
- [x] 自定义相机（效果参照微信拍照，点击拍照、长按拍摄；上滑调整焦距；可设置最大/最小录制时间及视频分辨率；可设置闪光灯模式及视频导出格式；可根据自己需要控制是否使用自定义相机）
- [x] 多语言国际化支持（中文简/繁，英文，日文，开发者可选根据系统或自己指定，多语言文案可自定义）
- [x] 已选择照片index
- [x] 已选/不可选 状态下mask阴影遮罩
- [x] 大图界面下方显示已选择照片，可拖拽排序（可根据自己需要控制是否显示）
- [x] 大图界面下拉返回
- [x] 相机内部拍照cell实时显示相机俘获画面
- [x] 可自定义框架字体
- [x] 框架各个部位颜色均可自定义（传入dynamic color即可支持 light/dark mode）
- [x] 框架内图片资源可自定义

 如果你在使用中有好的需求及建议，或者遇到什么bug，欢迎随时issue，我会及时的回复
 
 框架支持

|版本|iOS|Xcode|
|---|---|---|
|=6.0.0|15.0|27|
|Source Code 添加
 CFBundleAllowMixedLocalizations
 
 // 相册使用权限描述
 Privacy - Photo Library Usage Description
 // 相机使用权限描述
 Privacy - Camera Usage Description
 // 麦克风使用权限描述
 Privacy - Microphone Usage Description
 
 
 
 更新日志
 更多更新日志

● 6.0.0
  Add:
    适配iPhoneDuo，升级API至iOS 15.
● 5.0.0
  Add:
    优化iPad多任务及自定义窗口大小下的UI体验。
    适配iOS 26及iOS 27部分API；Demo支持iPad多窗口。
    新增参数控制App进入后台时是否关闭相机。
    新增 supportLandscape 属性控制是否支持横屏；enableWideCameras 默认值改为 true。
    新增 thumbVCAllowPanToDismiss 属性控制小图界面是否支持边缘侧滑返回。
    大幅优化贴纸及涂鸦编辑体验。
    更新相册过滤逻辑，显示更多系统相册。
  Fix:
    修复仅允许选择视频时，达到上限后提示文案错误的问题。1048
    修复选择透明底 PNG 图片被渲染为白色背景的问题。1045
    修复在预览页取消选中后，缩略图列表和大图预览选中状态未同步的问题。1042
● 4.7.4
  Add:
    支持同时编辑多个视频
    开源协议由MIT改为Apache-2.0
...


 国际化语言
🇨🇳 中文简/繁, 🇺🇸 英语, 🇯🇵 日语, 🇫🇷 法语, 🇩🇪 德语, 🇷🇺 俄语, 🇻🇳 越南语, 🇰🇷 韩语, 🇲🇾 马来语, 🇮🇹 意大利语, 🇮🇩 印度尼西亚语, 🇪🇸 西班牙语, 🇵🇹 葡萄牙语, 🇹🇷 土耳其语, 🇸🇦 阿拉伯语.

 安装方法

 Manually 
   1.直接把Sources文件夹拖入到你的工程中
  
 Cocoapods
   1.在Podfile 中添加 pod 'ZLPhotoBrowser'
   2.执行 pod install
   如找不到最新版本，可首先执行pod repo update
  
 Carthage
   1.在Cartfile 中添加 github "longitachi/ZLPhotoBrowser"
   2.执行 $ carthage update
   如果执行时遇到Building universal frameworks with common architectures is not possible. The device and simulator slices for "ZLPhotoBrowser" both build for: arm64
  Rebuild with --use-xcframeworks to create an xcframework bundle instead.这个错误，点击这里
  
 Swift Package Manager
   1. 选择 File  Swift Packages  Add Package Dependency，输入 https://github.com/longitachi/ZLPhotoBrowser.git
   2. 输入对应版本号（SPM 最低版本为 6.0.0）
   3. 等Xcode下载完成后确定即可

 支持
 给个★ Star
 请喝☕️  or   or 

 效果图
- 选择
!image
!image
!image

- 编辑图片

!image

- 编辑视频