SDWebImage的常用方法

SDWebImage的常用方法

1. 下载图片并显示

   • 同时做内存缓存和磁盘缓存

   • 图片加载结束之后, 在本地磁盘缓存会对图片名称进行一次MD5加密

   • 再图片加载完成之前, 可以使用placeholder来作为占位图片: 目前APP通用的方法

   • 弊端: 如果加载过多的图片, 会占用过多的内存, 因此要监听当前内存, 当内存占用过多主动释放

       [self.imageView sd_setImageWithURL:url placeholderImage:[UIImage imageNamed:@"baiduIcon.png""]];
     

2. 下载图片并计算下载进度

   • 使用UIImageView的分类下载, 下载后会自动设置给UIIMageView

   • 同时做内存缓存和磁盘缓存

   • 添加了进度回调和完成回调

     • 进度回调中可以监听到当前的下载进度, 可用于做一些指示性操作
     • 完成回调可以在图片下载完毕之后, 执行一些操作

   • options: 这个参数可以设置下载图片的策略(对优化程序很重要), 在下面详细介绍

       [self.imageView sd_setImageWithURL:url  placeholderImage:[UIImage imageNamed:@"baiduIcon.png"] options:SDWebImageProgressiveDownload progress:^(NSInteger receivedSize, NSInteger expectedSize) {
           // receivedSize: 已经下载的数据的大小
           // expectedSize: 图片的总大小
           NSLog(@"%f",1.0 * receivedSize/expectedSize);
     
       } completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {
       // 下载完成后会自动回到主线程
           NSLog(@"%@",[NSThread currentThread]);
           switch (cacheType) {
               case SDImageCacheTypeNone:
                   NSLog(@"直接下载, 不做缓存");
                   break;
               case SDImageCacheTypeDisk:
                   NSLog(@"磁盘缓存");
                   break;
               case SDImageCacheTypeMemory:
                   NSLog(@"内存缓存");
                   break;
               default:
                   break;
           }
       }];
     

     }

3. 使用SDWebImageManager单例下载

   • 同时做内存缓存和图片缓存

   • 可以监听下载进度

   • 下载图片后需要在Block回调中自行设置图片

       [[SDWebImageManager sharedManager] downloadImageWithURL:[NSURL URLWithString:@"http://www.baidubg.jpg"]
                                                      options:0
                                                      progress:^(NSInteger receivedSize, NSInteger expectedSize) {
                                                          NSLog(@"%f", 1.0 * receivedSize / expectedSize);
                                                      }
                                                      completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
                                                          // 设置图片
                                                          NSLog(@"%@", [NSThread currentThread]);
                                                          self.imageView.image = image;
                                                          NSLog(@"%@", [NSThread currentThread]);
                                                      }];
     

4. 使用SDWebImageDownloader类来下载

   • downloader类, 只负责下载图片, 并不会去做任何的缓存

   • 注意这里的Block回调, 是在子线程中进行的

       [[SDWebImageDownloader sharedDownloader] downloadImageWithURL:[NSURL URLWithString:@"http://www.baidubg.jpg"]
                                                            options:0
                                                            progress:^(NSInteger receivedSize, NSInteger expectedSize) {
                                                                NSLog(@"%f", 1.0 * receivedSize / expectedSize);
                                                            }
                                                            completed:^(UIImage *image, NSData *data, NSError *error, BOOL finished) {
                                                                
                                                                // 回到主线程中设置图片
                                                                dispatch_async(dispatch_get_main_queue(), ^{
                                                                    self.imageView.image = image;
                                                                });
                                                            }];
     

5. 加载GIF图片的方法

   • 该方法专用于加载GIF图片, 并且也会做缓存

   • 此方法为UIImage的分类

   • 注意他会对过大的图片进行一次压缩处理

   • 平时使用sd_setImgae..方法也可以加载GIF图片

       self.imageView.image = [UIImage sd_animatedGIFNamed:@"test"];
     

---

补充options的参数:

1. SDWebImageRetryFiled(失败重试)
   • SDWebImage在默认情况下, 如果某个URL失效无法下载, 那么SDWebImage就会将这个URL加入到一个黑名单中, 并且不会再次尝试去下载
2. SDWebImageLowPriority(低优先级)
   • 在默认情况下, 下载任务和UI交互之间, 是同时进行的; 如果选择这个设置, 那么系统会优先进行UI交互, 之后再去下载图片
3. SDWebImageCacheMemoryOnly(内存缓存)
   • 对于下载的图片, 只做内存缓存, 不做磁盘缓存(适用于一次展示类的图片)
4. SDWebImageProgressiveDownload(渐进式下载)
   • 默认情况下, 图片只有全部下载完成之后才可以显示; 这个设置可以让图片渐变式显示, 可以设置一些逐层刷新的效果
5. SDWebImageRefreshCached(重新缓存)
   • 此选项一般很少用, 算是一个诡异但是比较高级的用法, 笔者从来没用过.....
   • 该方法即使你的图片已经缓存到磁盘了, 但是还是会重新缓存图片, 主要用做对同一个URL资源, 加载的可能是不同的图片, 就需要使用此方法
6. SDWebImageContinueInBackground(后台加载)
   • 当你的App退出到后台时, 对于没有下载完成的下载任务, 会向系统额外请求一点时间继续下载图片, 但是如果系统分配的时间已到, 下载就会被取消.
   • 同上, 没用过, 因为我们应该尽量避免当App进入后台也要耗费流量的情况
7. SDWebImageHandleCookies(Cookies缓存)
   • 这个完全不知道怎么用, 应该是浏览器App使用的选项吧
8. SDWebImageAllowInvalidSSLCertificates(允许未信任的证书)
   • 可以在未被信任的证书网站中下载, 一般用于测试
9. SDWebImageHighPriority(高优先级)
   • 确保图片在第一时间被加载, 移动到队列最前方
   • 对于个别需要尽快展示给用户的图片, 使用此方法
10. SDWebImageDelayPlaceholder(推迟占位图片)
    • 默认情况下, 会先显示出占位图片, 然后再去加载图片
    • 此设置会先去加载图片, 加载完毕后再显示占位图片(诡异的用法)
11. SDWebImageTransformAnimatedImage(未使用过)
    • 没用过这个设置, 并且SDWebImage也不推荐使用
12. SDWebImageAvoidAutoSetImage(手动管理缓存)
    • 该设置会在加载图片完毕后, 在completion回调方法中, 由开发者自行处理图片缓存