NSData dataWithContentsOfURL: 提供了一行代碼同步下載圖片的能力,但**嚴禁在主線程調用**(會阻塞 UI、導致 Watchdog 殺進程)。本文給出正確異步封裝與現代替代方案。
- (UIImage *)downloadImageSyncWithURLString:(NSString *)urlString {
NSURL *url = [NSURL URLWithString:urlString];
NSData *data = [NSData dataWithContentsOfURL:url]; // 同步阻塞!
if (data) {
return [UIImage imageWithData:data];
}
return nil;
}
- (void)downloadImageWithURLString:(NSString *)urlString
completion:(void (^)(UIImage * _Nullable image, NSError * _Nullable error))completion {
NSURL *url = [NSURL URLWithString:urlString];
NSURLSessionDataTask *task = [[NSURLSession sharedSession] dataTaskWithURL:url
completionHandler:^(NSData * _Nullable data, NSURLResponse * _Nullable response, NSError * _Nullable error) {
if (error) {
dispatch_async(dispatch_get_main_queue(), ^{ completion(nil, error); });
return;
}
// 驗證 HTTP 狀態碼
NSHTTPURLResponse *httpResponse = (NSHTTPURLResponse *)response;
if (httpResponse.statusCode != 200) {
NSError *err = [NSError errorWithDomain:@"HTTPError" code:httpResponse.statusCode userInfo:nil];
dispatch_async(dispatch_get_main_queue(), ^{ completion(nil, err); });
return;
}
UIImage *image = [UIImage imageWithData:data];
if (!image) {
NSError *err = [NSError errorWithDomain:@"ImageDecodeError" code:-1 userInfo:nil];
dispatch_async(dispatch_get_main_queue(), ^{ completion(nil, err); });
return;
}
dispatch_async(dispatch_get_main_queue(), ^{ completion(image, nil); });
}];
[task resume];
}
[self downloadImageWithURLString:@"https://example.com/avatar.png" completion:^(UIImage *image, NSError *error) {
if (image) {
self.avatarImageView.image = image;
} else {
NSLog(@"下載失敗: %@", error.localizedDescription);
self.avatarImageView.image = [UIImage imageNamed:@"placeholder"];
}
}];
| 庫 | 語言 | 核心優勢 |
|---|---|---|
| SDWebImage | OC | 成熟穩定、分類語法 sd_setImageWithURL:、緩存策略豐富、支持 WebP/動圖 |
| Kingfisher | Swift | 純 Swift、鏈式語法、Combine/Async/Await 支持、插件系統 |
| Nuke | Swift | 性能極致、Swift Concurrency 原生、圖片處理管道、預加載 |
#import
[self.imageView sd_setImageWithURL:[NSURL URLWithString:@"https://example.com/img.png"]
placeholderImage:[UIImage imageNamed:@"placeholder"]
options:SDWebImageRetryFailed | SDWebImageLowPriority
progress:^(NSInteger received, NSInteger expected, NSURL *url) {
// 進度回調
}
completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *url) {
// 完成回調
}];
UIViewContentModeScaleAspectFill + clipsToBounds)。iOS 9+ 預設阻止 HTTP 明文。Info.plist 配置:
NSAppTransportSecurity
NSAllowsArbitraryLoads
NSExceptionDomains
yourdomain.com
NSIncludesSubdomains
NSExceptionAllowsInsecureHTTPLoads
網絡圖片加載看似簡單,實則涉及緩存、併發、生命周期、安全、體驗多個維度,**生產環境請直接接入成熟圖片庫**。