iOS开源照片浏览器框架SGPhotoBrowser的设计与实现
简介
近日在制作一个开源加密相册时附带着设计了一个照片浏览器，在进一步优化后发布到了GitHub供大家使用，该框架虽然没有MWPhotoBrowser那么强大，但是使用起来更为方便，操作更符合常规相册习惯，自定义和修改源码也十分简单。
本文主要介绍这个照片浏览器框架的技术要点，如果要深入研究和使用，可以在下面的链接中下载源码。
如果你对这个框架有兴趣，可以点击这里前去GitHub下载源码，欢迎Star与指出不足。
效果图
缩略图预览，点击缩略图进入原图浏览，点击底部工具栏可以进入编辑模式。
批量导出与删除，通过底部工具栏操作。
查看原图，单击可以隐藏导航栏和工具栏，支持双击切换缩放状态、捏和手势以及左右滑动切图。
功能与特点
block数据源
照片浏览器的数据源是通过block回调的，通过实现相应的block并且提供数据模型即可完成图片显示。内存优化
高分辨率的图片在读入到内存后的内存占用是十分可观的，因此在点击缩略图进入原图浏览后，由于要左右滑动来查看其它图片的原图，因此至少加载三张原图（不考虑边缘情况），分别是当前查看的图片和与之相邻的图片，而其他图片则先加载缩略图，在滚动到那些图片时才去加载原图以及与之相邻的原图，并且替换远处的原图为缩略图。滚动优化
在滚动完全结束后才去加载原图并替换缩略图，以防止滚动时卡顿。同时支持本地与网络图片
通过URL的类型来判断图片是否来自网络，如果来自网络则异步下载并显示进度，同时进行缓存。原图浏览时支持常见的手势
原图浏览器时支持单击隐藏和显示导航栏和工具条，双击在适应屏幕和原始尺寸之间切换，捏和手势可以缩放图片，左右滑动可以切换图片。支持批量导出与删除照片
可以通过工具栏进入编辑模式来批量处理图片的导出与删除。
技术要点
概述
照片浏览器框架依赖了SDWebImage和MBProgressHUD，前者用于处理图片的异步下载与缓存，后者用于显示图片下载的进度。用于缩略图显示的是collectionView，查看原图时每一张图片都被均匀排列在scrollView上，每一张图片也被包裹了一个scrollView用于处理缩放。
block数据源
使用代理模式回调数据源会使得代码较为分散，因此本框架使用了block来回调，在SGPhotoBrowser中有四个数据源block，通过实现他们并且提供相应的数据即可完成图片显示，这四个block如下面代码所示。
@property (nonatomic, copy, readonly) SGPhotoBrowserDataSourceNumberBlock numberOfPhotosHandler;
@property (nonatomic, copy, readonly) SGPhotoBrowserDataSourcePhotoBlock photoAtIndexHandler;
@property (nonatomic, copy, readonly) SGPhotoBrowserReloadRequestBlock reloadHandler;
@property (nonatomic, copy, readonly) SGPhotoBrowserDeletePhotoAtIndexBlock deleteHandler;每个照片通过一个SGPhotoModel数据模型类要描述，其中包含了photoURL与thumbURL，分别代表原图和缩略图的URL，通过URL是否是fileURL来决定是否要异步下载缓存。
block数据源在缩略图浏览时被collectionView的dataSource所调用，在原图浏览时被调用以获取特定位置的图片URL或进行删除照片后的数据刷新。
内存优化
在查看原图时，加载当前位置和与其相邻位置的原图，其他位置均加载缩略图，在滑动过程中，动态的切换原图的加载位置并将原来位置的原图替换为缩略图，以保证内存中最多有三张原图被加载以节省内存，具体实现代码如下。
// 点击index处的缩略图时调用，来显示原图
- (void)loadImageAtIndex:(NSInteger)index {
// 通过browser的数据源方法获取模型数量
NSInteger count = self.browser.numberOfPhotosHandler();
// 遍历所有照片模型以及照片视图
for (NSInteger i = 0; i < count; i++) {
SGPhotoModel *model = self.browser.photoAtIndexHandler(i);
SGZoomingImageView *imageView = self.imageViews[i];
NSURL *photoURL = model.photoURL;
NSURL *thumbURL = model.thumbURL;
// index位置和与其相邻的位置加载原图
if (i >= index - 1 && i <= index + 1) {
if (imageView.isOrigin) continue;
// 根据URL选择图片是直接从本地加载还是异步下载缓存的方法
[imageView.innerImageView sg_setImageWithURL:photoURL model:model];
// 用于指示这个imageView是否加载的是原图
imageView.isOrigin = YES;
// 缩放至适应屏幕
[imageView scaleToFitAnimated:NO];
} else {
// 对于其他位置的图片，如果是原图，则替换为缩略图
if (!imageView.isOrigin) continue;
[imageView.innerImageView sg_setImageWithURL:thumbURL model:model];
imageView.isOrigin = NO;
[imageView scaleToFitAnimated:NO];
}
}
}滚动优化
在scrollView的滚动效果尚未停止时进行耗时操作会造成卡顿，为了避免这种情况，可以在scrollView减速完毕后再进行耗时操作。在本框架中，在左右滑动切换图片时，如果立即加载原图，会造成卡顿，因此在scrollView减速完毕后才将缩略图替换为原图，具体实现如下。
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {
// 先通过偏移量计算出当前滚动到的图片的索引
CGFloat offsetX = scrollView.contentOffset.x;
NSInteger index = (offsetX + _pageW * 0.5f) / _pageW;
// 索引发生变化时才更新并加载原图
if (_index != index) {
_index = index;
// 上文提到的加载原图的方法
[self loadImageAtIndex:_index];
}
}本地图片与网络图片的处理
所有的图片都是通过URL进行设置，通过为UIImageView添加分类，并添加方法sg_setImageWithURL:model:方法，传入当前要加载的图片的URL以及照片模型，在方法内，通过URL类型来判断是否要进行异步下载和缓存，在异步下载时，使用MBProgressHUD来指示进度，具体代码如下。
@interface UIImageView (SGExtension)
// 通过动态绑定来实现为UIImageView添加属性
@property (nonatomic, weak) MBProgressHUD *hud;
@property (nonatomic, strong) SGPhotoModel *model;
- (void)sg_setImageWithURL:(NSURL *)url model:(SGPhotoModel *)model;
@end@implementation UIImageView (SGExtension)
// 动态绑定hud和model两个属性的key
static char hudKey;
static char modelKey;
// 由于分类不允许添加属性，因此需要手动实现setter与getter
@dynamic hud;
@dynamic model;
- (void)sg_setImageWithURL:(NSURL *)url {
if (![url isFileURL]) {
// 如果不是文件URL，则说明需要下载，通过SDWebImage处理
SDImageCache *cache = [SDImageCache sharedImageCache];
SDWebImageManager *mgr = [SDWebImageManager sharedManager];
NSString *key = [mgr cacheKeyForURL:url];
// 如果在缓存中找到了图片，则直接加载并返回
if ([cache diskImageExistsWithKey:key] || ([cache imageFromMemoryCacheForKey:key] != nil)) {
[self sd_setImageWithURL:url];
return;
}
// 如果已经有了进度指示器，则说明正在下载图片，直接返回
if (self.hud != nil) {
return;
}
// 图片需要下载，且任务还未开始，通过MBProgressHUD指示下载进度，通过SDWebImage来下载和缓存图片
MBProgressHUD *hud = [[MBProgressHUD alloc] initWithView:self];
self.hud = hud;
hud.mode = MBProgressHUDModeAnnularDeterminate;
[self addSubview:hud];
[hud showAnimated:YES];
// 如果对应于当前原图的缩略图已经下载完成，则先在原图浏览中显示缩略图作为占位图，否则显示默认的黑色图片。
UIImage *placeHolderImage = [UIImage imageWithContentsOfFile:[[NSBundle mainBundle] pathForResource:@"SGPhotoBrowser.bundle/ImagePlaceholder.png" ofType:nil]];
if (self.model.thumbURL) {
NSString *key = [mgr cacheKeyForURL:self.model.thumbURL];
UIImage *tempImage = [cache imageFromMemoryCacheForKey:key];
if (tempImage == nil) {
tempImage = [cache imageFromDiskCacheForKey:key];
}
if (tempImage) {
placeHolderImage = tempImage;
}
}
[self sd_setImageWithURL:url placeholderImage:placeHolderImage options:SDWebImageRetryFailed progress:^(NSInteger receivedSize, NSInteger expectedSize) {
hud.progress = (float)receivedSize / expectedSize;
} completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {
[hud removeFromSuperview];
self.hud = nil;
}];
} else {
// 对于文件URL，直接从文件系统中加载
self.image = [UIImage imageWithContentsOfFile:url.path];
}
}
// 公共方法，由于占位图相关逻辑需要缩略图URL，因此需要传递model，上面的方法为私有方法
- (void)sg_setImageWithURL:(NSURL *)url model:(SGPhotoModel *)model {
self.model = model;
[self sg_setImageWithURL:url];
}
// 动态绑定的两属性的getter和setter
#pragma mark - Setter
- (void)setHud:(MBProgressHUD *)hud {
objc_setAssociatedObject(self, &hudKey, hud, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
- (void)setModel:(SGPhotoModel *)model {
objc_setAssociatedObject(self, &modelKey, model, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}
#pragma mark - Getter
- (MBProgressHUD *)hud {
return objc_getAssociatedObject(self, &hudKey);
}
- (SGPhotoModel *)model {
return objc_getAssociatedObject(self, &modelKey);
}
@end原图浏览时的手势处理
每张图片使用一个scrollView包裹来处理捏合手势缩放，同时通过touchesEnded::方法来判断单击和双击，由于双击时会经过单击状态，这里将单击事件滞后0.2s处理，如果在这期间触发了双击，则取消单击事件的处理，实现如下。
- (void)touchesEnded:(NSSet<UITouch *> *)touches withEvent:(UIEvent *)event {
UITouch *touch = [touches anyObject];
CGPoint touchPt = [touch locationInView:self.innerImageView];
self.currentTouchPoint = touchPt;
NSInteger tapCount = touch.tapCount;
switch (tapCount) {
case 1:
// 延时执行，防止和双击事件重叠
[self performSelector:@selector(handleSingleTap) withObject:nil afterDelay:0.2];
break;
case 2:
[self handleDoubleTap];
break;
default:
break;
}
[[self nextResponder] touchesEnded:touches withEvent:event];
}
- (void)handleDoubleTap {
// 取消单击事件
[NSObject cancelPreviousPerformRequestsWithTarget:self];
// 在适应屏幕和原始尺寸之间翻转图片的显示状态
[self toggleStateAnimated:YES];
}图片的批量处理
在照片的数据模型SGPhotoModel上有一个isSelected属性来判断当前图片是否被选中，通过collectionView的代理方法didUnhighlightItemAtIndexPath:来处理图片的选中与反选，为了统一点击事件，将点击缩略图进入原图浏览模式的代码也放到了这里，通过是否是编辑模式来区分，编辑模式由于和工具栏直接相关，因此被记录在工具栏中，具体实现代码如下。
- (void)collectionView:(UICollectionView *)collectionView didUnhighlightItemAtIndexPath:(nonnull NSIndexPath *)indexPath {
SGPhotoCell *cell = (SGPhotoCell *)[collectionView cellForItemAtIndexPath:indexPath];
// 如果处于编辑模式，则处理图片的选中和反选并返回
if (self.toolBar.isEditing) {
SGPhotoModel *model = self.photoAtIndexHandler(indexPath.row);
model.isSelected = !model.isSelected;
// 记录所有选中的图片数据模型
if (model.isSelected) {
[self.selectModels addObject:model];
} else {
[self.selectModels removeObject:model];
}
cell.model = model;
return;
}
// 如果缩略图在下载中，则不允许进入原图浏览，hud用于指示下载进度，因此有hud则正在下载
if (cell.imageView.hud) return;
// 如果缩略图已经下载完毕，则允许进入原图浏览模式
SGPhotoViewController *vc = [SGPhotoViewController new];
vc.browser = self;
vc.index = indexPath.row;
[self.navigationController pushViewController:vc animated:YES];
}更多技术细节可以在GitHub上的源码中查看，点击这里前去GitHub下载源码，欢迎Star和指出不足。
