SDWebImage 4 0 迁移指南-CSDN博客

刚刚更新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 *)url
          placeholderImage:(nullable UIImage *)placeholder
                   options:(SDWebImageOptions)options
                  progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
                 completed:(nullable SDExternalCompletionBlock)completedBlock {
    [self sd_internalSetImageWithURL:url
                    placeholderImage:placeholder
                             options:options
                        operationKey:nil
                       setImageBlock:nil
                            progress:progressBlock
                           completed:completedBlock];
}
复制代码

增加了个UIView +WebCache category

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

- (void)sd_internalSetImageWithURL:(nullable NSURL *)url
                  placeholderImage:(nullable UIImage *)placeholder
                           options:(SDWebImageOptions)options
                      operationKey:(nullable NSString *)operationKey
                     setImageBlock:(nullable SDSetImageBlock)setImageBlock
                          progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
                         completed:(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 *)url
          placeholderImage:(nullable UIImage *)placeholder
                   options:(SDWebImageOptions)options
                  progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
                 completed:(nullable SDExternalCompletionBlock)completedBlock {
    __weak typeof(self)weakSelf = self;
    [self sd_internalSetImageWithURL:url
                    placeholderImage:placeholder
                             options:options
                        operationKey:nil
                       setImageBlock:^(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:progressBlock
                           completed:completedBlock];
}

复制代码

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