iOS 图片加载框架SDWebImage详解

目的

在使用SDWebImage加载图片时，尤其是加载gif等大图时，SDWebImage会将图片缓存在内存中，这样是非常吃内存的，这时我们就需要在适当的时候去释放一下SDWebImage的内存缓存，才不至于造成APP闪退。
SDWebImage 提供了 UIImageView、UIButton 、MKAnnotationView 的图片下载分类，只要一行代码就可以实现图片异步下载和缓存功能。
这样开发者就无须花太多精力在图片下载细节上，专心处理业务逻辑。

整理出 45 本电子版书籍

SDWebImage 特点

1. 提供 UIImageView, UIButton, MKAnnotationView 的分类，用来显示网络图片，以及缓存管理
2. 异步下载图片
3. 异步缓存（内存+磁盘），并且自动管理缓存有效性
4. 后台图片解压缩
5. 同一个 URL 不会重复下载
6. 自动识别无效 URL，不会反复重试
7. 不阻塞主线程
8. 高性能
9. 使用 GCD 和 ARC
10. 支持多种图片格式（包括 WebP 格式）
11. 支持动图（GIF）
12. 4.0 之前的动图效果并不是太好
13. 4.0 以后基于 FLAnimatedImage加载动图

注：本文选读的代码是 3.7.3 版本的，所以动图加载还不支持 FLAnimatedImage。

SDWebImage 使用

1. UITableView 中使用 UIImageView+WebCache

[cell.imageView sd_setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"] placeholderImage:[UIImage imageNamed:@"placeholder.png"]];

2. 使用回调 blocks

在 block 中得到图片下载进度和图片加载完成（下载完成或者读取缓存）的回调，如果你在图片加载完成前取消了请求操作，就不会收到成功或失败的回调

[cell.imageView sd_setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"]placeholderImage:[UIImage imageNamed:@"placeholder.png"]completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {... completion code here ...}];

3. SDWebImageManager 的使用

UIImageView(WebCache) 分类的核心在于 SDWebImageManager 的下载和缓存处理，SDWebImageManager将图片下载和图片缓存组合起来了。SDWebImageManager也可以单独使用。

SDWebImageManager *manager = [SDWebImageManager sharedManager];
[manager loadImageWithURL:imageURLoptions:0progress:^(NSInteger receivedSize, NSInteger expectedSize) {// progression tracking code}completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {if (image) {// do something with image}}];

4. 单独使用 SDWebImageDownloader 异步下载图片

我们还可以单独使用 SDWebImageDownloader 来下载图片，但是图片内容不会缓存。

SDWebImageDownloader *downloader = [SDWebImageDownloader sharedDownloader];
[downloader downloadImageWithURL:imageURLoptions:0progress:^(NSInteger receivedSize, NSInteger expectedSize) {// progression tracking code}completed:^(UIImage *image, NSData *data, NSError *error, BOOL finished) {if (image && finished) {// do something with image}}];

5. 单独使用 SDImageCache 异步缓存图片

SDImageCache 支持内存缓存和异步的磁盘缓存（可选），如果你想单独使用 SDImageCache 来缓存数据的话，可以使用单例，也可以创建一个有独立命名空间的 SDImageCache 实例。

添加缓存的方法：

[[SDImageCache sharedImageCache] storeImage:myImage forKey:myCacheKey];

默认情况下，图片数据会同时缓存到内存和磁盘中，如果你想只要内存缓存的话，可以使用下面的方法：

[[SDImageCache sharedImageCache] storeImage:myImage forKey:myCacheKey toDisk:NO];

读取缓存时可以使用 queryDiskCacheForKey:done: 方法，图片缓存的 key 是唯一的，通常就是图片的 absolute URL。

SDImageCache *imageCache = [[SDImageCache alloc] initWithNamespace:@"myNamespace"];
[imageCache queryDiskCacheForKey:myCacheKey done:^(UIImage *image) {// image is not nil if image was found}];

6. 自定义缓存 key

有时候，一张图片的 URL 中的一部分可能是动态变化的（比如获取权限上的限制），所以我们只需要把 URL 中不变的部分作为缓存用的 key。

SDWebImageManager.sharedManager.cacheKeyFilter = ^(NSURL *url) {url = [[NSURL alloc] initWithScheme:url.scheme host:url.host path:url.path];return [url absoluteString];};

常见问题

• 问题 1：使用 UITableViewCell 中的 imageView 加载不同尺寸的网络图片时会出现尺寸缩放问题。

解决方案：
自定义 UITableViewCell，重写 -layoutSubviews 方法，调整位置尺寸；
或者直接弃用 UITableViewCell 的 imageView，自己添加一个 imageView 作为子控件。

• 问题 2：图片刷新问题：SDWebImage 在进行缓存时忽略了所有服务器返回的 caching control 设置，并且在缓存时没有做时间限制，这也就意味着图片 URL 必须是静态的了，要求服务器上一个 URL 对应的图片内容不允许更新。但是如果存储图片的服务器不由自己控制，也就是说 图片内容更新了，URL 却没有更新，这种情况怎么办？

解决方案：在调用 sd_setImageWithURL: placeholderImage: options:方法时设置 options 参数为 SDWebImageRefreshCached，这样虽然会降低性能，但是下载图片时会照顾到服务器返回的 caching control。

• 问题 3：在加载图片时，如何添加默认的 progress indicator ？
  解决方案：在调用 -sd_setImageWithURL:方法之前，先调用下面的方法：

  [imageView sd_setShowActivityIndicatorView:YES];[imageView sd_setIndicatorStyle:UIActivityIndicatorViewStyleGray];

源码Demo获取方法

关注「网罗开发」公众号 ，有iOS demo、RN 视频以及demo、Android demo等你领取。

小专栏：https://xiaozhuanlan.com/u/fanbaoying