SDWebImage的使用詳解

2019-11-09 17:41:25

字體：大中小

來源：轉載

供稿：網友

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

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

1	`#import "UIImageView+WebCache.h"`

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

1. sd_setImageWithURL：

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

2. sd_setImageWithURL: completed:

123456 //用block 可以在圖片加載完成之后做些事情 [self.image2 sd_setImageWithURL:imagePath2 completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) { NSLog(@"這里可以在圖片加載完成之后做些事情"); }];

3. sd_setImageWithURL: placeholderImage:

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

4. sd_setImageWithURL: placeholderImage: completed:

123456 //使用默認圖片，而且用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:

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

其他就不一一介紹了，oc是自文檔語言，看方法名就知道干什么的了。除了帶options選項的方法，其他的方法都是綜合存儲，也就是內存緩存和磁盤緩存結合的方式，如果你只需要內存緩存，那么在options這里選擇SDWebImageCacheMemoryOnly就可以了。

如果不想深入了解，到這里你已經可以用SDWebimage進行圖片緩存了，接下來我要解釋options的所有選項，以及SDWebImage內部執行流程。

一、options所有選項：

123456789101112131415161718192021222324252627282930313233 　　//失敗后重試 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內部實現過程

入口 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:方法的時候，他會自動去給你干這么多事，當你需要在某一具體時刻做事情的時候，你可以覆蓋這些方法。比如在下載某個圖片的過程中要響應一個事件，就覆蓋這個方法：

1234567891011 //覆蓋方法，指哪打哪，這個方法是下載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(@"下載完成"); }];