目的
在使用SDWebImage加載圖片時掉盅,尤其是加載gif等大圖時云头,SDWebImage會將圖片緩存在內(nèi)存中酒请,這樣是非常吃內(nèi)存的,這時我們就需要在適當(dāng)?shù)臅r候去釋放一下SDWebImage的內(nèi)存緩存蔓纠,才不至于造成APP閃退辑畦。
SDWebImage 提供了 UIImageView、UIButton 腿倚、MKAnnotationView 的圖片下載分類纯出,只要一行代碼就可以實(shí)現(xiàn)圖片異步下載和緩存功能。
這樣開發(fā)者就無須花太多精力在圖片下載細(xì)節(jié)上,專心處理業(yè)務(wù)邏輯暂筝。
SDWebImage 特點(diǎn)
- 提供 UIImageView, UIButton, MKAnnotationView 的分類箩言,用來顯示網(wǎng)絡(luò)圖片,以及緩存管理
- 異步下載圖片
- 異步緩存(內(nèi)存+磁盤)焕襟,并且自動管理緩存有效性
- 后臺圖片解壓縮
- 同一個 URL 不會重復(fù)下載
- 自動識別無效 URL陨收,不會反復(fù)重試
- 不阻塞主線程
- 高性能
- 使用 GCD 和 ARC
- 支持多種圖片格式(包括 WebP 格式)
- 支持動圖(GIF)
- 4.0 之前的動圖效果并不是太好
- 4.0 以后基于 FLAnimatedImage加載動圖
注:本文選讀的代碼是 3.7.3 版本的,所以動圖加載還不支持 FLAnimatedImage鸵赖。
SDWebImage 使用
1. UITableView 中使用 UIImageView+WebCache
[cell.imageView sd_setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"] placeholderImage:[UIImage imageNamed:@"placeholder.png"]];
2. 使用回調(diào) blocks
在 block 中得到圖片下載進(jìn)度和圖片加載完成(下載完成或者讀取緩存)的回調(diào)务漩,如果你在圖片加載完成前取消了請求操作,就不會收到成功或失敗的回調(diào)
[cell.imageView sd_setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"]
placeholderImage:[UIImage imageNamed:@"placeholder.png"]
completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {
... completion code here ...
}];
3. SDWebImageManager 的使用
UIImageView(WebCache) 分類的核心在于 SDWebImageManager 的下載和緩存處理它褪,SDWebImageManager將圖片下載和圖片緩存組合起來了饵骨。SDWebImageManager也可以單獨(dú)使用。
SDWebImageManager *manager = [SDWebImageManager sharedManager];
[manager loadImageWithURL:imageURL
options:0
progress:^(NSInteger receivedSize, NSInteger expectedSize) {
// progression tracking code
}
completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
if (image) {
// do something with image
}
}];
4. 單獨(dú)使用 SDWebImageDownloader 異步下載圖片
我們還可以單獨(dú)使用 SDWebImageDownloader 來下載圖片茫打,但是圖片內(nèi)容不會緩存居触。
SDWebImageDownloader *downloader = [SDWebImageDownloader sharedDownloader];
[downloader 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
}
}];
5. 單獨(dú)使用 SDImageCache 異步緩存圖片
SDImageCache 支持內(nèi)存緩存和異步的磁盤緩存(可選),如果你想單獨(dú)使用 SDImageCache 來緩存數(shù)據(jù)的話包吝,可以使用單例,也可以創(chuàng)建一個有獨(dú)立命名空間的 SDImageCache 實(shí)例源葫。
添加緩存的方法:
[[SDImageCache sharedImageCache] storeImage:myImage forKey:myCacheKey];
默認(rèn)情況下诗越,圖片數(shù)據(jù)會同時緩存到內(nèi)存和磁盤中,如果你想只要內(nèi)存緩存的話息堂,可以使用下面的方法:
[[SDImageCache sharedImageCache] storeImage:myImage forKey:myCacheKey toDisk:NO];
讀取緩存時可以使用 queryDiskCacheForKey:done: 方法嚷狞,圖片緩存的 key 是唯一的,通常就是圖片的 absolute URL荣堰。
SDImageCache *imageCache = [[SDImageCache alloc] initWithNamespace:@"myNamespace"];
[imageCache queryDiskCacheForKey:myCacheKey done:^(UIImage *image) {
// image is not nil if image was found
}];
6. 自定義緩存 key
有時候床未,一張圖片的 URL 中的一部分可能是動態(tài)變化的(比如獲取權(quán)限上的限制),所以我們只需要把 URL 中不變的部分作為緩存用的 key振坚。
SDWebImageManager.sharedManager.cacheKeyFilter = ^(NSURL *url) {
url = [[NSURL alloc] initWithScheme:url.scheme host:url.host path:url.path];
return [url absoluteString];
};
常見問題
- 問題 1:使用 UITableViewCell 中的 imageView 加載不同尺寸的網(wǎng)絡(luò)圖片時會出現(xiàn)尺寸縮放問題薇搁。
解決方案:
自定義 UITableViewCell,重寫 -layoutSubviews 方法渡八,調(diào)整位置尺寸啃洋;
或者直接棄用 UITableViewCell 的 imageView,自己添加一個 imageView 作為子控件屎鳍。
- 問題 2:圖片刷新問題:SDWebImage 在進(jìn)行緩存時忽略了所有服務(wù)器返回的 caching control 設(shè)置宏娄,并且在緩存時沒有做時間限制,這也就意味著圖片 URL 必須是靜態(tài)的了逮壁,要求服務(wù)器上一個 URL 對應(yīng)的圖片內(nèi)容不允許更新孵坚。但是如果存儲圖片的服務(wù)器不由自己控制,也就是說 圖片內(nèi)容更新了,URL 卻沒有更新卖宠,這種情況怎么辦巍杈?
解決方案:在調(diào)用 sd_setImageWithURL: placeholderImage: options:方法時設(shè)置 options 參數(shù)為 SDWebImageRefreshCached,這樣雖然會降低性能逗堵,但是下載圖片時會照顧到服務(wù)器返回的 caching control秉氧。
- 問題 3:在加載圖片時,如何添加默認(rèn)的 progress indicator 蜒秤?
解決方案:在調(diào)用 -sd_setImageWithURL:方法之前汁咏,先調(diào)用下面的方法:
[imageView sd_setShowActivityIndicatorView:YES];
[imageView sd_setIndicatorStyle:UIActivityIndicatorViewStyleGray];