Skip to content

QuintGao/GKPhotoBrowser

Repository files navigation

Build Status Pod Version Pod Platform Pod License languages support

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

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

重要

如果在使用过程中遇到问题,请先检查使用的版本是否是最新版本(可在说明最上面的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/ZFPlayer'

IJKPlayer播放视频

pod 'GKPhotoBrowser/IJKPlayer'

AFNetworking下载livePhoto

pod 'GKPhotoBrowser/AF'

Alamofire下载livePhoto

pod 'GKPhotoBrowser/Alamofire'

视频播放进度条

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

2、仿微信

wechat.gif

3、今日头条

toutiao.gif

4、简书

jianshu.gif

发布

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

版本记录

最近更新
  • 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、新增支持多种加载方式

作者

            

回到顶部