MFFixYBImageBrowser 3.1.5

MFFixYBImageBrowser 3.1.5

×

由 MoreFunTech 维护。

MFFixYBImageBrowser 3.1.5

  • 作者
  • 杨波

CocoaPods  CocoaPods  License 

强大的 iOS 图片浏览器，易于扩展，性能优化和内存控制使它运行更加流畅和稳定。

相关文章：
YBImageBrowser 重构心得：如何优化架构、性能、内存？
避免 iOS 组件依赖冲突的小技巧

注意事项

关于 3.x 版本（使用 2.x 版本请切换到 store_2.x 分支）

为了解决 2.x 版本的设计缺陷和代码漏洞，特进行了 3.x 深度重构，所以无法实现向下兼容，敬请社群中的朋友们理解，并根据自己的情况迁移版本。

提问须知

由于作者精力有限，遇到问题请先查阅 API、参考 Demo、阅读 README、搜索 Issues。请不要提出与组件无关的问题，如 CocoaPods 错误。如果是 BUG 或 Feature，最好提交 Issue。

目录

预览

特性

  • 支持 GIF、APNG、WebP 等本地和网络图片类型（由 YYImage、SDWebImage 提供支持）。
  • 支持系统相册图片和视频。
  • 支持简单的视频播放。
  • 支持高清晰度图片浏览。
  • 支持图片预处理（如添加水印）。
  • 支持根据图片大小判断是否需要预先解码（精确控制内存）。
  • 支持图片压缩、裁剪的界限设定。
  • 支持修改下载图片的 NSURLRequest。
  • 支持主动旋转或跟随控制器旋转。
  • 支持自定义图标。
  • 支持自定义 Toast/Loading。
  • 支持自定义文案（默认提供中文和英文）。
  • 支持自定义工具视图（如查看原图功能）。
  • 支持自定义 Cell（如添加广告模块）。
  • 支持添加到其他父视图上使用（如添加到控制器上）。
  • 支持转场动效、图片布局等深度定制。
  • 支持数据重载、局部更新。
  • 支持低粒度的内存控制和性能调优。
  • 极致的性能优化和严格的内存控制使其运行更加流畅和稳定。

安装

CocoaPods

支持分库导入，核心部分是图片浏览功能，视频播放作为扩展功能按需导入。

  1. 在 Podfile 中添加：
pod 'YBImageBrowser'
pod 'YBImageBrowser/Video'  //视频功能需添加
  1. 执行 pod install 或 pod update。
  2. 导入 <YBImageBrowser/YBImageBrowser.h>，视频功能需导入<YBImageBrowser/YBIBVideoData.h>。
  3. 注意：如果你需要支持 WebP，可以在 Podfile 中添加 pod 'YYImage/WebP'。

若搜索不到库，可执行pod repo update，或使用rm ~/Library/Caches/CocoaPods/search_index.json移除本地索引后再执行安装，或更新一下CocoaPods版本。

去除 SDWebImage 的依赖（版本需 >= 3.0.4）

Podfile 相应的配置变为：

pod 'YBImageBrowser/NOSD'
pod 'YBImageBrowser/VideoNOSD'  //视频功能需添加

这时你必须定义一个类实现YBIBWebImageMediator协议，并将其赋值给YBImageBrowser类的webImageMediator属性（可以参考YBIBDefaultWebImageMediator的实现）。

手动导入

  1. 下载 YBImageBrowser 文件夹的所有内容到您的工程中，视频功能还需要下载 Video 文件夹中的所有内容。
  2. 链接以下框架：
  • SDWebImage
  • YYImage
  1. 导入 YBImageBrowser.h，视频功能需要导入YBIBVideoData.h
  2. 注意：如果您需要支持 WebP，可以在 Podfile 中添加 pod 'YYImage/WebP'，或者手动下载 YYImage 存储库 的 webP 支持文件。

用法

初始化YBImageBrowser并赋值数据源id<YBIBDataProtocol>，默认提供YBIBImageData (图片) 和YBIBVideoData (视频) 两种数据源。

图片处理是组件的核心，由于作者精力有限，视频播放做得比较轻量级，如果有更高要求，建议自定义 Cell，敬请见谅。

Demo 中提供了许多示例代码，演示了较复杂的扩展方式，因此如果需要进行深度定制，最好是下载 Demo 查看。

建议不要复用 YBImageBrowser，目前还存在一些逻辑漏洞。

基本使用

// 本地图片
YBIBImageData *data0 = [YBIBImageData new];
data0.imageName = ...;
data0.projectiveView = ...;

// 网络图片
YBIBImageData *data1 = [YBIBImageData new];
data1.imageURL = ...;
data1.projectiveView = ...;

// 视频
YBIBVideoData *data2 = [YBIBVideoData new];
data2.videoURL = ...;
data2.projectiveView = ...;

YBImageBrowser *browser = [YBImageBrowser new];
browser.dataSourceArray = @[data0, data1, data2];
browser.currentPage = ...;
[browser show];

设置支持的旋转方向

当图片浏览器依赖的 UIViewController 仅支持一个方向：

在这种情况下，通过设置 YBImageBrowser.new.supportedOrientations 来设置图片浏览器支持的旋转方向。

否则：

上面的属性将失效，图片浏览器会跟随控制器的旋转而旋转，由于各种原因，这种情况的旋转过渡可能有瑕疵，建议不使用这种方式。

自定义图标

修改 YBIBIconManager.sharedManager 实例的属性。

自定义文案

修改YBIBCopywriter.sharedCopywriter实例的属性。

自定义 Toast / Loading

实现YBIBAuxiliaryViewHandler协议，并将其实例赋值给YBImageBrowser.new.auxiliaryViewHandler属性，可参考同名的默认实现类。

自定义工具视图（ToolView）

默认实现的YBImageBrowser.new.defaultToolViewHandler处理器可以进行一些属性配置，如果不能满足业务需求，最好是进行自定义，可以参考默认实现或 Demo 中的“查看原图”功能实现。

定义一个或多个类实现YBIBToolViewHandler协议，并将其实例添加到YBImageBrowser.new.toolViewHandlers属性数组中。建议使用一个中介者来实现这个协议，然后由这个中介者来管理所有工具视图，当然也可以让每个自定义的工具 UIView 都实现YBIBToolViewHandler协议，请根据具体需求进行选择。

自定义 Cell

当默认提供的YBIBImageData (图片) 和YBIBVideoData (视频) 无法满足需求时，可以自定义扩展 Cell，可以参考默认实现或 Demo 中的示例代码。

定义一个实现YBIBCellProtocol协议的UICollectionViewCell类和一个实现YBIBDataProtocol协议的数据类，在需求不是很高的情况下，只实现必选协议方法即可，若对交互有要求，就需要相对复杂的实现，最好参考默认的交互动效实现。

在某些场景下，甚至可以直接继承项目中的 Cell 来进行自定义。

常见问题

SDWebImage Pods 版本兼容问题

SDWebImage 在两种情况下可能出现兼容问题：该库对 SDWebImage 使用模糊向上依赖，但将来 SDWebImage 可能不会很好地进行向下兼容；当其他库依赖于 SDWebImage 时，如果 API 版本不兼容，则可能出现这种情况。对于这种情况，可以尝试以下方式解决：

  • 在 Podfile 中使用去除 SDWebImage 依赖的方式导入，只需实现一个中间件（见安装部分）。
  • 更改其他库对 SDWebImage 的依赖版本。
  • 手动导入 YBImageBrowser，然后修改YBIBDefaultWebImageMediator文件。

为什么不直接去除依赖并自己实现？成本太高。为什么不做 SDWebImage 类名变更的拖入？会扩大组件体积，如果外部已经存在 SDWebImage，则会存在一份多余的代码。

依赖的 YYImage 与项目依赖的 YYKit 冲突

实际上 YYKit 已经将各个组件拆分出来了，建议项目中单独导入：

pod 'YYModel'
pod 'YYCache'
pod 'YYImage'
pod 'YYWebImage'
pod 'YYText'
...

这样会更加灵活，便于选择。

低内存设备 OOM 问题

组件内部会降低在低内存设备上的性能，减小内存占用，但若高清图过多，可能需要手动控制（以下是功耗很低的状态）：

YBIBImageData *data = YBIBImageData.new;
// 取消预解码
data.shouldPreDecodeAsync = NO;
// 直接设大触发裁剪比例，绘制更小的裁剪区域压力更小，不过可能会让用户感觉奇怪，放很大才开始裁剪显示高清局部（这个属性很多时候不需要显式设置，内部会动态计算）
data.cuttingZoomScale = 10;

YBImageBrowser *browser = YBImageBrowser.new;
// 调低图片的缓存数量
browser.ybib_imageCache.imageCacheCountLimit = 1;
// 预加载数量设为 0
browser.preloadCount = 0;

视频播放功能简陋

关于大家提出的视频需求，有些成本过高，由于本人精力有限，希望得到大家的谅解。如果组件默认的视频播放器无法满足需求，可以自定义一个 Cell，将成熟的播放器集成到组件中会更稳定。

关于 Swift 版本

考虑到时间成本，目前没有编写 Swift 版本的计划。