網路圖片絕對不能同步載入,否則一張大圖就能讓 UI 完全卡住。以下從最原始的手寫連線,一路寫到帶快取與佇列管理的完整方案。
這是最直覺的寫法:宣告一個連線與可變資料物件,透過委派回呼逐段接收資料,完成後再塞進子視圖。
// AsyncImageView.h
#import <UIKit/UIKit.h>
@interface AsyncImageView : UIView
{
NSURLConnection *connection;
NSMutableData *data;
}
- (void)loadImageFromURL:(NSURL *)url;
@end
// AsyncImageView.m
#import "AsyncImageView.h"
@implementation AsyncImageView
- (id)initWithFrame:(CGRect)frame
{
self = [super initWithFrame:frame];
if (self) {
// 初始化設定
}
return self;
}
- (void)loadImageFromURL:(NSURL *)url
{
if (connection != nil) { [connection release]; }
if (data != nil) { [data release]; }
NSURLRequest *request = [NSURLRequest requestWithURL:url
cachePolicy:NSURLRequestUseProtocolCachePolicy
timeoutInterval:60.0];
connection = [[NSURLConnection alloc] initWithRequest:request delegate:self];
}
- (void)connection:(NSURLConnection *)theConnection
didReceiveData:(NSData *)incrementalData
{
if (data == nil) {
data = [[NSMutableData alloc] initWithCapacity:2048];
}
[data appendData:incrementalData];
}
- (void)connectionDidFinishLoading:(NSURLConnection *)theConnection
{
[connection release];
connection = nil;
if ([[self subviews] count] > 0) {
[[[self subviews] objectAtIndex:0] removeFromSuperview];
}
UIImageView *imageView =
[[[UIImageView alloc] initWithImage:[UIImage imageWithData:data]] autorelease];
imageView.contentMode = UIViewContentModeScaleAspectFit;
imageView.autoresizingMask = (UIViewAutoresizingFlexibleWidth |
UIViewAutoresizingFlexibleHeight);
[self addSubview:imageView];
imageView.frame = self.bounds;
[imageView setNeedsLayout];
[self setNeedsLayout];
[data release];
data = nil;
}
- (UIImage *)image
{
UIImageView *iv = [[self subviews] objectAtIndex:0];
return [iv image];
}
- (void)dealloc
{
[connection cancel];
[connection release];
[data release];
[super dealloc];
}
@end
用 GCD 把下載丟到背景佇列,完成後切回主執行緒更新 UI。順手還做了兩件事:依按鈕尺寸縮放,以及右上角疊一張 logo。
@interface UIButton (AsyncImage)
// size 以 point 為單位
- (void)setImageFromURL:(NSString *)urlString
adjustToSize:(CGSize)size
completion:(void (^)(void))completion
logo:(UIImage *)logoImage;
@end
@implementation UIButton (AsyncImage)
- (void)setImageFromURL:(NSString *)urlString
adjustToSize:(CGSize)size
completion:(void (^)(void))completion
logo:(UIImage *)logoImage
{
dispatch_async(dispatch_get_global_queue(DISPATCH_QUEUE_PRIORITY_DEFAULT, 0), ^{
UIImage *image = nil;
NSURL *url = [NSURL URLWithString:urlString];
NSData *data = [NSData dataWithContentsOfURL:url];
image = [UIImage imageWithData:data];
if (image) {
if (!CGSizeEqualToSize(size, CGSizeZero)) {
image = [UIImage imageWithCGImage:image.CGImage
scale:[self scaleImage:image adjustToSize:size]
orientation:image.imageOrientation];
}
if (logoImage) {
image = [self addLogoImage:logoImage toImage:image];
}
// 切回主執行緒更新 UI
dispatch_async(dispatch_get_main_queue(), ^{
[self setImage:image forState:UIControlStateNormal];
completion();
});
} else {
NSLog(@"async load error.");
}
});
}
// 計算縮放比例,讓圖片填滿按鈕
- (CGFloat)scaleImage:(UIImage *)image adjustToSize:(CGSize)size
{
CGFloat xScale = size.width / image.size.width;
CGFloat yScale = size.height / image.size.height;
return 1.0 / MIN(xScale, yScale);
}
// 在圖片右上角疊上 logo
- (UIImage *)addLogoImage:(UIImage *)logo toImage:(UIImage *)img
{
CGFloat scale = [UIScreen mainScreen].scale;
int w = scale * img.size.width;
int h = scale * img.size.height;
int logoWidth = logo.scale * logo.size.width;
int logoHeight = logo.scale * logo.size.height;
CGColorSpaceRef colorSpace = CGColorSpaceCreateDeviceRGB();
CGContextRef context = CGBitmapContextCreate(NULL, w, h, 8, 4 * w, colorSpace,
kCGImageAlphaPremultipliedFirst);
CGContextDrawImage(context, CGRectMake(0, 0, w, h), img.CGImage);
CGContextDrawImage(context, CGRectMake(w - logoWidth, 0, logoWidth, logoHeight),
[logo CGImage]);
CGImageRef imageMasked = CGBitmapContextCreateImage(context);
CGContextRelease(context);
CGColorSpaceRelease(colorSpace);
return [UIImage imageWithCGImage:imageMasked scale:scale orientation:img.imageOrientation];
}
@end
這是比較接近 production 的寫法,包含三個重點:以 NSCachesDirectory 做磁碟快取、以字典把「請求中的 imageView」關聯起來、以及用計數器把同時下載的執行緒數壓在 2 以內。另外還支援插隊與清空舊佇列。
介面定義:
#import <Foundation/Foundation.h>
#import "StringUtils.h"
@interface ImageManager : NSObject
{
NSMutableDictionary *_imageDict;
NSMutableArray *_imageArr;
}
@property (nonatomic, strong) NSString *httpUrl;
@property (nonatomic, strong) NSMutableDictionary *imageDict;
@property (nonatomic, assign) dispatch_queue_t networkQueue;
+ (ImageManager *)sharedInstance;
- (void)asyncImage:(NSString *)imageName imageView:(UIImageView *)imageView;
// 插隊
- (void)asyncImageInsert:(NSString *)imageName
imageView:(UIImageView *)imageView
insert:(BOOL)insert;
// 不要保留先前的下載任務
- (void)asyncImageCleanOld:(NSString *)imageName
imageView:(UIImageView *)imageView
cleanOld:(BOOL)cleanOld;
@end
實作:
#import "ImageManager.h"
@interface ImageManager ()
@end
@implementation ImageManager
// 快取圖片的最大併發數
static int counter = 0;
@synthesize imageDict = _imageDict;
#pragma mark - 單例
+ (ImageManager *)sharedInstance
{
static id instance;
static dispatch_once_t onceToken;
dispatch_once(&onceToken, ^{
instance = self.new;
});
return instance;
}
- (id)init
{
if ((self = [super init])) {
self.networkQueue = dispatch_queue_create("com.warrior.network.image", nil);
_imageDict = [[NSMutableDictionary alloc] init];
_imageArr = [[NSMutableArray alloc] init];
}
return self;
}
// 快取檔案的完整路徑
- (NSString *)fileFullPath:(NSString *)fileName
{
NSString *cachePath =
[NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES)
objectAtIndex:0];
return [NSString stringWithFormat:@"%@/%@", cachePath, fileName];
}
// 清空先前尚未處理的任務
- (void)asyncImageCleanOld:(NSString *)imageName
imageView:(UIImageView *)imageView
cleanOld:(BOOL)cleanOld
{
if (cleanOld) {
[_imageArr removeAllObjects];
}
[self asyncImage:imageName imageView:imageView];
}
// insert 為 YES 時插到佇列最前面,優先處理
- (void)asyncImageInsert:(NSString *)imageName
imageView:(UIImageView *)imageView
insert:(BOOL)insert
{
if ([StringUtils isEmpty:imageName]) {
return;
}
NSData *data = [NSData dataWithContentsOfFile:
[self fileFullPath:[imageName stringByReplacingOccurrencesOfString:@"/"
withString:@"-"]]];
if (data == nil) {
// 本地沒有,記錄下來排入佇列
[_imageDict setValue:imageView forKey:imageName];
if (insert) {
[_imageArr insertObject:imageName atIndex:0];
} else {
[_imageArr addObject:imageName];
}
[self cacheImage];
} else {
// 命中快取,直接顯示
[imageView setImage:[UIImage imageWithData:data]];
}
}
// 一般下載,附加在佇列後方
- (void)asyncImage:(NSString *)imageName imageView:(UIImageView *)imageView
{
[self asyncImageInsert:imageName imageView:imageView insert:NO];
}
// 異步下載並寫入快取,同時最多兩個執行緒
- (void)cacheImage
{
for (; counter < 2 && _imageArr.count > 0; counter++) {
NSString *imageName = nil;
@synchronized(self) {
imageName = [[_imageArr objectAtIndex:0] copy];
[_imageArr removeObjectAtIndex:0];
}
if (imageName == nil) continue;
dispatch_async(self.networkQueue, ^{
NSLog(@"Starting: %@", imageName);
UIImage *avatarImage = nil;
NSURL *url = [NSURL URLWithString:
[NSString stringWithFormat:@"%@%@", self.httpUrl, imageName]];
NSData *responseData = [NSData dataWithContentsOfURL:url];
if (responseData.length > 0) {
[responseData writeToFile:
[self fileFullPath:[imageName stringByReplacingOccurrencesOfString:@"/"
withString:@"-"]]
atomically:NO];
avatarImage = [UIImage imageWithData:responseData];
NSLog(@"Finishing: %@", imageName);
if (avatarImage) {
dispatch_async(dispatch_get_main_queue(), ^{
UIImageView *imageView = [_imageDict objectForKey:imageName];
if (imageView != nil && avatarImage != nil) {
[imageView setImage:avatarImage];
}
[_imageDict removeObjectForKey:imageName];
});
}
}
counter--;
[self cacheImage];
});
}
}
@end
若只是幾張圖,做法二搭配 GCD 就綽綽有餘;一旦畫面上有幾十個列表項要載入圖片,就必須像做法三那樣做快取與併發控制,否則會出現記憶體暴增與列表滑動卡頓。另外要特別注意,做法二使用了 dataWithContentsOfURL:,這個 API 會同步阻塞,只是被包在背景佇列裡才看不出問題;正式專案建議改用 NSURLSession 並搭配成熟的三方庫(如 SDWebImage),能省下大量邊角處理。