最新版SDWebImage的使用

第一步，下载SDWebImage，导入工程。github托管地址https://github.com/rs/SDWebImage

第二步，在需要的地方导入头文件

1	#import "UIImageView+WebCache.h"

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

1. sd_setImageWithURL：

1 2	//图片缓存的基本代码，就是这么简单      [self.image1 sd_setImageWithURL:imagePath1];

2. sd_setImageWithURL:  completed:

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

     [self.image2 sd_setImageWithURL:imagePath2 completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {

         

         NSLog(@ "这里可以在图片加载完成之后做些事情" );

         

     }];

3. sd_setImageWithURL:  placeholderImage:

1 2	//给一张默认图片，先使用默认图片，当图片加载完成后再替换      [self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@ "default" ]];

4. sd_setImageWithURL:  placeholderImage:  completed:

1 2 3 4 5 6

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

5. sd_setImageWithURL:  placeholderImage:  options:

1 2 3

//options 选择方式            [self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@ "default" ] options:SDWebImageRetryFailed];

其他就不一一介绍了，oc是自文档语言，看方法名就知道干什么的了。除了带options选项的方法，其他的方法都是综合存储，也就是内存缓存和磁盘缓存结合的方式，如果你只需要内存缓存，那么在options这里选择SDWebImageCacheMemoryOnly就可以了。

如果不想深入了解，到这里你已经可以用SDWebimage进行图片缓存了，接下来我要解释options的所有选项，以及SDWebImage内部执行流程。

一、options所有选项：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33

//失败后重试       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,

二、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 可以预先下载图片，方便后续使用。

从上面流程可以看出，当你调用setImageWithURL:方法的时候，他会自动去给你干这么多事，当你需要在某一具体时刻做事情的时候，你可以覆盖这些方法。比如在下载某个图片的过程中要响应一个事件，就覆盖这个方法：

1 2 3 4 5 6 7 8 9 10 11

//覆盖方法，指哪打哪，这个方法是下载imagePath2的时候响应      SDWebImageManager *manager = [SDWebImageManager sharedManager];            [manager downloadImageWithURL:imagePath2 options:SDWebImageRetryFailed progress:^(NSInteger receivedSize, NSInteger expectedSize) {                    NSLog(@ "显示当前进度" );                } completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {                    NSLog(@ "下载完成" );      }];

对于初级来说，用sd_setImageWithURL:的若干个方法就可以实现很好的图片缓存。

加载网络图片可以说是网络应用中必备的。如果单纯的去下载图片，而不去做多线程、缓存等技术去优化，加载图片时的效果与用户体验就会很差。

一、自己实现加载图片的方法

tips：

* iOS 中所有网络访问都是异步的 .( 自己 开线程去下载 )

* 普通 为 模型 增加 UIImage 属性 的方法做的是 内存缓存 ( 下次启动还需要从网络重新加载 ) ,  而要做本地缓存的话 , 还要自己手动 存储网络上下载的图片 .

* 为了加快访问 ,  还需要自己去弄 缓存 . ( 内存缓存或者本地缓存 )

* 当图片没有下载完成时，还要设置 占位图片 。

以下代码用NSOperation开异步线程下载图片，当下载完成时替换占位图片。

[objc]  view plain copy

1. //  
2. //  XNViewController.m  
3. //  加载网络图片, 普通的用NSOperation来做.  
4. //  
5. //  Created by neng on 14-7-7.  
6. //  Copyright (c) 2014年 neng. All rights reserved.  
7. //  
8.   
9. #import "XNViewController.h"  
10. #import "XNApp.h"  
11.   
12. @interface XNViewController ()  
13. @property (nonatomic, strong) NSArray *appList;  
14. @property (nonatomic, strong) NSOperationQueue *queue;  
15. @end  
16.   
17. @implementation XNViewController  
18. #pragma mark - 懒加载  
19.   
20. - (NSOperationQueue *)queue {  
21.     if (!_queue) _queue = [[NSOperationQueue alloc] init];  
22.     return _queue;  
23. }  
24.   
25. //可抽取出来写到模型中  
26. - (NSArray *)appList {  
27.     if (!_appList) {  
28.         //1.加载plist到数组中  
29.         NSURL *url = [[NSBundle mainBundle] URLForResource:@"apps.plist" withExtension:nil];  
30.         NSArray *array = [NSArray arrayWithContentsOfURL:url];  
31.         //2.遍历数组  
32.         NSMutableArray *arrayM = [NSMutableArray array];  
33.         [array enumerateObjectsUsingBlock: ^(id obj, NSUInteger idx, BOOLBOOL *stop) {  
34.             [arrayM addObject:[XNApp appWithDict:obj]];  //数组中存放的是字典, 转换为app对象后再添加到数组  
35.         }];  
36.         _appList = [arrayM copy];  
37.     }  
38.     return _appList;  
39. }  
40.   
41. - (void)viewDidLoad {  
42.     [super viewDidLoad];  
43.   
44.     self.tableView.rowHeight = 88;  
45.   
46. //    NSLog(@"appList-%@",_appList);  
47. }  
48.   
49. #pragma mark - 数据源方法  
50. - (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {  
51.     return self.appList.count;  
52. }  
53.   
54. - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {  
55.     static NSString *ID = @"Cell";  
56.     UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:ID];  
57.   
58.     //用模型来填充每个cell  
59.     XNApp *app = self.appList[indexPath.row];  
60.     cell.textLabel.text = app.name;  //设置文字  
61.   
62.     //设置图像: 模型中图像为nil时用默认图像,并下载图像. 否则用模型中的内存缓存图像.  
63.     if (!app.image) {  
64.         cell.imageView.image = [UIImage imageNamed:@"user_default"];  
65.   
66.         [self downloadImg:indexPath];  
67.     }  
68.     else {  
69.         //直接用模型中的内存缓存  
70.         cell.imageView.image = app.image;  
71.     }  
72. //  NSLog(@"cell--%p", cell);  
73.   
74.     return cell;  
75. }  
76.   
77. /**始终记住, 通过模型来修改显示. 而不要试图直接修改显示*/  
78. - (void)downloadImg:(NSIndexPath *)indexPath {  
79.     XNApp *app  = self.appList[indexPath.row]; //取得改行对应的模型  
80.   
81.     [self.queue addOperationWithBlock: ^{  
82.         NSData *imgData = [NSData dataWithContentsOfURL:[NSURL URLWithString:app.icon]]; //得到图像数据  
83.         UIImage *image = [UIImage imageWithData:imgData];  
84.   
85.         //在主线程中更新UI  
86.         [[NSOperationQueue mainQueue] addOperationWithBlock: ^{  
87.             //通过修改模型, 来修改数据  
88.             app.image = image;  
89.             //刷新指定表格行  
90.             [self.tableView reloadRowsAtIndexPaths:@[indexPath] withRowAnimation:UITableViewRowAnimationNone];  
91.         }];  
92.     }];  
93. }  
94.   
95. @end  

上述代码只是做了内存缓存，而每次重新进入应用时，还会从网上重新下载。如果要继续优化上面的代码，需要自己去实现本地缓存。

二、使用第三方框架SDWebImage。（非常优秀）

* 特点  : 依赖的库很少 .功能全面。

* 自动实现 磁盘缓存 :

* 缓存图片名字是以 MD5 进行加密的 后的名字进行命名 .( 因为加密那堆字串是唯一的 )

* [imageView sd_setImageWithURL :v.fullImageURL   placeholderImage:[UIImage   imageNamed:@”xxxxx”]].

* 就一个方法就实现了 多线程 \ 带缓冲等效 果 . ( 可用带参数的方法 , 具体可看头文件 )

用SDWebImage修改上面的方法后的代码可简化为：

[objc]  view plain copy

1. #pragma mark - 数据源方法  
2. - (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {  
3.     return self.appList.count;  
4. }  
5.   
6. - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath {  
7.     static NSString *ID = @"Cell";  
8.     UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:ID];  
9.   
10.     //用模型来填充每个cell  
11.     XNApp *app = self.appList[indexPath.row];  
12.     cell.textLabel.text = app.name;  //设置文字  
13.   
14. //  //设置图像: 模型中图像为nil时用默认图像,并下载图像. 否则用模型中的内存缓存图像.  
15. //  if (!cell.imageView.image) {  
16. //      cell.imageView.image = [UIImage imageNamed:@"user_default"];  
17. //  
18. //      [self downloadImg:indexPath];  
19. //  }  
20. //  else {  
21. //      //直接用模型中的内存缓存  
22. //      cell.imageView.image = app.image;  
23. //  }  
24.   
25.   
26.     //使用SDWebImage来完成上面的功能. 针对ImageView.  
27.     //一句话, 自动实现了异步下载. 图片本地缓存. 网络下载. 自动设置占位符.  
28.     [cell.imageView sd_setImageWithURL:[NSURL URLWithString:app.icon] 
29.                       placeholderImage:[UIImage imageNamed:@"user_default"]];  
30.   
31.   
32.     return cell;  
33. }  
34.   
35. /**始终记住, 通过模型来修改显示. 而不要试图直接修改显示*/  
36. //- (void)downloadImg:(NSIndexPath *)indexPath {  
37. //  XNApp *app  = self.appList[indexPath.row]; //取得改行对应的模型  
38. //  
39. //  [self.queue addOperationWithBlock: ^{  
40. //      NSData *imgData = [NSData dataWithContentsOfURL:[NSURL URLWithString:app.icon]]; //得到图像数据  
41. //      UIImage *image = [UIImage imageWithData:imgData];  
42. //  
43. //      //在主线程中更新UI  
44. //      [[NSOperationQueue mainQueue] addOperationWithBlock: ^{  
45. //          //通过修改模型, 来修改数据  
46. //          app.image = image;  
47. //          //刷新指定表格行  
48. //          [self.tableView reloadRowsAtIndexPaths:@[indexPath] 
49.                    withRowAnimation:UITableViewRowAnimationNone];  
50. //      }];  
51. //  }];  
52. //}  
53.   
54. @end  

SDWebImage中的一些参数：

* SDWebImageRetryFailed = 1<< 0,    默认选项，失败后重试

* SDWebImageLowPriority = 1<< 1,     使用低优先级

* SDWebImageCacheMemoryOnly = 1<< 2,    仅仅使用内存缓存

* SDWebImageProgressiveDownload = 1<< 3,    显示现在进度

* SDWebImageRefreshCached = 1<< 4,     刷新缓存

* SDWebImageContinueInBackground =1 << 5,    后台继续下载图像

* SDWebImageHandleCookies = 1<< 6,     处理 Cookie

* SDWebImageAllowInvalidSSLCertificates= 1 << 7,     允许无效的 SSL 验证

* SDWebImageHighPriority = 1<< 8,      高优先级

* SDWebImageDelayPlaceholder = 1<< 9      延迟显示占位图片