鲨鱼网
iOS开发-你真的会用SDWebImage？
创始人
2025-01-28 22:42:15
0次

[[166005]]

SDWebImage作为目前***的图片下载第三方框架，使用率很高。但是你真的会用吗？本文接下来将通过例子分析如何合理使用SDWebImage。

使用场景：自定义的UITableViewCell上有图片需要显示，要求网络网络状态为WiFi时，显示图片高清图；网络状态为蜂窝移动网络时，显示图片缩略图。如下图样例：

图中显示的图片符合根据网络状态下载要求

  • 由于要监听网络状态，在这里笔者推荐使用AFNetWorking。

1）在GitHub或者利用cocoaPod给项目导入第三方框架AFNetWorking。

2）在AppDelegate.m文件中的application:didFinishLaunchingWithOptions:方法中监听网络状态。

  1. // AppDelegate.m 文件中 
  2. - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions  
  3. { 
  4.     // 监控网络状态 
  5.     [[AFNetworkReachabilityManager sharedManager] startMonitoring]; 
  6. } 
  7. // 以下代码在需要监听网络状态的方法中使用 
  8. AFNetworkReachabilityManager *mgr = [AFNetworkReachabilityManager sharedManager]; 
  9.     if (mgr.isReachableViaWiFi)     { // 在使用Wifi, 下载原图 
  10.     } else     { // 其他，下载小图 
  11.     } 
  12.  } 

  • 这时就会有iOS学习者开始抱怨：这不是很简单吗？于是三下五除二写完了以下代码。

    1. // 利用MVC，在设置cell的模型属性时候，下载图片 
    2. - setItem:(CustomItem *)item 
    3. { 
    4.     _item = item; 
    5.     UIImage *placeholder = [UIImage imageNamed:@"placeholderImage"]; 
    6.     AFNetworkReachabilityManager *mgr = [AFNetworkReachabilityManager sharedManager]; 
    7.     if (mgr.isReachableViaWiFi) { // 在使用Wifi, 下载原图 
    8.         [self.imageView sd_setImageWithURL:[NSURL URLWithString:item.originalImage] placeholderImage:placeholder]; 
    9.     } else { // 其他，下载小图 
    10.         [self.imageView sd_setImageWithURL:[NSURL URLWithString:item.thumbnailImage] placeholderImage:placeholder]; 
    11.     } 
    12. } 

  • 此时，确实能完成基本的按照当前网络状态下载对应的图片，但是真实开发中，这样其实是不合理的。以下是需要注意的细节：

1）SDWebImage会自动帮助开发者缓存图片（包括内存缓存，沙盒缓存），所以我们需要设置用户在WiFi环境下下载的高清图，下次在蜂窝网络状态下打开应用也应显示高清图，而不是去下载缩略图。

2）许多应用设置模块带有一个功能：移动网络环境下仍然显示高清图。这个功能其实是将设置记录在沙盒中，关于数据保存到本地，可以查看本人另一篇简书首页文章：iOS本地数据存取，看这里就够了。

3）当用户处于离线状态时候，无法合理处理业务。

  • 于是，开始加以改进。为了让读者你更容易理解，我先贴出伪代码：

    1. - setItem:(CustomItem *)item 
    2. { 
    3.     _item = item; 
    4.     if (缓存中有原图)  
    5.     { 
    6.         self.imageView.image = 原图; 
    7.     } else  
    8.     { 
    9.         if (Wifi环境)  
    10.         { 
    11.             下载显示原图 
    12.         } else if (手机自带网络)  
    13.         { 
    14.             if (3G\4G环境下仍然下载原图)  
    15.             { 
    16.                 下载显示原图 
    17.             } else  
    18.             { 
    19.                 下载显示小图 
    20.             } 
    21.         } else  
    22.         { 
    23.             if (缓存中有小图)  
    24.             { 
    25.                 self.imageView.image = 小图; 
    26.             } else  // 处理离线状态 
    27.             { 
    28.                 self.imageView.image = 占位图片; 
    29.             } 
    30.         } 
    31.     } 
    32. } 

  • 实现上面的伪代码：读者可以一一对应上面的伪代码。练习的时候推荐先写伪代码，再写真实代码

  • 多多注意“注释”解释。

  1. - setItem:(CustomItem *)item 
  2. { 
  3.     _item = item; 
  4.      // 占位图片 
  5.     UIImage *placeholder = [UIImage imageNamed:@"placeholderImage"]; 
  6.     // 从内存\沙盒缓存中获得原图， 
  7.     UIImage *originalImage = [[SDImageCache sharedImageCache] imageFromDiskCacheForKey:item.originalImage]; 
  8.     if (originalImage) { // 如果内存\沙盒缓存有原图，那么就直接显示原图（不管现在是什么网络状态） 
  9.         self.imageView.image = originalImage; 
  10.     } else { // 内存\沙盒缓存没有原图 
  11.         AFNetworkReachabilityManager *mgr = [AFNetworkReachabilityManager sharedManager]; 
  12.         if (mgr.isReachableViaWiFi) { // 在使用Wifi, 下载原图 
  13.             [self.imageView sd_setImageWithURL:[NSURL URLWithString:item.originalImage] placeholderImage:placeholder]; 
  14.         } else if (mgr.isReachableViaWWAN) { // 在使用手机自带网络 
  15.             //     用户的配置项假设利用NSUserDefaults存储到了沙盒中 
  16.             //    [[NSUserDefaults standardUserDefaults] setBool:NO forKey:@"alwaysDownloadOriginalImage"]; 
  17.             //    [[NSUserDefaults standardUserDefaults] synchronize]; 
  18. #warning 从沙盒中读取用户的配置项：在3G\4G环境是否仍然下载原图 
  19.             BOOL alwaysDownloadOriginalImage = [[NSUserDefaults standardUserDefaults] boolForKey:@"alwaysDownloadOriginalImage"]; 
  20.             if (alwaysDownloadOriginalImage) { // 下载原图 
  21.                 [self.imageView sd_setImageWithURL:[NSURL URLWithString:item.originalImage] placeholderImage:placeholder]; 
  22.             } else { // 下载小图 
  23.                 [self.imageView sd_setImageWithURL:[NSURL URLWithString:item.thumbnailImage] placeholderImage:placeholder]; 
  24.             } 
  25.         } else { // 没有网络 
  26.             UIImage *thumbnailImage = [[SDImageCache sharedImageCache] imageFromDiskCacheForKey:item.thumbnailImage]; 
  27.             if (thumbnailImage) { // 内存\沙盒缓存中有小图 
  28.                 self.imageView.image = thumbnailImage; 
  29.             } else { // 处理离线状态，而且有没有缓存时的情况 
  30.                 self.imageView.image = placeholder; 
  31.             } 
  32.         } 
  33.     } 
  34. } 

解决了吗？真正的坑才刚刚开始。

  • 在表述上述代码的坑之前，我们先来分析一下UITableViewCell的缓存机制。

  • 请看下图：有一个tableView正在同时显示三个UITableViewCell，每个tableViewCell包含一个imageView的子控件，而且每个cell都有一个对应的模型属性用来设置imageView的图片内容。

  • 注意：由于没有cell被推出屏幕，此时缓存池为空。

cell还没有被推入缓存池

当有一个cell被推到屏幕之外时，系统会自动将这个cell放入自动缓存池。注意:cell对应的UIImage图片数据模型并没有清空！还是指向上一个使用的cell。

cell被放入缓存池

当下一个cell进入屏幕，系统会根据tableView注册的标识找到对应的cell，拿来应用。上述进入缓存池的cell被重新添加进tableView，在tableView的Data Source方法tableView: cellForRowAtIndexPath:中设置改cell对应的模型数据，此时cell对应的如图：

cell被放入缓存池

  • 以上就是tableView重用机制的简单介绍。

重新回来，那么上面所说的真正的坑在哪呢？

用一个场景来描述一下吧：当用户所处环境WiFi网速不够快(不能立即将图片下载完毕)，而在上述代码，在WiFi环境下又是下载高清大图。所以需要一定的时间来完成下载。而就在此时，用户不愿等，想看看上次打开App时显示的图片，此时用户会滑到处于下面的cell来查看。注意：此时，上面的cell下载图片操作并没有暂停，还在处于下载图片状态中。当用户在查看上次打开App的显示图片时（上次打开App下载完成的图片，SDWebImage会帮我们缓存，不用下载），而正好需要显示上次打开App时的图片的cell是利用tableView重用机制而从缓存池中拿出来的cell，等到处于上面的cell的高清大图已经下载好了的时候，SDWebImage默认做法是，立马把下载好的图片设置给ImageView，所以我们这时候会在底下的显示的cell显示上面的图片，造成数据错乱，这是非常严重的BUG。

那么该如何解决这个棘手的问题呢？

如果我们能在cell被从缓存池中拿出来使用的时候，将这个cell放入缓存池之前的下载操作移除，那么就不会出现数据错乱了。

这时候你可能会问我：怎么移除下载操作？下载操作不是SDWebImage帮我们做的吗？

说的没错，确实是SDWebImage帮我们下载图片的，我们来扒一扒SDWebImage源码，看看他是怎么完成的。

  1. - (void)sd_setImageWithURL:(NSURL *)url placeholderImage:(UIImage *)placeholder options:(SDWebImageOptions)options progress:(SDWebImageDownloaderProgressBlock)progressBlock completed:(SDWebImageCompletionBlock)completedBlock { 
  2.     // 关闭当前图片的下载操作 
  3.     [self sd_cancelCurrentImageLoad]; 
  4.     objc_setAssociatedObject(self, &imageURLKey, url, OBJC_ASSOCIATION_RETAIN_NONATOMIC); 
  5.     if (!(options & SDWebImageDelayPlaceholder)) { 
  6.         dispatch_main_async_safe(^{ 
  7.             self.image = placeholder; 
  8.         }); 
  9.     } 
  10.     if (url) { 
  11.         // check if activityView is enabled or not 
  12.         if ([self showActivityIndicatorView]) { 
  13.             [self addActivityIndicator]; 
  14.         } 
  15.         __weak __typeof(self)wself = self; 
  16.         id  operation = [SDWebImageManager.sharedManager downloadImageWithURL:url options:options progress:progressBlock completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) { 
  17.             [wself removeActivityIndicator]; 
  18.             if (!wself) return; 
  19.             dispatch_main_sync_safe(^{ 
  20.                 if (!wself) return; 
  21.                 if (image && (options & SDWebImageAvoidAutoSetImage) && completedBlock) 
  22.                 { 
  23.                     completedBlock(image, error, cacheType, url); 
  24.                     return; 
  25.                 } 
  26.                 else if (image) { 
  27.                     wself.image = image; 
  28.                     [wself setNeedsLayout]; 
  29.                 } else { 
  30.                     if ((options & SDWebImageDelayPlaceholder)) { 
  31.                         wself.image = placeholder; 
  32.                         [wself setNeedsLayout]; 
  33.                     } 
  34.                 } 
  35.                 if (completedBlock && finished) { 
  36.                     completedBlock(image, error, cacheType, url); 
  37.                 } 
  38.             }); 
  39.         }]; 
  40.         [self sd_setImageLoadOperation:operation forKey:@"UIImageViewImageLoad"]; 
  41.     } else { 
  42.         dispatch_main_async_safe(^{ 
  43.             [self removeActivityIndicator]; 
  44.             if (completedBlock) { 
  45.                 NSError *error = [NSError errorWithDomain:SDWebImageErrorDomain code:-1 userInfo:@{NSLocalizedDescriptionKey : @"Trying to load a nil url"}]; 
  46.                 completedBlock(nil, error, SDImageCacheTypeNone, url); 
  47.             } 
  48.         }); 
  49.     } 
  50. } 

我们惊奇的发现，原来SDWebImage在下载图片时，***件事就是关闭imageView当前的下载操作！

是不是开始感叹SDWebImage多么神奇了？没错，我们只需要把我们写的那段代码所有的直接访问本地缓存代码利用SDWebImage进行设置就OK了！

下面就是完成版代码。

  1. - setItem:(CustomItem *)item 
  2. { 
  3.     _item = item; 
  4.   // 占位图片 
  5.     UIImage *placeholder = [UIImage imageNamed:@"placeholderImage"]; 
  6.     // 从内存\沙盒缓存中获得原图 
  7.     UIImage *originalImage = [[SDImageCache sharedImageCache] imageFromDiskCacheForKey:item.originalImage]; 
  8.     if (originalImage) { // 如果内存\沙盒缓存有原图，那么就直接显示原图（不管现在是什么网络状态） 
  9.         [self.imageView sd_setImageWithURL:[NSURL URLWithString:item.originalImage] placeholderImage:placeholder]; 
  10.     } else { // 内存\沙盒缓存没有原图 
  11.         AFNetworkReachabilityManager *mgr = [AFNetworkReachabilityManager sharedManager]; 
  12.         if (mgr.isReachableViaWiFi) { // 在使用Wifi, 下载原图 
  13.             [self.imageView sd_setImageWithURL:[NSURL URLWithString:item.originalImage] placeholderImage:placeholder]; 
  14.         } else if (mgr.isReachableViaWWAN) { // 在使用手机自带网络 
  15.             //     用户的配置项假设利用NSUserDefaults存储到了沙盒中 
  16.             //    [[NSUserDefaults standardUserDefaults] setBool:NO forKey:@"alwaysDownloadOriginalImage"]; 
  17.             //    [[NSUserDefaults standardUserDefaults] synchronize]; 
  18. #warning 从沙盒中读取用户的配置项：在3G\4G环境是否仍然下载原图 
  19.             BOOL alwaysDownloadOriginalImage = [[NSUserDefaults standardUserDefaults] boolForKey:@"alwaysDownloadOriginalImage"]; 
  20.             if (alwaysDownloadOriginalImage) { // 下载原图 
  21.                 [self.imageView sd_setImageWithURL:[NSURL URLWithString:item.originalImage] placeholderImage:placeholder]; 
  22.             } else { // 下载小图 
  23.                 [self.imageView sd_setImageWithURL:[NSURL URLWithString:item.thumbnailImage] placeholderImage:placeholder]; 
  24.             } 
  25.         } else { // 没有网络 
  26.             UIImage *thumbnailImage = [[SDImageCache sharedImageCache] imageFromDiskCacheForKey:item.thumbnailImage]; 
  27.             if (thumbnailImage) { // 内存\沙盒缓存中有小图 
  28.                 [self.imageView sd_setImageWithURL:[NSURL URLWithString:item.thumbnailImage] placeholderImage:placeholder]; 
  29.             } else { 
  30.                 [self.imageView sd_setImageWithURL:nil placeholderImage:placeholder]; 
  31.             } 
  32.         } 
  33.     } 
  34. } 

本文就介绍到这里，如有疑问或错误，欢迎指出。

上一篇：顶级CFO共聚泉城 浪潮“互联网 管理会计”精彩亮相

下一篇：DBank华为网盘将停服

相关内容

热门资讯

PHP新手之PHP入门 PHP是一种易于学习和使用的服务器端脚本语言。只需要很少的编程知识你就能使用PHP建立一个真正交互的...
网络中立的未来 网络中立性是什... 《牛津词典》中对“网络中立”的解释是“电信运营商应秉持的一种原则，即不考虑来源地提供所有内容和应用的...
各种千兆交换机的数据接口类型详... 千兆交换机有很多值得学习的地方，这里我们主要介绍各种千兆交换机的数据接口类型，作为局域网的主要连接设...
粉嫩如何诠释霸道 东芝M805... “霸道粉”是个什么玩意东芝M805拿过来的时候，笔者扑哧笑了，不是笑这款笔记本，而是笑这款产品的颜色...
如何利用交换机和端口设置来管理... 在网络管理中，总是有些人让管理员头疼。下面我们就将介绍一下一个网管员利用交换机以及端口设置等来进行D...
什么是大数据安全 什么是大数据... 在《为什么需要大数据安全分析》一文中，我们已经阐述了一个重要观点，即：安全要素信息呈现出大数据的特征...
全面诠释网络负载均衡 负载均衡的出现大大缓解了服务器的压力，更是有效的利用了资源，提高了效率。那么我们现在来说一下网络负载...
如何允许远程连接到MySQL数... [[277004]]【51CTO.com快译】默认情况下，MySQL服务器仅侦听来自localhos...
30分钟搞定iOS自定义相机 最近公司的项目中用到了相机，由于不用系统的相机，UI给的相机切图，必须自定义才可以。就花时间简单研究...
Windows恶意软件20年“... 在Windows的早期年代，病毒游走于系统之间，偶尔删除文件（但被删除的文件几乎都是可恢复的），并弹...