iOS - SDWebImage的简单使用

LOGO

前言：在我们日常的开发中我们通常会使用SDWebImage来实现UIImageView加载来自互联网的远程图片

官方介绍：一个具有缓存支持的异步映像下载程序

关键词：缓存、异步

一：SDWebImage安装说明：

安装方式两种
1、直接cocoapods安装 在文件夹生成的podfile文件中添加pod 'SDWebImage' 终端cd + 文件位置 然后pod install即可.
2、直接下载SDWebImage，然后将文件夹拖拽到本地项目即可.
SDWebImage的github：https://github.com/rs/SDWebImage

二：功能简介

1、一个添加了web图片加载和缓存管理的UIImageView分类
2、一个异步图片下载器
3、一个异步的内存加磁盘综合存储图片并且自动处理过期图片
4、支持动态gif图
5、支持webP格式的图片
6、后台图片解压处理
7、确保同样的图片url不会下载多次
8、确保伪造的图片url不会重复尝试下载
9、确保主线程不会阻塞

三：SDWebImage实现缓存的步骤

图片来自https://blog.csdn.net/larryluoshuai/article/details/68061592

1、当我们需要获取网络图片的时候，我们首先需要的便是URL，获得URL后我们SDWebImage实现的并不是直接去请求网路，而是检查图片缓存中有没有和URl相关的图片，如果有则直接返回image，如果没有则进行下一步。
2、当图片缓存中没有图片时，SDWebImage依旧不会直从网络上获取，而是检查沙盒中是否存在图片，如果存在，则把沙盒中对应的图片存进image缓存中，然后按着第一步的判断进行。
3、如果沙盒中也不存在，则显示占位图，然后根据图片的下载队列缓存判断是否正在下载，如果下载则等待，避免二次下载。如果不存则创建下载队列，下载完毕后将下载操作从队列中清除，并且将image存入图片缓存中。!
4、刷新UI（当然根据实际情况操作）将image存入沙盒缓存。

四：SDWebImage基本使用

1、下载图片并显示（内存缓存&磁盘缓存）

1、下载图片并显示（内存缓存&磁盘缓存）
/*
     第一个参数：图片的url地址
     第二个参数：设置的占位图片
     */
    [self.headIcon sd_setImageWithURL:[NSURL URLWithString:topicItem.profile_image] 
                    placeholderImage:[[UIImage imageNamed:@"defaultUserIcon"] circleImage] 
                    completed:^(UIImage * _Nullable image, NSError * _Nullable error, SDImageCacheType cacheType, NSURL * _Nullable imageURL) {
        self.headIcon.image = [image circleImage] ;
    }] ;

2、下载图片显示并计算下载进度（内存缓存&磁盘缓存&下载进度）

    -(void)download
    {        /*
         第一个参数：图片的url地址
         第二个参数：设置的占位图片
         第三个参数：下载图片选项（策略）
         第四个参数：进度回调block
            receivedSize:已经下载的数据大小
            expectedSize：图片的总大小
         第五个参数：completed图片下载结束回调（成功|失败）
            image：下载后得到的图片，如果下载失败，那么image的值为nil
            error：错误信息，如果失败，则error有值
            cacheType：图片来源（枚举：内存缓存|磁盘缓存|直接下载）
            imageURL：下载图片的url
         */
    
[self.imageView sd_setImageWithURL:[NSURL URLWithString:topicItem.gifFistFrame] placeholderImage:[UIImage imageNamed:@"imageBackground"] options:SDWebImageProgressiveLoad progress:^(NSInteger receivedSize, NSInteger expectedSize, NSURL * _Nullable targetURL) {
            if (!expectedSize)  return ;
            
            topicItem.pictureProgress = 1.0 * receivedSize / expectedSize ;
            //进度是在子线程中完成的 所以要回到主线程
            dispatch_async(dispatch_get_main_queue(), ^{
                [self.progressView setProgress:topicItem.pictureProgress animated:YES] ;
            }) ;
            
        } completed:^(UIImage * _Nullable image, NSError * _Nullable error, SDImageCacheType cacheType, NSURL * _Nullable imageURL) {
            
//            [self.progressView performAction:M13ProgressViewActionSuccess animated:YES];
            self.progressView.hidden = YES ;
            switch (cacheType) {                
        case SDImageCacheTypeNone:                    
          NSLog(@"直接下载");                    
          break;                
        case SDImageCacheTypeDisk:                    
          NSLog(@"磁盘缓存");                    
          break;                
        case SDImageCacheTypeMemory:                    
          NSLog(@"内存缓存");                    
          break;                
        default:                    
          break;
            }
//            NSLog(@"当前是非WIFI状态下，动图不会自动播放") ;
        }] ;