SDWebImage 是 iOS 上最流行的異步圖片加載庫之一。本文從特性、類結構到源碼實現,帶你徹底理解它的緩存與下載機制。
項目地址:https://github.com/rs/SDWebImage。它是一個專注於異步圖片下載與緩存的庫,主要特性包括:UIImageView 分類支持網絡圖片加載與緩存、異步下載與自動過期管理、支持 GIF 與 WebP、背景圖片減壓、保證同一 URL 不重複下載、保證無效 URL 不重載、保證主線程不死鎖,並使用 GCD 與 ARC、支持 ARM64。
值得注意的是,3.0 之後不再支持 iOS 5.1.1,同時支持 Cocoapods。
只要有圖片 URL 就能下載,而 SDWebImage 的價值在於緩存機制:取圖時先查內存、再查磁盤緩存,命中就直接加載,都找不到才重新下載。無效 URL 會被記錄下來避免重試,下載到的圖片則會被緩存以供下次使用。整個下載、解碼、轉換過程都在後台異步進行,不阻塞主線程。
SDImageCache
設置緩存類型、方式、路徑等。
SDWebImageCompat
兼容類,定義大量宏與一個圖片轉換方法。
SDWebImageDecoder
解碼器,負責圖片色彩空間轉換。
SDWebImageDownloader
下載器,需配合 SDWebImageDownloaderOperation。
SDWebImageManager
管理圖片下載、取消、緩存判斷等。
SDWebImagePrefetcher
預抓取器,預先下載一批圖片。
UIImageView+WebCache
最常用的分類,負責加載並緩存 UIImageView 的圖片。
只定義了 SDWebImageOperation 協議,內部僅有一個 cancel 方法,後續很多類都會用到。
@protocol SDWebImageOperation <NSObject> - (void)cancel; @end
透過讀取圖片文件頭字節、對比十六進制標識來判斷類型:
+ (NSString *)sd_contentTypeForImageData:(NSData *)data {
uint8_t c;
[data getBytes:&c length:1];
switch (c) {
case 0xFF: return @"image/jpeg";
case 0x89: return @"image/png";
case 0x47: return @"image/gif";
case 0x49: case 0x4D: return @"image/tiff";
case 0x52: // R as RIFF for WEBP
if ([data length] < 12) { return nil; }
NSString *testString = [[NSString alloc] initWithData:[data subdataWithRange:NSMakeRange(0, 12)] encoding:NSASCIIStringEncoding];
if ([testString hasPrefix:@"RIFF"] && [testString hasSuffix:@"WEBP"]) { return @"image/webp"; }
return nil;
}
return nil;
}
內聯方法中根據 key 是否含 @2x、@3x 決定 scale,再縮放圖片:
CGFloat scale = [UIScreen mainScreen].scale;
if (key.length >= 8) {
NSRange range = [key rangeOfString:@"@2x."];
if (range.location != NSNotFound) { scale = 2.0; }
range = [key rangeOfString:@"@3x."];
if (range.location != NSNotFound) { scale = 3.0; }
}
UIImage *scaledImage = [[UIImage alloc] initWithCGImage:image.CGImage scale:scale orientation:image.imageOrientation];
image = scaledImage;
先獲取圖片 alpha 信息,若符合蘋果定義的 CGImageAlphaInfo 則直接返回原圖;否則檢查 color space,不支持就轉為 RGB,再重繪並釋放 CG 指針:
CGImageRef imageRef = image.CGImage;
CGImageAlphaInfo alpha = CGImageGetAlphaInfo(imageRef);
BOOL anyAlpha = (alpha == kCGImageAlphaFirst || alpha == kCGImageAlphaLast || alpha == kCGImageAlphaPremultipliedFirst || alpha == kCGImageAlphaPremultipliedLast);
if (anyAlpha) { return image; }
整個庫的核心之一,用 runtime 關聯對象存儲各 key 對應的操作。設置關聯與取出的基本方法:
void objc_setAssociatedObject(id object, const void *key, id value, objc_AssociationPolicy policy) id objc_getAssociatedObject(id object, const void *key)
加載、取消、移除三種操作都基於一個 operationDictionary:
- (NSMutableDictionary *)operationDictionary {
NSMutableDictionary *operations = objc_getAssociatedObject(self, &loadOperationKey);
if (operations) { return operations; }
operations = [NSMutableDictionary dictionary];
objc_setAssociatedObject(self, &loadOperationKey, operations, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
return operations;
}
下載器初始化時設置最大併發數、超時時間、HTTP 請求頭等:
- (id)init {
if ((self = [super init])) {
_operationClass = [SDWebImageDownloaderOperation class];
_shouldDecompressImages = YES;
_executionOrder = SDWebImageDownloaderFIFOExecutionOrder;
_downloadQueue = [NSOperationQueue new];
_downloadQueue.maxConcurrentOperationCount = 6;
_URLCallbacks = [NSMutableDictionary new];
#ifdef SD_WEBP
_HTTPHeaders = [@{@"Accept": @"image/webp,image/*;q=0.8"} mutableCopy];
#else
_HTTPHeaders = [@{@"Accept": @"image/*;q=0.8"} mutableCopy];
#endif
_barrierQueue = dispatch_queue_create("com.hackemist.SDWebImageDownloaderBarrierQueue", DISPATCH_QUEUE_CONCURRENT);
_downloadTimeout = 15.0;
}
return self;
}
管理器用位運算定義了豐富的 SDWebImageOptions,如 RetryFailed、LowPriority、CacheMemoryOnly、ProgressiveDownload、RefreshCached 等,控制下載與緩存的各種行為。核心方法是 downloadImageWithURL:options:progress:completed:,負責協調緩存判斷與下載。
預抓取器先取消再重新開始,按最大併發數批量預下載:
- (void)prefetchURLs:(NSArray *)urls progress:(SDWebImagePrefetcherProgressBlock)progressBlock completed:(SDWebImagePrefetcherCompletionBlock)completionBlock {
[self cancelPrefetching]; // 防止重複請求
self.startedTime = CFAbsoluteTimeGetCurrent();
self.prefetchURLs = urls;
self.completionBlock = completionBlock;
self.progressBlock = progressBlock;
if (urls.count == 0) {
if (completionBlock) { completionBlock(0,0); }
} else {
NSUInteger listCount = self.prefetchURLs.count;
for (NSUInteger i = 0; i < self.maxConcurrentDownloads && self.requestedCount < listCount; i++) {
[self startPrefetchingAtIndex:i];
}
}
}
先用 runtime 關聯保存 url,再判斷 options 決定是否先設 placeholder,最後交由 SDWebImageManager 的單例完成下載:
objc_setAssociatedObject(self, &imageURLKey, url, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
if (!(options & SDWebImageDelayPlaceholder)) {
dispatch_main_async_safe(^{ self.image = placeholder; });
}
id <SDWebImageOperation> operation = [SDWebImageManager.sharedManager downloadImageWithURL:url options:options progress:progressBlock completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
//過程省略
}];
GIF 的實現借助 ImageIO 的 CGImageSourceRef,把各幀圖片與時間逐幀收集成數組,最終合成動圖:
+ (UIImage *)sd_animatedGIFWithData:(NSData *)data {
if (!data) { return nil; }
CGImageSourceRef source = CGImageSourceCreateWithData((__bridge CFDataRef)data, NULL);
size_t count = CGImageSourceGetCount(source);
UIImage *animatedImage;
if (count <= 1) {
animatedImage = [[UIImage alloc] initWithData:data];
} else {
NSMutableArray *images = [NSMutableArray array];
NSTimeInterval duration = 0.0f;
for (size_t i = 0; i < count; i++) {
CGImageRef image = CGImageSourceCreateImageAtIndex(source, i, NULL);
duration += [self sd_frameDurationAtIndex:i source:source];
[images addObject:[UIImage imageWithCGImage:image scale:[UIScreen mainScreen].scale orientation:UIImageOrientationUp]];
CGImageRelease(image);
}
if (!duration) { duration = (1.0f / 10.0f) * count; }
animatedImage = [UIImage animatedImageWithImages:images duration:duration];
}
CFRelease(source);
return animatedImage;
}
讀完 SDWebImage 源碼會發現,它的緩存設計尤為出色,ImageIO 與 objc/runtime 的運用也頗值得細細品味。要設計出這樣一個庫,既需要扎實的知識面,也離不開嚴謹的邏輯,著實不易。