SDWebImage 4.0 迁移指南

2017-09-15 本文已影响495人 _Andy_

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

5CFC472F-4DFD-4936-87B3-B47E94A87EC4.png
了解到SDWebImage4.0 更换了不少方法，还增加了几个类，索性都研究一下

pod 更新SDWebImage版本为4.1.0

38BDB086-B1E2-469E-8681-415EF14DC2BF.png
SDWebImage4.0 播放GIF 需要使用 FLAnimatedImage
如果使用了用pods 除了pod 'SDWebImage' 还要添加下面俩个
pod 'SDWebImage/GIF'
pod 'FLAnimatedImage'

4FCC6433-223B-428C-A89F-7E2F8F04A6D8.png

//使用很简单

#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

查找是否有对应缓存的方法由返回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;

增加了一个SDImageCacheConfig 类把之前在SDImageCache 类里初始化的几个属性拿出来单独封装，使其他类也能使用
增加了 NSImage+WebCache category macOS 平台开发时使用的一个 NSImage 的一个分类不用太了解

我也只是粗略的看了看，具体还有哪些改变，漏掉的，以后再补充

SDWebImage 4.0 迁移指南

猜你喜欢

热点阅读