[![Build Status](http://img.shields.io/travis/QuintGao/GKPhotoBrowser/master.svg?style=flat)](https://travis-ci.org/QuintGao/GKPhotoBrowser) [![Pod Version](http://img.shields.io/cocoapods/v/GKPhotoBrowser.svg?style=flat)](https://cocoapods.org/pods/GKPhotoBrowser) [![Pod Platform](http://img.shields.io/cocoapods/p/GKPhotoBrowser.svg?style=flat)](https://cocoadocs.org/docsets/GKPhotoBrowser/) [![Pod License](http://img.shields.io/cocoapods/l/GKPhotoBrowser.svg?style=flat)](https://www.apache.org/licenses/LICENSE-2.0.html) [![languages](https://img.shields.io/badge/language-objective--c-blue.svg)](#) [![support](https://img.shields.io/badge/support-ios%208%2B-orange.svg)](#) iOS仿微信、今日头条等图片浏览器 ============== GKPhotoBrowser是一个可高度自定义的图片、视频浏览器，支持多种显示、隐藏方式，支持自定义遮罩等 - 参考： [KSPhotoBrowser](https://github.com/skx926/KSPhotoBrowser)， [MJPhotoBrowser(已弃用)](https://github.com/Sunnyyoung/MJPhotoBrowser) ## 重要 如果在使用过程中遇到问题，请先检查使用的版本是否是最新版本（可在说明最上面的pod后面查看），如果不是最新版本，请先更新到最后版本，看看问题是否存在，如果依然存在，可提issue说明或加我QQ1094887059直接问我，最好能提供demo。 ### 3.1.0升级说明 ** 3.1.0版本之后对项目部分代码进行了拆分，增加了GKPhotoBrowserConfigure配置类，升级后可按以下方式进行配置 方法一 ``` browser.configure.showStyle = GKPhotoBrowserShowStyleZoom; [browser.configure setupWebImageProtocol:GKYYWebImageManager.new]; ``` 方法二 ``` GKPhotoBrowserConfigure *configure = GKPhotoBrowserConfigure.defaultConfig; configure.showStyle = GKPhotoBrowserShowStyleZoom; [configure setupWebImageProtocol:GKYYWebImageManager.new]; browser.configure = configure; ``` ## 特性 - 支持图片浏览、视频播放、图片视频混排等 - 支持本地、网络、相册等资源 - 支持iPhone、iPad - 支持单击、双击、长按手势，支持滑动缩放 - 支持多种显示方式（none，zoom，push） - 支持多种隐藏方式（zoom，zoomScale，zoomSlide） - 支持多种加载方式（不明确、不明确带阴影、明确进度） - 支持自定义遮罩视图 - 支持屏幕旋转 - 支持gif图片加载 - 支持livePhoto加载播放 - 支持自定义图片加载、视频播放、livePhoto下载、进度显示等功能 - 支持Swift ## 安装 默认安装，支持图片（SDWebImage加载）、视频（AVPlayer播放）、livePhoto(AFNetworking下载) ```objc pod 'GKPhotoBrowser' 或 pod 'GKPhotoBrowser/Default' ``` 基础库 ```objc pod 'GKPhotoBrowser/Core' ``` SDWebImage加载图片 ```objc pod 'GKPhotoBrowser/SD' ``` YYWebImage加载图片 ```objc pod 'GKPhotoBrowser/YY' ``` Kingfisher加载图片 ```objc pod 'GKPhotoBrowser/KF' ``` AVPlayer播放视频 ```objc pod 'GKPhotoBrowser/AVPlayer' ``` ZFPlayer播放视频 ```objc pod 'GKPhotoBrowser/ZFPlayer' ``` IJKPlayer播放视频 ```objc pod 'GKPhotoBrowser/IJKPlayer' ``` AFNetworking下载livePhoto ```objc pod 'GKPhotoBrowser/AF' ``` Alamofire下载livePhoto ```objc pod 'GKPhotoBrowser/Alamofire' ``` 视频播放进度条 ```objc pod 'GKPhotoBrowser/Progress' ``` ## 使用 1、创建包含GKPhoto的数据源数组 ``` NSMutableArray *photos = [NSMutableArray new]; [cell.timeLineFrame.model.images enumerateObjectsUsingBlock:^(GKTimeLineImage * _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) { GKPhoto *photo = [GKPhoto new]; photo.url = [NSURL URLWithString:obj.url]; photo.sourceImageView = cell.photosView.subviews[idx]; if (obj.isVideo) { photo.videoUrl = [NSURL URLWithString:obj.video_url]; } [photos addObject:photo]; }]; ``` 2、创建浏览器 ``` GKPhotoBrowser *browser = [GKPhotoBrowser photoBrowserWithPhotos:photos currentIndex:index]; ``` 3、显示 ``` [browser showFromVC:self]; ``` 更多功能及属性可在demo和代码中查看 ## 常见问题 ### 1、iOS14 升级 对于iOS14的升级，如果出现图片显示不出来，黑屏等情况，需要把SDWebImage 升级到至少5.8.3版本 ### 2、gif图片的加载 2.0.0之后修改了对gif图片的加载方式 1、使用SDWebImage(5.x)加载图片，请使用pod 'GKPhotoBrowser' 或 'GKPhotoBrowser/SD' 2、使用YYWebImage(1.0.5)加载图片，请使用pod 'GKPhotoBrowser/YY' 3、自定义图片加载类，如：SDWebImage 5.0以下版本，请使用pod 'GKPhotoBrowser/Core'，然后添加图片加载类并实现GKWebImageProtocol协议 ### 3、本库支持多种自定义（图片加载、视频播放、livePhoto下载等等） 如果想自定义图片加载，请创建类并实现GKWebImageProtocol协议，并在浏览器显示之前进行配置 ``` GKPhotoBrowserConfigure *configure = GKPhotoBrowserConfigure.defaultConfig; [configure setupWebImageProtocol:CustomWebManager.new]; browser.configure = configure; ``` 如果想自定义视频播放，请创建类并实现GKVideoPlayerProtocol协议，并在浏览器显示之前进行配置 ``` GKPhotoBrowserConfigure *configure = GKPhotoBrowserConfigure.defaultConfig; [configure setupWebImageProtocol:CustomPlayerManager.new]; browser.configure = configure; ``` ### 4、对于支持屏幕旋转的APP及iPad的适配 需要设置属性isFollowSystemRotation为YES，此时isScreenRotateDisabled属性将失效 ### 5、滑动返回时显示黑屏（不出现背景渐变） 查看其他代码中是否有分类修改了UIViewController的modalPresentationStyle，GKPhotoBrowser的默认modalPresentationStyle是UIModalPresentationCustom，如果有修改则需要屏蔽对GKPhotoBrowser的修改 ## 效果图 1、demo ![](https://upload-images.jianshu.io/upload_images/1598505-e33c74ef898fd8b0.PNG?imageMogr2/auto-orient/strip%7CimageView2/2/w/400) 2、仿微信 ![wechat.gif](https://upload-images.jianshu.io/upload_images/1598505-5139f58eb648abeb.gif?imageMogr2/auto-orient/strip) 3、今日头条 ![toutiao.gif](https://upload-images.jianshu.io/upload_images/1598505-3273dff97637de1d.gif?imageMogr2/auto-orient/strip) 4、简书 ![jianshu.gif](https://upload-images.jianshu.io/upload_images/1598505-dbc0b13eb87ecd75.gif?imageMogr2/auto-orient/strip) ## 发布 ``` pod trunk push --allow-warnings --skip-import-validation ``` ## 版本记录
最近更新 * 3.1.3 - 2024.09.24 - 1、新增liveTargetSize属性，可自定义livePhoto相册图片加载尺寸 - 2、新增isLivePhotoLongPressPlay属性，可控制livePhoto是否可以长按播放 - 3、livePhoto播放优化，demo优化 * 3.1.2 - 2024.09.11 1、修复加载相册图片时的闪动问题 2、修复相册livePhoto加载失败的问题 * 3.1.1 - 2024.09.10 1、修复滑动隐藏bug 2、修复状态栏显示异常问题 #196 #197 * 3.1.0 - 2024.09.04 1、代码优化，增加配置类 2、本地图片加载优化，图片加载类支持为nil * 3.0.3 - 2024.08.12 1、修复系统静音情况下，播放视频无声音的问题 2、增加视频和livePhoto静音播放属性 * 3.0.2 - 2024.07.26 1、livePhoto优化，增加是否清理缓存属性 * 3.0.1 - 2024.07.03 1、修复bug #193 2、livePhoto进度优化及增加标识 * 3.0.0 - 2024.07.01 1、支持livePhoto播放（本地、网络、相册）2、修复某些情况下浏览器不能释放的问题 * 2.8.2 - 2024.06.04 1、视频加载优化，增加播放失败处理 2、视频播放支持IJKPlayer * 2.8.1 - 2024.05.24 头文件导入优化，pod优化 * 2.8.0 - 2024.05.21 1、网络加载支持Kingfisher 2、视频播放支持ZFPlayer 3、增加SwiftDemo * 2.7.6 - 2024.03.20 privacy fix * 2.7.4 - 2024.03.19 1、修复pageControl可点击的问题 2、添加隐私清单文件 * 2.7.3 - 2023.10.12 修复问题 #188 #189 * 2.7.2 - 2023.09.22 新增刷新单个photo数据的方法 #186 * 2.7.1 - 2023.09.12 修复问题 #184 #185 * 2.7.0 - 2023.09.04 修复视频播放设置isVideoReplay=NO后视频不能播放的问题 * 2.6.5 - 2023.08.30 1、新增加载失败错误处理 #180 2、修复放大后快速滑动重叠问题 #181 * 2.6.4 - 2023.08.24 1、修复横屏滑动后切换到竖屏显示异常问题 2、新增双击和放大缩小代理 * 2.6.3 - 2023.07.20 修复视频切换后不能自动播放问题 * 2.6.2 - 2023.07.07 1、适配 Mac 2、修复放大后有黑边的问题 #177 * 2.6.1 - 2023.07.05 自定义coverView时不隐藏pageControl * 2.6.0 - 2023.06.05 - 1、优化自定义图片加载时的逻辑 - 2、新增内存清理相关属性，可在适当的时候清理内存 - 3、增加视频进度视图协议，可自定义视频进度view - 4、新增大图加载demo，通过CATiledLayer显示
历史更新 * 2.5.9 - 2023.05.30 视频播放优化，新增微信聊天demo #173 * 2.5.8 - 2023.05.16 修复手势向上滑动时不缩放问题 * 2.5.7 - 2023.04.17 - 1、修复崩溃bug #170 - 2、新增属性可修改图片间距 - 3、修复放大状态下快速左右滑动显示异常问题 - 4、安全区域适配优化 * 2.5.6 - 2023.04.11 - 1、修复bug #168 #169 - 2、视频加载优化，增加获取视频尺寸方法 - 3、修复视频显示后立即滑动隐藏崩溃的问题 - 4、隐藏动画优化，修复放大状态下的隐藏闪动问题 * 2.5.4 - 2023.04.06 - 1、视频播放优化，修复bug #168 - 2、安全区域适配优化，修复横屏时切换问题 - 3、横屏显示及隐藏动画优化 * 2.5.3 - 2023.03.28 部分方法增加前缀，修复审核警告问题 #165 #166 * 2.5.2 - 2023.03.16 修复调用selectedPhoto和removePhoto方法后视频播放未停止的问题，视频播放优化 * 2.5.1 - 2023.03.15 修复使用videoView出现审核被拒的问题 #165，消除警告 * 2.5.0 - 2023.03.06 - 1、支持视频播放 - 2、代码拆分、优化 - 3、push显示支持滑动缩放返回 * 2.4.6 - 2023.02.20 修复问题 #154 #162 * 2.4.4 - 2022.10.18 新增isDoubleTapDisabled属性，禁止双击放大功能，可提高单击的响应时间 * 2.4.3 - 2022.10.08 - 1、修复图片宽高可能为0的问题 #151 - 2、优化加载原图时可能闪动的问题 #152 * 2.4.2 - 2022.09.20 适配iPhone 14 Pro屏幕，#150 * 2.4.1 - 2022.08.19 - 1、修复屏幕旋转bug #149 - 2、新增addNavigationController，可在显示图片浏览器后push到新的控制器 * 2.4.0 - 2022.07.27 修复横屏后屏幕朝上自动变为竖屏的问题 #147 * 2.3.8 - 2022.04.07 优化代码，修复bug #138 * 2.3.7 - 2022.03.25 新增animDuration属性，可自定义动画时间 * 2.3.6 - 2022.02.28 隐藏效果优化 * 2.3.5 - 2022.01.26 版本，安全区域适配优化，导航栏隐藏优化 * 2.3.4 - 2021.12.06 版本，状态栏适配优化 * 2.3.3 - 2021.10.12 当View controller-based status bar appearance设置为NO时适配状态栏 # 126 * 2.3.2 - 2021.08.05 优化pageControl的显示 * 2.3.1 - 2021.06.07 修复放大后滑动两张图片再返回显示异常的问题 #123 * 2.2.1 - 2021.05.08 手势添加位置修改 * 2.2.0 - 2021.04.20 修复从GKPhotoBrowser进入其他控制器再返回后的错乱问题 #120 * 2.1.9 - 2021.04.13 修复缩放状态下从后台进入前台缩放状态错误问题 #117 * 2.1.8 - 2021.03.25 修复加载多个本地图片导致的内存溢出问题 #93 #101 * 2.1.7 - 2021.03.11 修复内存泄漏bug * 2.1.5 - 2021.03.02 修复手指缩放bug，修复自定义加载方式时代理不执行问题 * 2.1.4 - 2020.12.31 修复双击缩放问题#110，增加pageControl和保存按钮#107，解决与其他库冲突#108 * 2.1.3 - 2020.11.29 修复闪动问题#100，支持自定义图片加载类#94 * 2.1.2 - 2020.11.17 修复不传url只传sourceImageView时不能手势缩放的bug，去掉api弃用警告 * 2.1.1 - 2020.10.22 修改刘海屏手机判断方法，适配iPhone 12系列机型 * 2.1.0 - 2020.08.19 修复自定义coverView中UIButton点击响应延迟问题 * 2.0.8 - 2020.07.02 修复加载本地图片不能双击放大的bug * 2.0.4 - 2020.06.18 修复删除图片bug，增加对PHAsset的支持 * 2.0.3 - 2020.06.15 适配支持屏幕旋转的APP及iPad * 2.0.1 - 2020.06.10 优化图片单击的处理，支持自定义图片加载类 * 2.0.0 - 2020.04.28 优化GIF图片显示，支持SDWebImage 5.x 和 YYWebImage * 1.6.0 - 2020.03.14 增加双击放大倍数 * 2020.03.12 修复crash #67,#71 感谢chimingzi，解决编译报错#65 * 2019.10.20 优化长图闪动问题，适配iOS13 * 2019.10.12 优化长图放大后点击隐藏时的闪动问题 * 2019.08.15 - 1、修复只有一张图片时的滑动问题 - 2、增加隐藏图片浏览器的方法 * 2019.07.24 增加方法可跳转到指定位置的图片 * 2019.07.02 - 1、修复禁止屏幕旋转后出现的不能滑动隐藏的bug - 2、增加maxZoomScale属性，可自己设置最大缩放比例 * 2019.05.31 修复循环引用导致的内存溢出问题 * 2019.05.06 修复长图不能上滑问题 * 2019.05.05 细节优化，修复可能出现的黑圈闪动问题 * 2019.04.26 增加支持查看原图功能 * 2019.04.15 bug fixed - 1、修复WillAppear可能出现的CALayer position contains NaN: [nan nan]问题 - 2、修复某些机型可能出现的zoom恢复原图后，不能滑动隐藏的问题 * 2019.03.28 增加GKPhotoBrowserFailStyle，可自定义图片加载失败后的显示方式 * 2019.03.21 适配SDWebImage 5.x版本 * 2019.03.18 修复图片加载器不显示问题 * 2019.01.09 增加浏览器完全消失后的回调 * 2018.12.29 优化图片隐藏时的图片旋转问题 * 2018.12.28 优化长图从底部滑动隐藏时出现的问题 * 2018.12.18 优化图片显示时的加载问题 * 2018.12.17 修复只传入sourceFrame时的显示问题 * 2018.12.10 增加是否开启处理手势冲突的属性isPopGestureEnabled * 2018.11.09 优化只有一张图片显示时的细节 * 2018.09.18 适配iPhone XS，iPhone XS Max，iPhone XR * 2018.08.30 - 1、修复删除图片时的图片重叠问题 - 2、增加自定义浏览器背景颜色属性 * 2018.08.24 修复加载失败时切换横竖屏加载视图位置不准及无法隐藏的问题 * 2018.08.20 修复影响UITableview与UICollectionView滑动卡顿问题 * 2018.08.07 - 1、移除FLAnimationImage - 2、优化gif图片的加载，增加属性isLowGifMemory，可减少gif图片的加载内存。 * 2018.08.01 - 1、增加属性isAdaptiveSafeArea，控制是否自动适配安全区域 - 2、图片超过屏幕高度不能滑动消失问题修复（超长图滑动隐藏效果不是很好，目前没找到更好的解决方案） * 2018.07.30 - 1、显示与隐藏动画优化 - 2、增加删除图片方法，重置图片数组方法 * 2018.06.30 - 1、去除多余注释 - 2、增加属性isFullWidthForLandScape 控制横屏显示 * 2018.06.13 支持GIF图片的显示 * 2018.05.28 修复本地图片不能双击放大的问题 * 2018.05.23 全面适配iPhone X * 2018.05.14 - 1、修复创建子视图不更新布局bug - 2、内存泄漏问题修复 * 2018.04.01 - 1、修复长按方式执行多次的bug - 2、新增支持多种加载方式
## 作者 - QQ： [1094887059](http://wpa.qq.com/msgrd?v=3&uin=1094887059&site=qq&menu=yes) - QQ群：[1047100313](https://qm.qq.com/cgi-bin/qm/qr?k=Aj_f4C5-R3X1_KEdeb_Ttg8pxK_41ZJu&jump_from=webapi) - [简书](https://www.jianshu.com/u/ba61bbfc87e8) - 支持作者              [回到顶部](#readme)