iOS_SDWebImage框架分析

时间 2019-12-01

原文原文链接

SDWebImage 支持异步的图片下载+缓存，提供了 UIImageView+WebCacha 的 category，方便使用。使用SDWebImage首先了解它加载图片的流程。

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

SDWebImage的案例1：在tableView中使用SDWebImage

#import <SDWebImage/UIImageView+WebCache.h>

...

- (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath
{
    static NSString *MyIdentifier = @"MyIdentifier";

    UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:MyIdentifier];

    if (cell == nil)
    {
        cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault
                                       reuseIdentifier:MyIdentifier] autorelease];
    }

    // Here we use the new provided sd_setImageWithURL: method to load the web image
    [cell.imageView sd_setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"]
                      placeholderImage:[UIImage imageNamed:@"placeholder.png"]];
　　
    cell.textLabel.text = @"My Text";
    return cell;
}

The SDWebImageManager is the class behind the UIImageView+WebCache category. It ties the asynchronous downloader with the image cache store. You can use this class directly to benefit from web image downloading with caching in another context than a UIView (ie: with Cocoa).前端

 NSURL *url = [NSURL URLWithString:@"http://127.0.0.1/userManager/0.png"];
    //SDWebImageManager管理器继承与UIImageView+WedCache。已异步的方式进行下载图片到缓冲区。
    SDWebImageManager *manager = [SDWebImageManager sharedManager];
    [manager downloadImageWithURL:url options:0 progress:^(NSInteger receivedSize, NSInteger expectedSize) {
        NSLog(@"%ld,%ld",receivedSize,expectedSize);
    }
    completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
        //为imageView设置图片为下载的图片
        [self.imageView setImage:image];
        //打印图片的来源
        NSLog(@"%@",imageURL);
    }];

It's also possible to use the async image downloader independently:web

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

在本身的案例中使用SDWebImage代码段：缓存

添加自定义的只读缓存路径，其中这是可选的，若是没有指定，系统会默认
#import "SDWebImage/SDImageCache.h"
#import "AppDelegate.h"
......
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
//添加自定义的只读缓存路径：可选的
    NSString *bundledPath = [[[NSBundle mainBundle] resourcePath] stringByAppendingPathComponent:@"CustomPathImages"];
    [[SDImageCache sharedImageCache] addReadOnlyCachePath:bundledPath];
    ......    
}

在使用缓存时，若是内存不够使用时，须要进行清理以释放内存。app

#import "MasterViewController.h"
#import "SDWebImage/UIImageView+WebCache.h"
......
//清理缓存，
- (void)flushCache
{
    /**
     *  一、SDImageCache是怎么作数据管理的?
     SDImageCache分两个部分，一个是内存层面的，一个是硬盘层面的。
     内存层面的至关是个缓存器，以Key-Value的形式存储图片。
     */
    //清理内存缓存
    [SDWebImageManager.sharedManager.imageCache clearMemory];
    //清理硬盘缓存
    [SDWebImageManager.sharedManager.imageCache clearDisk];
}
//支持屏幕旋转
- (BOOL)shouldAutorotateToInterfaceOrientation:(UIInterfaceOrientation)interfaceOrientation
{
    return (interfaceOrientation != UIInterfaceOrientationPortraitUpsideDown);
}
......

//为了显示大图片，替将链接中small替换成source;dom

NSString *largeImageURL = [[_objects objectAtIndex:indexPath.row] stringByReplacingOccurrencesOfString:@"small" withString:@"source"];异步

......async

仪表器的使用方法。ide

#import "DetailViewController.h"
#import "SDWebImage/UIImageView+WebCache.h"
......
- (void)configureView
{
    if (self.imageURL) {
        //建立仪表器
        __block UIActivityIndicatorView *activityIndicator;
        //为防止循环引用问题，因此在block中使用imageView时要设置成弱引用，imageView中使用block，在block中若是再调用imageView时，不设置为弱引用，会出现循环引用问题。
        __weak UIImageView *weakImageView = self.imageView;
        [self.imageView sd_setImageWithURL:self.imageURL
                          placeholderImage:nil
                                   options:SDWebImageProgressiveDownload
                                  progress:^(NSInteger receivedSize, NSInteger expectedSize) {
                                      //检测是否已经存在啦！，若是没有在新建立出一个
                                      if (!activityIndicator) {
                                          //将新建立的仪表器添加到imageView视图中
                                          [weakImageView addSubview:activityIndicator = [UIActivityIndicatorView.alloc initWithActivityIndicatorStyle:UIActivityIndicatorViewStyleGray]];
                                          activityIndicator.center = weakImageView.center;
                                          //开启动画，转吧！小宇宙
                                          [activityIndicator startAnimating];
                                      }
                                  }
                                 completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL){
                                     //将仪表器从imageView视图中进行删除
                                     [activityIndicator removeFromSuperview];
                                     activityIndicator = nil;
                                 }];
    }
}
......

在Cell中使用异步图片下载。函数

#import "MasterViewController.h"
#import "SDWebImage/UIImageView+WebCache.h"
......
/**
     *  参数解析：
        1.获取图片的路径
        2.设置占位图片
        3.options选项：当indexPath.row为0时，执行 SDWebImageRefreshCached：刷新缓存
     */
    [cell.imageView sd_setImageWithURL:[NSURL URLWithString:[_objects objectAtIndex:indexPath.row]]
                      placeholderImage:[UIImage imageNamed:@"placeholder"] options:indexPath.row == 0 ? SDWebImageRefreshCached : 0];
......

在上段代码中，有以下两行代码： fetch

__weak UIImageView *weakImageView = self.imageView;

__block UIActivityIndicatorView *activityIndicator;

其中第一条为了不循环引用问题，加上了__weak,第二条使用了block。如今补充一下循环引用、block的知识点：

循环引用
　　全部的引用计数系统，都存在循环应用的问题。例以下面的引用关系：
     1）对象a建立并引用到了对象b.
     2）对象b建立并引用到了对象c.
     3）对象c建立并引用到了对象b.
　　这时候b和c的引用计数分别是2和1。当a再也不使用b，调用release释放对b的全部权，由于c还引用了b，因此b的引用计数为1，

　　b不会被释放。b不释放，c的引用计数就是1，c也不会被释放。今后，b和c永远留在内存中。这种状况，必须打断循环引用

　　经过其余规则来维护引用关系。好比，咱们常见的delegate每每是assign方式的属性而不是retain方式的属性，

　　赋值不会增长引用计数，就是为了防止delegation两端产生没必要要的循环引用。若是一个UITableViewController对象a

　　经过retain获取了UITableView对象b的全部权，这个UITableView对象b的delegate又是a，若是这个delegate是retain方式的，

　　那基本上就没有机会释放这两个对象了。本身在设计使用delegate模式时，也要注意这点。

Block

　　是能够获取其余函数局部变量的匿名函数，其不但方便开发，而且能够大幅提升应用的执行效率(多核心CPU可直接处理Block指令),若是但愿进行修改局部变量的值，能够在定义局部变量以前使用__block。