Skip to content

Latest commit

 

History

History
173 lines (146 loc) · 8.91 KB

README.md

File metadata and controls

173 lines (146 loc) · 8.91 KB

Build Status Pod Version Pod Platform Pod License languages support

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

重要

如果在使用过程中遇到问题,请先检查使用的版本是否是最新版本(可在说明最上面的pod后面查看),如果不是最新版本,请先更新到最后版本,看看问题是否存在,如果依然存在,可提issue说明或加我QQ1094887059直接问我,最好能提供demo。

iOS14 升级

对于iOS14的升级,如果出现图片显示不出来,黑屏等情况,需要把SDWebImage 升级到至少5.8.3版本

2.x版本升级指南

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协议

关于本地gif图片的加载

1、 如果使用SDWebImage,请使用SDAnimatedImage加载本地图片
photo.image = [SDAnimatedImage imageNamed:obj];

2、如果使用YYWebImage,请使用YYImage加载本地图片
photo.image = [YYImage imageNamed:obj];

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

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

说明

GKPhotoBrowser一个可高度自定义的图片浏览器,demo里面实现的有仿微信、今日头条等的图片浏览器。

参考: KSPhotoBrowserMJPhotoBrowser(已弃用)

主要功能

* 支持iPhone、iPad
* 支持单击、双击、长按手势,支持滑动缩放
* 支持多种显示方式(none,zoom,push)
* 支持多种隐藏方式(zoom,zoomScale,zoomSlide)
* 支持多种加载方式(不明确,不明确带阴影,明确进度)
* 可自定义遮盖视图(支持SDAutoLayout 不支持Masonry)
* 支持屏幕旋转
* 支持gif图片加载

用法

1、创建包含GKPhoto的数组

NSMutableArray *photos = [NSMutableArray new];
[self.dataSource enumerateObjectsUsingBlock:^(id  _Nonnull obj, NSUInteger idx, BOOL * _Nonnull stop) {
   GKPhoto *photo = [GKPhoto new];
   photo.url = [NSURL URLWithString:obj];

   [photos addObject:photo];
}];

2、创建GKPhotoBrowser并显示

GKPhotoBrowser *browser = [GKPhotoBrowser photoBrowserWithPhotos:photos currentIndex:indexPath.row];
browser.showStyle = GKPhotoBrowserShowStyleNone;
[browser showFromVC:self];

3、自定义遮盖视图

/**
为浏览器添加自定义遮罩视图

@param coverViews 视图数组
@param layoutBlock 布局block
*/
- (void)setupCoverViews:(NSArray *)coverViews layoutBlock:(layoutBlock)layoutBlock;

效果图

1、仿微信

wechat.gif

2、今日头条

toutiao.gif

3、简书

jianshu.gif

更新

2022.07.27  2.4.0版本,修复横屏后屏幕朝上自动变为竖屏的问题 #147
2022.04.07  2.3.8版本,优化代码,修复bug #138
2022.03.25  2.3.7版本,新增animDuration属性,可自定义动画时间
2022.02.28  2.3.6版本,隐藏效果优化
2022.01.26  2.3.5版本,安全区域适配优化,导航栏隐藏优化
2021.12.06  2.3.4版本,状态栏适配优化
2021.10.12  2.3.3版本,当View controller-based status bar appearance设置为NO时适配状态栏 # 126
2021.08.05  2.3.2版本,优化pageControl的显示
2021.06.07  2.3.1版本,修复放大后滑动两张图片再返回显示异常的问题 #123
2021.05.08  2.2.1版本,手势添加位置修改
2021.04.20  2.2.0版本,修复从GKPhotoBrowser进入其他控制器再返回后的错乱问题 #120
2021.04.13  2.1.9版本,修复缩放状态下从后台进入前台缩放状态错误问题 #117
2021.03.25  2.1.8版本,修复加载多个本地图片导致的内存溢出问题 #93 #101
2021.03.11  2.1.7版本,修复内存泄漏bug
2021.03.02  2.1.5版本,修复手指缩放bug,修复自定义加载方式时代理不执行问题
2020.12.31  2.1.4版本,修复双击缩放问题#110,增加pageControl和保存按钮#107,解决与其他库冲突#108
2020.11.29  2.1.3版本,修复闪动问题#100,支持自定义图片加载类#94
2020.11.17  2.1.2版本 修复不传url只传sourceImageView时不能手势缩放的bug,去掉api弃用警告
2020.10.22  2.1.1版本 修改刘海屏手机判断方法,适配iPhone 12系列机型
2020.08.19  2.1.0版本 修复自定义coverView中UIButton点击响应延迟问题
2020.07.02  2.0.8版本 修复加载本地图片不能双击放大的bug
2020.06.18  2.0.4版本 修复删除图片bug,增加对PHAsset的支持
2020.06.15  2.0.3版本 适配支持屏幕旋转的APP及iPad
2020.06.10  2.0.1版本 优化图片单击的处理,支持自定义图片加载类
2020.04.28  2.0.0版本 优化GIF图片显示,支持SDWebImage 5.x 和 YYWebImage 
2020.03.14  1.6.0版本,增加双击放大倍数
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、新增支持多种加载方式