[](https://travis-ci.org/QuintGao/GKPhotoBrowser) [](https://cocoapods.org/pods/GKPhotoBrowser) [](https://cocoadocs.org/docsets/GKPhotoBrowser/) [](https://www.apache.org/licenses/LICENSE-2.0.html) [](#) [](#) iOS仿微信、今日头条等图片浏览器 ============== GKPhotoBrowser是一个可高度自定义的图片、视频浏览器，支持多种显示、隐藏方式，支持自定义遮罩等 - 参考： [KSPhotoBrowser](https://github.com/skx926/KSPhotoBrowser)， [MJPhotoBrowser(已弃用)](https://github.com/Sunnyyoung/MJPhotoBrowser) ## 重要 如果在使用过程中遇到问题，请先检查使用的版本是否是最新版本（可在说明最上面的pod后面查看），如果不是最新版本，请先更新到最后版本，看看问题是否存在，如果依然存在，可提issue说明或加我QQ1094887059直接问我，最好能提供demo。 ## 特性 - 支持图片浏览、视频播放、图片视频混排等 - 支持iPhone、iPad - 支持单击、双击、长按手势，支持滑动缩放 - 支持多种显示方式（none，zoom，push） - 支持多种隐藏方式（zoom，zoomScale，zoomSlide） - 支持多种加载方式（不明确、不明确带阴影、明确进度） - 支持自定义遮罩视图（支持SDAutoLayout，不支持Masonry） - 支持屏幕旋转 - 支持gif图片加载 ## 安装 默认安装，支持图片（SDWebImage加载）和视频（AVPlayer播放） ```objc pod 'GKPhotoBrowser' ``` 基础库 ```objc pod 'GKPhotoBrowser/Core' ``` SDWebImage加载图片 ```objc pod 'GKPhotoBrowser/SD' ``` YYWebImage加载图片 ```objc pod 'GKPhotoBrowser/YY' ``` AVPlayer播放视频 ```objc pod 'GKPhotoBrowser/AVPlayer' ``` ## 使用 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、关于本地gif图片的加载 1、 如果使用SDWebImage，请使用SDAnimatedImage加载本地图片 ``` photo.image = [SDAnimatedImage imageNamed:obj]; ``` 2、如果使用YYWebImage，请使用YYImage加载本地图片 ``` photo.image = [YYImage imageNamed:obj]; ``` ### 4、对于支持屏幕旋转的APP及iPad的适配 需要设置属性isFollowSystemRotation为YES，此时isScreenRotateDisabled属性将失效 ### 5、关于视频的播放处理 内部默认使用的AVPlayer播放视频，如果想要使用其他播放器可使用基础库，然后创建视频播放类并实现GKVideoPlayerProtocol协议，然后设置播放处理类 ``` [browser setupVideoPlayerProtocol:[CustomPlayerManager class]]; ``` ## 效果图 1、demo  2、仿微信  3、今日头条  4、简书  ## 版本记录

最近更新

* 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)