最新版SDWebImage的使用

轉載自http://www.cocoachina.com/ios/20141212/10622.html

我以前寫過一篇博客，介紹緩存處理的三種方式，其中最難，最麻煩，最佔內存資源的仍是圖片緩存，最近作的項目有大量的圖片處理，仍是採用了SDWebImage來處理，可是發現以前封裝好的代碼報錯了。研究發現，是我用了新版的SDWebImage，好多方法都變了。

如今把代碼貼出來，供你們參考。尤爲是新手，看完這篇博客，圖片緩存so easy。最後有demo供你們下載，先學習。

第一步，下載SDWebImage，導入工程。github託管地址https://github.com/rs/SDWebImage

第二步，在須要的地方導入頭文件

#import "UIImageView+WebCache.h"

第三步，調用sd_setImageWithURL：方法緩存圖片，注意，這就是新版本的新方法，舊方法是setImageWithURL:。下面將幾個方法都介紹一下。

1. sd_setImageWithURL：

//圖片緩存的基本代碼，就是這麼簡單
[self.image1 sd_setImageWithURL:imagePath1];

1. sd_setImageWithURL: completed:

//用block 能夠在圖片加載完成以後作些事情
[self.image2 sd_setImageWithURL:imagePath2 completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {

        NSLog(@"這裏能夠在圖片加載完成以後作些事情");

    }];

1. sd_setImageWithURL: placeholderImage:

//給一張默認圖片，先使用默認圖片，當圖片加載完成後再替換
[self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@"default"]];

1. sd_setImageWithURL: placeholderImage: completed:

//使用默認圖片，並且用block 在完成後作一些事情
[self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@"default"] completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {

        NSLog(@"圖片加載完成後作的事情");

    }];

1. sd_setImageWithURL: placeholderImage: options:

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

其餘就不一一介紹了，oc是自文檔語言，看方法名就知道幹什麼的了。除了帶options選項的方法，其餘的方法都是綜合存儲，也就是內存緩存和磁盤緩存結合的方式，若是你只須要內存緩存，那麼在options這裏選擇SDWebImageCacheMemoryOnly就能夠了。

若是不想深刻了解，到這裏你已經能夠用SDWebimage進行圖片緩存了，接下來我要解釋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,

2、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 能夠預先下載圖片，方便後續使用。
從上面流程能夠看出，當你調用setImageWithURL:方法的時候，他會自動去給你幹這麼多事，當你須要在某一具體時刻作事情的時候，你能夠覆蓋這些方法。好比在下載某個圖片的過程當中要響應一個事件，就覆蓋這個方法：

//覆蓋方法，指哪打哪，這個方法是下載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:的若干個方法就能夠實現很好的圖片緩存。