以下代码取自项目Example例子工程，更详细完整的代码请打开例子工程查看，下文是其关键代码的讲解。
用户可自由编写自己的转场动画，也可以使用框架已实现的三种动画。
框架的转场动画实现类是一个遵循了LanternAnimatedTransitioning协议的对象。只需要把动画实现类赋值给Lantern的transitionAnimator属性，即可生效。
如果用户不指定动画，transitionAnimator属性将会使用默认赋值的fade渐变动画。
lazy var transitionAnimator: LanternAnimatedTransitioning = LanternFadeAnimator()框架实现了图片打开时从小图位置放大，关闭时缩小回原位置的动画效果（以下简称Zoom动画），有两种实现，分别是：LanternZoomAnimator和LanternSmoothZoomAnimator。
LanternZoomAnimator提供了最简便的方法让用户快速获得Zoom动画，只需要告诉框架，所浏览大图对应的缩略图视图即可。
lantern.transitionAnimator = LanternZoomAnimator(previousView: { index -> UIView? in
let path = IndexPath(item: index, section: indexPath.section)
let cell = collectionView.cellForItem(at: path) as? BaseCollectionViewCell
return cell?.imageView
})LanternSmoothZoomAnimator提供了更丝滑流畅的Zoom动画，但是使用上会复杂一点，需要用户自己给出转场视图以及缩略图的位置大小。
lantern.transitionAnimator = LanternSmoothZoomAnimator(transitionViewAndFrame: { (index, destinationView) -> LanternSmoothZoomAnimator.TransitionViewAndFrame? in
let path = IndexPath(item: index, section: indexPath.section)
guard let cell = collectionView.cellForItem(at: path) as? BaseCollectionViewCell else {
return nil
}
let image = cell.imageView.image
let transitionView = UIImageView(image: image)
transitionView.contentMode = cell.imageView.contentMode
transitionView.clipsToBounds = true
let thumbnailFrame = cell.imageView.convert(cell.imageView.bounds, to: destinationView)
return (transitionView, thumbnailFrame)
})现在讲解更详细的用法。
LanternAnimatedTransitioning协议继承自UIViewControllerAnimatedTransitioning，协议声明的3个计算属性都是可选实现。
protocol LanternAnimatedTransitioning: UIViewControllerAnimatedTransitioning {
var isForShow: Bool { get set }
var lantern: Lantern? { get set }
var isNavigationAnimation: Bool { get set }
}用户需要自定义转场动画时，关注点仅在实现UIViewControllerAnimatedTransitioning上。isForShow和lantern的值将由Lantern注入，用户可在编写自己的动画实现时获取到它们的值以帮助开发。
Zoom转场动画如果需要百分百过渡顺滑，需要小图和大图的尺寸比例一致，拉伸方式、对齐方式也一致才可以达到视觉上的自然。
具体在代码实现上，需要转场的视图在小尺寸时和缩略图吻合，同时要在放大后和浏览大图吻合。如果缩略图是居中显示的，大图是顶端对齐的，那么转场视图也需要在动画过程中同时调整对齐方式。由于框架无法预实现所有应用场景，同时也为了让用户更灵活地针对自己的应用场景做定制，所以对于这种完美转场效果的需求，LanternSmoothZoomAnimator要求用户自行创建转场动画视图，以及计算出前后两端的Frame。
关于转场动画视图前后两端的Frame，是指基于lantern.view的坐标系的Frame。
对于大图端的Frame，只要图片浏览的的项视图遵循了LanternZoomSupportedCell协议，告诉框架其内容视图对象是哪个，框架即可自动计算出大图端的Frame。
/// 支持Zoom转场的Cell
protocol LanternZoomSupportedCell: UIView {
/// 内容视图
var showContentView: UIView { get }
}框架提供的作为默认项视图载体的LanternImageCell已经遵循了SupportedCell协议，如果用户需要自定义Cell，同时希望应用ZoomAnimator，那么需要这个自定义Cell遵循LanternZoomSupportedCell协议。
对于小图端的Frame，用户需要自行计算出Frame给SmoothZoomAnimator使用。
而实际应用环境中，有可能图片尺寸过大，缩略图被裁剪，这种情况下转场的前后两端是没办法吻合，框架为此做了一种折中方案，分别取小图和大图两端截图，作为两张转场视图叠加在一起，然后同时渐变加缩放，这就是LanternZoomAnimator，不带Smooth。
其实最理想最万能的方案是使用一张图片（视图），让这张图片前期和缩略图重合，随着转场过程逐渐变化，向着大图的形态拟合，结束时和大图重合。遗憾的是我暂时没有高效的实现方案，若有朋友能指点一二，万分感谢~
框架不再集成网络图片加载功能，而是让用户自由决定使用适合于自己项目的图片加载方案，比如SDWebImage和Kingfisher，例子工程皆有基本的使用示范。
// 用SDWebImage加载
lanternCell?.imageView.sd_setImage(with: url, placeholderImage: placeholder, options: [], completed: { (_, _, _, _) in
lanternCell?.setNeedsLayout()
})
// 用Kingfisher加载
lanternCell?.imageView.kf.setImage(with: url, placeholder: placeholder, options: [], completionHandler: { _ in
lanternCell?.setNeedsLayout()
})框架出于业务无关的考虑，对容易受因场景而变更的UI控件都不再集成，但会把示例实现放在例子工程中。
图片加载进度指示器就是这种UI，用户若有需要可自行下载LanternProgressView。
要给项视图(Cell)添加UI，最好是自定义自己的Cell。例子工程示范了如何通过自定义Cell，添加一个图片加载指示器。
class LoadingImageCell: LanternImageCell {
let progressView = LanternProgressView()
override func setup() {
super.setup()
addSubview(progressView)
}
override func layoutSubviews() {
super.layoutSubviews()
progressView.center = CGPoint(x: bounds.width / 2, y: bounds.height / 2)
}
func reloadData(placeholder: UIImage?, urlString: String?) {
progressView.progress = 0
let url = urlString.flatMap { URL(string: $0) }
imageView.sd_setImage(with: url, placeholderImage: placeholder, options: [], progress: { [weak self] (received, total, _) in
if total > 0 {
self?.progressView.progress = CGFloat(received) / CGFloat(total)
}
}) { [weak self] (_, error, _, _) in
self?.progressView.progress = error == nil ? 1.0 : 0
self?.setNeedsLayout()
}
}
}查看原图按钮也像图片加载指示器一样是附加UI，框架本身不集成，但是例子工程有实现，用户可结合自己项目修改使用。难点在于控制按钮的隐藏和显现，以及加载使用原图缓存的问题。 详情参考RawImageViewController
考虑到页码指示器的样式基本变化不大，所以框架选择把它们的实现集成进来。
只要是遵循了LanternPageIndicator协议的类都可以成为Lantern的页面指示器，把实现类的对象赋值给pageIndicator属性即可。
open var pageIndicator: LanternPageIndicator?
框架提供了两种页面指示器的实现，当然用户觉得都不满足需求，也可以自己编写，只需要遵循LanternPageIndicator协议即可。
两种默认实现分别是LanternDefaultPageIndicator和LanternNumberPageIndicator。
// UIPageIndicator样式的页码指示器
lantern.pageIndicator = LanternDefaultPageIndicator()
// 数字样式的页码指示器
lantern.pageIndicator = LanternNumberPageIndicator()由于框架把图片加载的权力完全交给了用户，所以加载各种各样图片格式的方案都由用户去选择。各大图片框架皆有特殊图片格式加载的实现，或是自身有实现，或是第三方的实现，用户都可以找到解决方案。
框架支持数据源动态变化，可增加删除数据，然后刷新图片浏览器，就像UITableView一样。
lantern.reloadData()变更数据源的关键在于用户控制好自己的数据一致性，包括要同步缩略图控制器的刷新。
详情查看例子工程的DataSourceDeleteViewController和DataSourceAppendViewController
这里的意思是指像微信朋友圈（相册）那样，缩略图所在是UICollectionView，有许多个Section，每个Section里有许多图片，当打开图片浏览器的时候需要把所有Section的图片全部一起浏览。
其实这个与Lantern本身能力无关，Lantern都是支持的，难点在于用户自己对数据源的处理，要处理好图片浏览器里图片的索引号与数据源里数据的IndexPath的映射关系。
详情可查看MultipleSectionViewController
框架除了支持像微信图片那样的横向浏览外，还支持像抖音视频那样的竖向浏览。仅设置一个属性即可改变方向，它的默认值是水平横向。
open var scrollDirection: Lantern.ScrollDirection = .horizontal无论是图片浏览还是视频浏览，于Lantern来说都是等同的，Lantern并不知道它的项视图(Cell)承载了什么内容。用户可通过自定义带有播放视频功能的Cell的来达到视频浏览的目的。
框架提供了项视图的生命周期方法，可帮助用户更好地控制视频的播放与停止。
open lazy var cellWillAppear: (LanternCell, Int) -> Void = { _, _ in }
open lazy var cellWillDisappear: (LanternCell, Int) -> Void = { _, _ in }
open lazy var cellDidAppear: (LanternCell, Int) -> Void = { _, _ in }例子工程有简单的本地视频播放实现，详情可参考VideoPhotoViewController
框架允许多个不同的Cell同时存在，允许给每一个项配置不同的类。
任何遵循了LanternCell协议的类都可以作为Lantern的项视图。协议仅有一个方法需要实现，就是要求提供生产实例的类方法，框架将会在适当时机通过此方法实例化Cell。
public protocol LanternCell: UIView {
static func generate(with lantern: Lantern) -> Self
}对于自定义Cell，遵循了LanternCell协议后，通过以下方法告诉Lantern每个index对应使用的类。
lantern.cellClassAtIndex = { index in
// 视频与图片交替展示
index % 2 == 0 ? VideoCell.self : LanternImageCell.self
}框架内部实现了对LanternCell的复用，即便是同时存在多个自定义Cell类，也只会最小量地生成实例。
视频与图片混合的例子VideoPhotoViewController
某些业务场景需要在最后一页浏览结束后，展示"更多推荐"视图，也是可以的，查看例子MultipleCellViewController
框架支持present和push。通过Lantern的show(method:)方法打开时，可以传入框架定义的枚举类型。
/// 通过本回调，把图片浏览器嵌套在导航控制器里
public typealias PresentEmbedClosure = (Lantern) -> UINavigationController
/// 打开方式类型
public enum ShowMethod {
case push(inNC: UINavigationController?)
case present(fromVC: UIViewController?, embed: PresentEmbedClosure?)
}
考虑到实际应用场景中，图片浏览器可能需要被嵌入在一个导航控制器里，而且要求使用已有的导航控制器，此时.push枚举能满足这中需求。
// 获取当前导航控制器
let nav = topVC.navigationController
lantern.show(method: .push(inNC: nav))inNC 可以传nil，此时框架将会尝试自己获取当前顶层的导航控制器，方便用户。
lantern.show(method: .push(inNC: nil))如果没有嵌入当前导航控制器里的需要，那么可以使用present。
fromVC是present的发起者，允许传nil值，此时框架将会尝试自己获取当前顶层控制器。
embed允许传入一个新建的导航控制器，也允许nil值，空值时Lantern将不会嵌入任何导航控制器里。
show(method:)的默认传参是参数皆为nil的present枚举。