BFRImageViewer 使用指南

BFRImageViewer 使用指南

BFRImageViewer 是一款适用于 iOS 应用的高效图片查看器，它集成了滑动手势解散、自动图像缩放、平移、多图支持、各种图片类型处理、基于 URL 的图片加载、自定义视图控制器转场以及与3D Touch的无缝集成。该组件在 Buffer for iOS 应用中广泛应用，并提供了详尽的示例代码以供参考。

安装指南

推荐通过 CocoaPods 来安装 BFRImageViewer。在您的 Podfile 中加入以下行，并运行 pod install。

pod 'BFRImageViewer'

完成安装后，确保执行 pod install 更新您的项目依赖。

项目使用说明

快速启动

要快速使用 BFRImageViewer，您只需初始化一个实例。它可以接受多种类型的图像源，如 PHAsset, NSURL, URL 字符串, UIImage, PHLivePhoto, 或 BFRBackLoadedImageSource。

Objective-C 示例：

BFRImageViewController *imageVC = [[BFRImageViewController alloc] initWithImageSource:@[image]];

Swift 示例：

let imageVC = BFRImageViewController(imageSource: [image])

然后呈现这个视图控制器即可展示图片。

API 使用文档

自定义转场动画

若想实现图片从当前视图放大到查看器的效果，可以配置 BFRImageTransitionAnimator：

Objective-C:

// 在 viewDidLoad 中...
self.imageViewAnimator = [BFRImageTransitionAnimator new];
...
self.imageViewAnimator.animatedImageContainer = self.imageView;
self.imageViewAnimator.animatedImage = self.imageView.image;
self.imageViewAnimator.imageOriginFrame = self.imageView.frame;
self.imageViewAnimator.desiredContentMode = self.imageView.contentMode; // 可选

BFRImageViewController *imageVC = [[BFRImageViewController alloc] initWithImageSource:@[self.imageView.image]];
imageVC.transitioningDelegate = self.imageViewAnimator; 
[self presentViewController:imageVC animated:YES completion:nil];

这将实现如下动画效果（图略）。

URL 后台加载功能

如果您需要先显示低分辨率图片，同时后台加载高清版本，可以使用 URL 后台加载特性：

Objective-C 示例：

BFRBackLoadedImageSource *backloadedImage = [[BFRBackLoadedImageSource alloc] initWithInitialImage:[UIImage imageNamed:@"lowResImage"] hiResURL:[NSURL URLWithString:@"cdn.theURl.png"]];
BFRImageViewController *imageVC = [[BFRImageViewController alloc] initWithImageSource:@[backloadedImage]];
[self presentViewController:imageVC animated:YES completion:nil];

项目安装方式

再次强调，建议通过CocoaPods进行安装，采用上述提供的命令行即可将BFRImageViewer添加至您的iOS项目中。

---

本指南提供了一个简洁的起点来理解和运用 BFRImageViewer。对于更多高级特性和定制需求，请参阅项目内的 Demo 应用和 GitHub Wiki 页面。遇到任何问题，欢迎提交议题或在 Twitter 上与作者互动。祝编码愉快！