iOS仿微信、今日头条等图片浏览器

GKPhotoBrowser是一个可高度自定义的图片、视频浏览器，支持多种显示、隐藏方式，支持自定义遮罩等

• 参考： KSPhotoBrowser， 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下载)

pod 'GKPhotoBrowser' 或 pod 'GKPhotoBrowser/Default'

基础库

pod 'GKPhotoBrowser/Core'

SDWebImage加载图片

pod 'GKPhotoBrowser/SD'

YYWebImage加载图片

pod 'GKPhotoBrowser/YY'

Kingfisher加载图片

pod 'GKPhotoBrowser/KF'

AVPlayer播放视频

pod 'GKPhotoBrowser/AVPlayer'

ZFPlayer播放视频

pod 'GKPhotoBrowser_Static/ZFPlayer'

IJKPlayer播放视频

pod 'GKPhotoBrowser_Static/IJKPlayer'

AFNetworking下载livePhoto

pod 'GKPhotoBrowser/AF'

Alamofire下载livePhoto

pod 'GKPhotoBrowser/Alamofire'

视频播放进度条

pod 'GKPhotoBrowser/Progress'

默认Cover视图

pod 'GKPhotoBrowser/Cover'

使用

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 setupVideoPlayerProtocol:CustomPlayerManager.new];
browser.configure = configure;

4、对于支持屏幕旋转的APP及iPad的适配

需要设置属性isFollowSystemRotation为YES，此时isScreenRotateDisabled属性将失效

5、滑动返回时显示黑屏（不出现背景渐变）

查看其他代码中是否有分类修改了UIViewController的modalPresentationStyle，GKPhotoBrowser的默认modalPresentationStyle是UIModalPresentationCustom，如果有修改则需要屏蔽对GKPhotoBrowser的修改

效果图

1、demo

2、仿微信

3、今日头条

4、简书

发布

pod trunk push --allow-warnings --skip-import-validation

版本记录

最近更新

• 3.2.8 - 2025.09.26
  • 修复使用Kingfisher高版本报错问题
• 3.2.6 - 2025.07.08
  • 获取KeyWindow方法优化
• 3.2.5 - 2025.07.03
  • 修复push显示方式，browser无法释放的问题
• 3.2.4 - 2025.04.15
  • 修复手动调用dismiss方法，browser无法释放的问题
  • 视频播放按钮显示优化
  • 增加禁止视频缩放属性
• 3.2.2 - 2025.03.07
  • 修复livePhoto重用后可能出现不播放的问题
• 3.2.1 - 2025.02.17
  • 修复livePhoto缓存清理失败的问题
  • livePhoto标识位置显示优化
• 3.2.0 - 2025.01.20
  • 视频播放增加对SJVideoPlayer 的支持
  • 代理增加viewDidLoad方法，用于实现左滑加载更多（可结合MJRefresh使用）
• 3.1.9 - 2025.01.14
  • GKPhotoBrowser动态库与静态库拆分，若要使用ZFPlayer或IJKPlayer请使用GKPhotoBrowser_Static或自定义
• 3.1.8 - 2025.01.08
  • 图片加载优化，修复自定义缓存时的显示错乱问题
• 3.1.7 - 2025.01.07
  • 1、修复设置状态栏属性无效的问题
  • 2、修复保存代理失效的问题
• 3.1.6 - 2024.12.20
  • 1、新增滑动隐藏时是否显示状态栏属性
  • 2、修复isVideoReplay为NO时，视频不能重新播放的问题 #202
  • 3、协议增加当前对应的数据模型，可方便传输额外数据
• 3.1.5 - 2024.12.19
  • 1、新增自定义cover协议，可以更方便的自定义cover视图
  • 2、livePhoto加载速度提升，加载逻辑优化
• 3.1.4 - 2024.12.06
  • 1、新增禁止上滑消失属性，即消失阈值等属性
  • 2、新增滑动消失进度更新代理
• 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

• QQ群：1047100313

• 简书

• 支持作者

回到顶部