终结照片浏览器应用ios源码

开发环境：Swift 1.2  .Xcode 6.3


（一）总体说明1.本框架有OC版本，本次主要是汲取了OC版本所有bug与不足，同时听取在大量使用者的反馈与心声、修复与极大的改善了之前的OC版本并在此基础之上精心推出的Swift完美版，https://github.com/nsdictionary/CorePhotoBrowserVC。
2.纯swift支持，本地与网络支持，横竖屏支持，iPhone所有屏幕支持，iPad平板也支持并力求零Bug。
3.依赖框架说明：CFSnapKit（布局库）、Haneke（图片缓存库）、NVActivityIndicatorView（加载视图）
4.本次的文档会比较有趣，是以图片各功能来讲述的，请认真查看图片说明文字，使用也内嵌在这些图片说明中。
5.本框架基本是在我去若尔盖大草原上的长途汽车途中完成的，所以里面有大量若尔盖风景！
6.不支持pod。

快速集成
1.添加库拖拽PhotoBrowser文件夹到你的项目，拖拽Frameworks中的依赖库到您的项目中。

2.展示相册：分本地相册和网络相册
2.1展示本地相册/** 本地相册 */ func showLocal(index: Int){
let pbVC = PhotoBrowser()/**  设置相册展示样式  */pbVC.showType = showType/**  设置相册类型  */pbVC.photoType = PhotoBrowser.PhotoType.Local//强制关闭显示一切信息pbVC.hideMsgForZoomAndDismissWithSingleTap = truevar models: [PhotoBrowser.PhotoModel] = []let title = langType == LangType.Chinese ? titleLocalCH : titleENlet desc = langType == LangType.Chinese ? descLocalCH : descLocalEN//模型数据数组for (var i=0; i<9; i++){    let model = PhotoBrowser.PhotoModel(localImg:UIImage(named: "\(i+1).jpg")! , titleStr: title, descStr:desc, sourceView: displayView.subviews as! UIView)    models.append(model)}/**  设置数据  */pbVC.photoModels = modelspbVC.show(inVC: self,index: index)}

2.2展示网络相册/** 网络相册相册 */ func showHost(index: Int){
let pbVC = PhotoBrowser()/**  设置相册展示样式  */pbVC.showType = showType/**  设置相册类型  */pbVC.photoType = PhotoBrowser.PhotoType.Host//强制关闭显示一切信息pbVC.hideMsgForZoomAndDismissWithSingleTap = truevar models: [PhotoBrowser.PhotoModel] = []let titles = langType == LangType.Chinese ? titleHostCH : titleHostENlet descs = langType == LangType.Chinese ? descHostCH : descHostEN//模型数据数组for (var i=0; i<9; i++){    let model = PhotoBrowser.PhotoModel(hostHDImgURL: hostHDImageUrls, hostThumbnailImg: (displayView.subviews as! UIImageView).image, titleStr: titles, descStr: descs, sourceView: displayView.subviews as! UIView)    models.append(model)}/**  设置数据  */pbVC.photoModels = modelspbVC.show(inVC: self,index: index)}

本地相册和网络相册不同点总结如下：
1.照片浏览器属性showType：本地相册是枚举值Local,网络相册是枚举值Host
2.照片浏览器的相册模型是PhotoBrowser.PhotoModel类型，他有两个初始化方法：
本地相册请调用初始化方法PhotoBrowser.PhotoModel(localImg:...，
网络相册请调用初始化方法PhotoBrowser.PhotoModel(hostHDImgURL:...这个方法。

3.功能详解（图文使用，请认真查看）：
(1) 基本展示可以直接展示照片浏览器，且可指定page显示.之前我看过的几乎所有的照片浏览器基本都是直接添加在window上的，这样做最简单但有致命缺陷就是设置旋转之后，window上的照片浏览器并不知道。所以我在这里更改了传统做法。照片浏览器初始化传入的vc，请传当前业务控制器即可，不要乱传其他的比如navigationVC，tabarVC哦。。

照片浏览器是隐藏了状态栏的，在ios7下状态栏是基于Cotroller管理的，但这个不方便我操作，所以你需要在info.plist文件中加一个属性：View controller-based status bar appearance 并将值设置为NO。

有TabBar的情况下尤为要注意：因为照片浏览器是添加在vc之上的（能自动旋转，并在设计上是合理的），所以您的vc最好是全屏布局的，就是说最好不要使用vc.edgesForExtendedLayout，否则你可能会发现您的照片浏览器不是全屏的大小。

请设置以下代码，注意此功能仅仅在ZoomAndDismissWithSingleTap下有效

//强制关闭显示一切信息 pbVC.hideMsgForZoomAndDismissWithSingleTap = true

swift中的图片缓存框架Haneke目前不支持下载进度，所以没有图片下载进度，其他有进度的框架又是只支持ios8以上。不过我在Haneke的issue中请教了如果获取进度，不过作者还没有回复我。如果有了进度功能，我会尽快添加进度指示。