SDWebImage 是一个用 Objective-C 编写的开源库,主要用于异步加载和缓存图片。
SDWebImage 提供了一个异步图片下载器,允许在后台线程下载图片,避免阻塞主线程。
SDWebImage 实现了异步的内存和磁盘缓存机制,具有自动缓存到期处理。
SDWebImage 支持包括 GIF 和 WebP 在内的多种图片格式,且能确保同一个 URL 的图片不会被重复下载,确保无效的 URL 不会被反复加载,支持后台图片解压缩处理,以减少主线程的负担。
SDWebImage 的主要组件包括:
UIImageView+WebCache:为 UIImageView 提供网络图片加载和缓存的扩展。
SDWebImageManager:作为下载器和缓存的桥梁,管理图片的下载和缓存。
SDWebImageDownloader:负责图片的下载操作。
SDImageCache:负责图片的缓存,包括内存缓存和磁盘缓存。
常用方法及简单用法示例
在使用SDWebImage库之前,首先要将其导入所需项目内。
然后在需要的文件里引用头文件:
#import "UIImageView+WebCache.h"
使用时,调用sd_setImageWithURL:方法缓存图片,这就是新版本的新方法,旧方法是setImageWithURL:。下面是常用的几个方法
- sd_setImageWithURL:
//图片缓存的基本代码
[self.image1 sd_setImageWithURL:imagePath1];
- sd_setImageWithURL: completed:
//用block 可以在图片加载完成之后做些事情
[self.image2 sd_setImageWithURL:imagePath2 completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {
//在图片加载完成之后想触发的事情
NSLog(@"加载完成");
}];
- sd_setImageWithURL: placeholderImage:
//给一张默认图片,先使用默认图片,当图片加载完成后再替换
[self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@"default"]];
- sd_setImageWithURL: placeholderImage: completed:
//使用默认图片,而且用block 在完成后做一些事情
[self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@"default"] completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) {
NSLog(@"加载完成");
}];
- sd_setImageWithURL: placeholderImage: options:
//options 选择方式
[self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@"default"] options:SDWebImageRetryFailed];
//如果你只需要内存缓存,那么在options这里选择SDWebImageCacheMemoryOnly就可以了。
简单应用:
NSURL *url = [NSURL URLWithString:@"https://news-at.zhihu.com/api/7/prefetch-launch-images/1080*1920"];
self.imageView = [[UIImageView alloc] init];
UIImage *placeholderImage = [UIImage imageNamed:@"placeholder"];
[self.imageView sd_setImageWithURL:url placeholderImage:placeholderImage];
[self.view addSubview:self.imageView];