SDWebImage的使用以及内部执行流程

2016-05-07 本文已影响347人 YuWenHaiBo

SDWebImage是项目中处理图片常用的一种方式，用于做图片缓存，因为项目中图片是最占用资源的，如果处理不当会很麻烦，但是有了SDWebImage来做图片缓存，一切都so easy！SDWebImage在两个月前刚更新了新的，下边是使用SDWebImage的简单步骤，最后有demo提供给大家，供大家学习。

第一步：下载SDWebImage,将SDWebImage文件夹导入到工程中 (SDWebImage是ARC环境下可以使用的，故不用加任何修饰)

SDWebImage官方下载地址：https://github.com/rs/SDWebImage

2.png

（demo实现的基本内容）在根试图上加一个按钮，此按钮用于推出tableView列表，列表中有图片的展示，图片展示的时候点击相应的行能进入图片下载界面

第二步：在需要的地方将SDWebImage对应的头文件引入。

1. 创建UIFactory类用于创建各类控件（这样写的好处：简化代码，代码看着清晰易懂）

one.png

2. UIFactory实现部分

two.png

3. 在根试图控制器里边创建一个button按钮用于推出tableViewList界面

three.png

4. 在UITableViewController中需要图片展示，并存到缓存中，故需要将SDWebImage封装的头文件中引入相应的头文件

#import "SDWebImage/UIImageView+WebCache.h"

5. 在UITableViewController中创建一个数组用于存取图片网址数组,并给数组初始化一些图片网址

four.png

第三步：调用sd_setImageWithURL：方法缓存图片，注意，这就是新版本的新方法，旧方法是setImageWithURL:。下面将几个方法都介绍一下：

1.sd_setImageWithURL：
//图片缓存的基本方法  
[cell.imageView sd_setImageWithURL:[NSURL URLWithString:urlStr]];

//图片缓存的基本方法  
[cell.imageView sd_setImageWithURL:[NSURL URLWithString:urlStr]];

2.sd_setImageWithURL:  completed:
//用block 可以在图片加载完成之后做些事情  

[cell.imageView sd_setImageWithURL:[NSURL URLWithString:urlStr] completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {    
    NSLog(@"图片加载完成后需要做的事情");      
}];  

//用block 可以在图片加载完成之后做些事情  

[cell.imageView sd_setImageWithURL:[NSURL URLWithString:urlStr] completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {  
    NSLog(@"图片加载完成后需要做的事情");  
}];  


3.sd_setImageWithURL:  placeholderImage:

//常用这个，为的是当网速不给力的时候，默认出来的是本地图片,用户体验比较好不会出来大白板的现象  

[cell.imageView sd_setImageWithURL:[NSURL URLWithString:urlStr] placeholderImage:[UIImage imageNamed:@"my_account_icon.png"]];  

//常用这个，为的是当网速不给力的时候，默认出来的是本地图片,用户体验比较好不会出来大白板的现象  

[cell.imageView sd_setImageWithURL:[NSURL URLWithString:urlStr] placeholderImage:[UIImage imageNamed:@"my_account_icon.png"]];

在这个demo中我就选用了这个方法具体代码如下图：

如果你此时运行工程，图片是加载不出来的，因为iOS9网络适配更改为更为安全的HTTPS了，此时如果去解析HTTP开头的网址内容是显示不出来的，需要开发者做一下简单的设置：比较简单的方法：在info.plist-->Open As-->Source Code中添加一段代码即可:

<key>NSAppTransportSecurity</key>
    <dict>
        <key>NSAllowsArbitraryLoads</key>
        <true/>
    </dict>

**4.sd_setImageWithURL:  placeholderImage:  completed:**

//使用默认图片，而且用block 在完成后做一些事情  

  [cell.imageView sd_setImageWithURL:[NSURL URLWithString:urlStr] placeholderImage:[UIImage imageNamed:@"my_account_icon.png"] completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {    
      NSLog(@"图片加载完成后需要做的事情");     
  }]; 

//使用默认图片，而且用block 在完成后做一些事情  
 
[cell.imageView sd_setImageWithURL:[NSURL URLWithString:urlStr] placeholderImage:[UIImage imageNamed:@"my_account_icon.png"] completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {  
        NSLog(@"图片加载完成后需要做的事情");  
    }];
  

5. sd_setImageWithURL:  placeholderImage:  options:

//options选择相应的方式：枚举值 
 
    [cell.imageView sd_setImageWithURL:[NSURL URLWithString:urlStr] placeholderImage:[UIImage imageNamed:@"my_account_icon.png"] options:SDWebImageRetryFailed];  
//options选择相应的方式：枚举值  

    [cell.imageView sd_setImageWithURL:[NSURL URLWithString:urlStr] placeholderImage:[UIImage imageNamed:@"my_account_icon.png"] options:SDWebImageRetryFailed];  

其他的在这里我就不一一介绍了，OC文档相信大家一看到方法名都有种见名知意的感觉，除了options带选项的方法，其他的都是综合存储，也就是内存缓存和磁盘缓存结合的方式，例如：如果你只需要**如果你只需要内存缓存，那么在options这里选择SDWebImageCacheMemoryOnly就可以了。**

接下来我要解释options的所有选项，以及SDWebImage内部执行流程。
1>options的所有选项：

  //失败后重试    
 SDWebImageRetryFailed = 1 << 0,         
 //UI交互期间开始下载，导致延迟下载比如UIScrollView减速。   
  SDWebImageLowPriority = 1 << 1,     
     //只进行内存缓存 
    SDWebImageCacheMemoryOnly = 1 << 2,       
   //这个标志可以渐进式下载,显示的图像是逐步在下载   
  SDWebImageProgressiveDownload = 1 << 3,    
      //刷新缓存 
    SDWebImageRefreshCached = 1 << 4,          
//后台下载  
 SDWebImageContinueInBackground = 1 << 5, 
 //NSMutableURLRequest.HTTPShouldHandleCookies = YES;   
  SDWebImageHandleCookies = 1 << 6,    
     //允许使用无效的SSL证书     
//SDWebImageAllowInvalidSSLCertificates = 1 << 7,    
      //优先下载    
 SDWebImageHighPriority = 1 << 8,    
      //延迟占位符
     SDWebImageDelayPlaceholder = 1 << 9,    
      //改变动画形象  
   SDWebImageTransformAnimatedImage = 1 << 10,
　**1>SDWebImage的内部实现过程**

######1.入口 setImageWithURL:placeholderImage:options: 会先把 placeholderImage 显示，然后 SDWebImageManager 根据 URL 开始处理图片。

######2.进入 SDWebImageManager-downloadWithURL:delegate:options:userInfo:，交给 SDImageCache 从缓存查找图片是否已经下载 queryDiskCacheForKey:delegate:userInfo:.
######3.先从内存图片缓存查找是否有图片，如果内存中已经有图片缓存，SDImageCacheDelegate 回调 imageCache:didFindImage:forKey:userInfo: 到 SDWebImageManager。
######4.SDWebImageManagerDelegate 回调 webImageManager:didFinishWithImage: 到 UIImageView+WebCache 等前端展示图片。
######5.如果内存缓存中没有，生成 NSInvocationOperation 添加到队列开始从硬盘查找图片是否已经缓存。
######6.根据 URLKey 在硬盘缓存目录下尝试读取图片文件。这一步是在 NSOperation 进行的操作，所以回主线程进行结果回调 notifyDelegate:。
######7.如果上一操作从硬盘读取到了图片，将图片添加到内存缓存中（如果空闲内存过小，会先清空内存缓存）。SDImageCacheDelegate 回调 imageCache:didFindImage:forKey:userInfo:。进而回调展示图片。
######8.如果从硬盘缓存目录读取不到图片，说明所有缓存都不存在该图片，需要下载图片，回调 imageCache:didNotFindImageForKey:userInfo:。
######9.共享或重新生成一个下载器 SDWebImageDownloader 开始下载图片。
######10.图片下载由 NSURLConnection 来做，实现相关 delegate 来判断图片下载中、下载完成和下载失败。
######11.connection:didReceiveData: 中利用 ImageIO 做了按图片下载进度加载效果。
######12.connectionDidFinishLoading: 数据下载完成后交给 SDWebImageDecoder 做图片解码处理。
######13.图片解码处理在一个 NSOperationQueue 完成，不会拖慢主线程 UI。如果有需要对下载的图片进行二次处理，最好也在这里完成，效率会好很多。
######14.在主线程 notifyDelegateOnMainThreadWithInfo: 宣告解码完成，imageDecoder:didFinishDecodingImage:userInfo: 回调给 SDWebImageDownloader。
######15.imageDownloader:didFinishWithImage: 回调给 SDWebImageManager 告知图片下载完成。
######16.通知所有的 downloadDelegates 下载完成，回调给需要的地方展示图片。
######17.将图片保存到 SDImageCache 中，内存缓存和硬盘缓存同时保存。写文件到硬盘也在以单独 NSInvocationOperation 完成，避免拖慢主线程。
######18.SDImageCache 在初始化的时候会注册一些消息通知，在内存警告或退到后台的时候清理内存图片缓存，应用结束的时候清理过期图片。
######19.SDWI 也提供了 UIButton+WebCache 和 MKAnnotationView+WebCache，方便使用。
######20.SDWebImagePrefetcher 可以预先下载图片，方便后续使用。