標籤:
第一步,下載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(@"下載完成"); }]; |
iOS之SDWebImage的使用