SDWebImage 4 0 迁移指南

刚刚更新pods 编译程序,突然发现SDWebImage报错

了解到SDWebImage4.0 更换了不少方法，还增加了几个类，索性都研究一下

pod 更新SDWebImage版本为4.1.0

查找是否有对应缓存的方法由返回BOOL 值换成Block回调中参数返回BOOL值

//老版本
BOOL isInCache =[[SDImageCache sharedImageCache]diskImageExistsWithKey:@""];// 4.0 版本[[SDImageCache sharedImageCache]diskImageExistsWithKey:@"" completion:^(BOOL isInCache) {}];
复制代码

删除沙盒图片只有带Block回调的了

老版本
- (void)clearMemory;
- (void)clearDiskOnCompletion:(SDWebImageNoParamsBlock)completion;
- (void)clearDisk;
4.0 版本
- (void)clearMemory;
- (void)clearDiskOnCompletion:(nullable SDWebImageNoParamsBlock)completion;
复制代码

下载图片的方法方法名字由downloadImageWithURL 换成loadImageWithURL

1.在加载进度的Block回调里增加了targetURL （图片URL的参数） 2.在下载完成的Block回调里增加了 data （返回二进制）

//老版本[[SDWebImageManager sharedManager]downloadImageWithURL:[NSURL URLWithString:@""] options:0 progress:^(NSInteger receivedSize, NSInteger expectedSize) {} completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {
}];
//4.0 版本
[[SDWebImageManager sharedManager] loadImageWithURL:[NSURL URLWithString:[imageArray objectAtIndex:i]] options:0 progress:^(NSInteger receivedSize, NSInteger expectedSize, NSURL * _Nullable targetURL) {} completed:^(UIImage * _Nullable image, NSData * _Nullable data, NSError * _Nullable error, SDImageCacheType cacheType, BOOL finished, NSURL * _Nullable imageURL) {
}];
复制代码

UIImageView+WebCache UIButton+WebCache等category 的方法并没改变

只是里面的图片替换逻辑移动到新增的UIView +WebCache 里了

- (void)sd_setImageWithURL:(nullable NSURL *)urlplaceholderImage:(nullable UIImage *)placeholderoptions:(SDWebImageOptions)optionsprogress:(nullable SDWebImageDownloaderProgressBlock)progressBlockcompleted:(nullable SDExternalCompletionBlock)completedBlock {[self sd_internalSetImageWithURL:urlplaceholderImage:placeholderoptions:optionsoperationKey:nilsetImageBlock:nilprogress:progressBlockcompleted:completedBlock];
}
复制代码

增加了个UIView +WebCache category

此类作用是把SDWebImage 所有的 category 如 UIButton+WebCache，UIImageView+WebCache 等分类的图片替换的逻辑封装到一起使用。

- (void)sd_internalSetImageWithURL:(nullable NSURL *)urlplaceholderImage:(nullable UIImage *)placeholderoptions:(SDWebImageOptions)optionsoperationKey:(nullable NSString *)operationKeysetImageBlock:(nullable SDSetImageBlock)setImageBlockprogress:(nullable SDWebImageDownloaderProgressBlock)progressBlockcompleted:(nullable SDExternalCompletionBlock)completedBlock;
复制代码

SDWebImage4.0 播放GIF 需要使用 FLAnimatedImage

如果使用了用pods 除了pod 'SDWebImage' 还要添加下面俩个 pod 'SDWebImage/GIF' pod 'FLAnimatedImage'

//使用很简单

#import <FLAnimatedImageView.h>
#import <FLAnimatedImageView+WebCache.h>FLAnimatedImageView *FLView = [[FLAnimatedImageView alloc]init];FLView.frame = CGRectMake(0, 64, SCREEN_WIDTH, 280);[FLView sd_setImageWithURL:[NSURL URLWithString:IMAGE2] placeholderImage:[UIImage imageNamed:[NSBundle zb_placeholder]]];[self.view addSubview:FLView];复制代码

FLAnimatedImageView+WebCache 内部实行也很简单明了，依然调用UIView +WebCache 的方法在设置图片的Block里对回调里的参数imageData 进行判断如果是GIF 就使用FLAnimatedImage 的animatedImageWithGIFData方法进行赋值

- (void)sd_setImageWithURL:(nullable NSURL *)urlplaceholderImage:(nullable UIImage *)placeholderoptions:(SDWebImageOptions)optionsprogress:(nullable SDWebImageDownloaderProgressBlock)progressBlockcompleted:(nullable SDExternalCompletionBlock)completedBlock {__weak typeof(self)weakSelf = self;[self sd_internalSetImageWithURL:urlplaceholderImage:placeholderoptions:optionsoperationKey:nilsetImageBlock:^(UIImage *image, NSData *imageData) {SDImageFormat imageFormat = [NSData sd_imageFormatForImageData:imageData];if (imageFormat == SDImageFormatGIF) {weakSelf.animatedImage = [FLAnimatedImage animatedImageWithGIFData:imageData];weakSelf.image = nil;} else {weakSelf.image = image;weakSelf.animatedImage = nil;}}progress:progressBlockcompleted:completedBlock];
}复制代码

FLAnimatedImageView本身就是UIImageView的封装，用起来真的很快，配合SDWebImage加载GIF 都感觉不到下载的过程，以为是本地加载的一样 .在正常UITableView 列表试了下加载普通图片更是小意思。完全可以替换UIImageView