SDWebImage 的簡單使用方法


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

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

1
#import   "UIImageView+WebCache.h"

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

1. sd_setImageWithURL:

  

  

  //圖片緩存的基本代碼,就是這么簡單

  

    [self.image1   sd_setImageWithURL:imagePath1];

2. sd_setImageWithURL:   completed:

  

  

//用block   可以在圖片加載完成之后做些事情

  

     [self.image2   sd_setImageWithURL:imagePath2   completed:^(UIImage   *image,   NSError   *error,   SDImageCacheType   cacheType,   NSURL   *imageURL)   {

      NSLog(@"這里可以在圖片加載完成之后做些事情");          

    }];

3. sd_setImageWithURL:   placeholderImage:

  

  

//給一張默認圖片,先使用默認圖片,當圖片加載完成后再替換

      [self.image1   sd_setImageWithURL:imagePath1   placeholderImage:[UIImage   imageNamed:@"default"]];

  

4. sd_setImageWithURL:   placeholderImage:   completed:

  

  

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

  

  

//options   選擇方式       

    [self.image1   sd_setImageWithURL:imagePath1   placeholderImage:[UIImage   imageNamed:@"default"]   options:SDWebImageRetryFailed];

  

除了帶options選項的方法,其他的方法都是綜合存儲,也就是內存緩存和磁盤緩存結合的方式,如果你只需要內存緩存,那么在options這里選擇SDWebImageCacheMemoryOnly就可以了。  

一、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,
  

二、SDWebImage內部實現過程

  1. 入口 setImageWithURL:placeholderImage:options: 會先把 placeholderImage 顯示,然后 SDWebImageManager 根據 URL 開始處理圖片。

  2. 進入 SDWebImageManager-downloadWithURL:delegate:options:userInfo:,交給 SDImageCache 從緩存查找圖片是否已經下載 queryDiskCacheForKey:delegate:userInfo:.

  3. 先從內存圖片緩存查找是否有圖片,如果內存中已經有圖片緩存,SDImageCacheDelegate 回調 imageCache:didFindImage:forKey:userInfo: 到 SDWebImageManager。

  4. SDWebImageManagerDelegate 回調 webImageManager:didFinishWithImage: 到 UIImageView+WebCache 等前端展示圖片。

  5. 如果內存緩存中沒有,生成 NSInvocationOperation 添加到隊列開始從硬盤查找圖片是否已經緩存。

  6. 根據 URLKey 在硬盤緩存目錄下嘗試讀取圖片文件。這一步是在 NSOperation 進行的操作,所以回主線程進行結果回調 notifyDelegate:。

  7. 如果上一操作從硬盤讀取到了圖片,將圖片添加到內存緩存中(如果空閑內存過小,會先清空內存緩存)。SDImageCacheDelegate 回調 imageCache:didFindImage:forKey:userInfo:。進而回調展示圖片。

  8. 如果從硬盤緩存目錄讀取不到圖片,說明所有緩存都不存在該圖片,需要下載圖片,回調 imageCache:didNotFindImageForKey:userInfo:。

  9. 共享或重新生成一個下載器 SDWebImageDownloader 開始下載圖片。

  10. 圖片下載由 NSURLConnection 來做,實現相關 delegate 來判斷圖片下載中、下載完成和下載失敗。

  11. connection:didReceiveData: 中利用 ImageIO 做了按圖片下載進度加載效果。

  12. connectionDidFinishLoading: 數據下載完成后交給 SDWebImageDecoder 做圖片解碼處理。

  13. 圖片解碼處理在一個 NSOperationQueue 完成,不會拖慢主線程 UI。如果有需要對下載的圖片進行二次處理,最好也在這里完成,效率會好很多。

  14. 在主線程 notifyDelegateOnMainThreadWithInfo: 宣告解碼完成,imageDecoder:didFinishDecodingImage:userInfo: 回調給 SDWebImageDownloader。

  15. imageDownloader:didFinishWithImage: 回調給 SDWebImageManager 告知圖片下載完成。

  16. 通知所有的 downloadDelegates 下載完成,回調給需要的地方展示圖片。

  17. 將圖片保存到 SDImageCache 中,內存緩存和硬盤緩存同時保存。寫文件到硬盤也在以單獨 NSInvocationOperation 完成,避免拖慢主線程。

  18. SDImageCache 在初始化的時候會注冊一些消息通知,在內存警告或退到后台的時候清理內存圖片緩存,應用結束的時候清理過期圖片。

  19. SDWI 也提供了 UIButton+WebCache 和 MKAnnotationView+WebCache,方便使用。

  20. 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:的若干個方法就可以實現很好的圖片緩存。

 


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM