IOS开发之SDWebImage

article/2025/10/8 2:16:25

SDWebImage

前言：在我们日常的开发中我们通常会使用SDWebImage来实现UIImageView加载来自互联网的远程图片
官方介绍：一个具有缓存支持的异步映像下载程序

功能简介

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

注意事项

  1. SDWebImage最大并发个数：6
  2. 默认下载超时时间 ：15s
  3. 默认磁盘缓存时间： 一周

import

#import <SDWebImage/SDWebImage.h>

SDWebImage的公共接口

 - (void)sd_setImageWithURL:(nullable NSURL *)url NS_REFINED_FOR_SWIFT;- (void)sd_setImageWithURL:(nullable NSURL *)urlplaceholderImage:(nullable UIImage *)placeholder NS_REFINED_FOR_SWIFT;- (void)sd_setImageWithURL:(nullable NSURL *)urlplaceholderImage:(nullable UIImage *)placeholderoptions:(SDWebImageOptions)options NS_REFINED_FOR_SWIFT;- (void)sd_setImageWithURL:(nullable NSURL *)urlplaceholderImage:(nullable UIImage *)placeholderoptions:(SDWebImageOptions)optionscontext:(nullable SDWebImageContext *)context;- (void)sd_setImageWithURL:(nullable NSURL *)urlcompleted:(nullable SDExternalCompletionBlock)completedBlock;- (void)sd_setImageWithURL:(nullable NSURL *)urlplaceholderImage:(nullable UIImage *)placeholdercompleted:(nullable SDExternalCompletionBlock)completedBlock NS_REFINED_FOR_SWIFT;- (void)sd_setImageWithURL:(nullable NSURL *)urlplaceholderImage:(nullable UIImage *)placeholderoptions:(SDWebImageOptions)optionscompleted:(nullable SDExternalCompletionBlock)completedBlock;- (void)sd_setImageWithURL:(nullable NSURL *)urlplaceholderImage:(nullable UIImage *)placeholderoptions:(SDWebImageOptions)optionsprogress:(nullable SDImageLoaderProgressBlock)progressBlockcompleted:(nullable SDExternalCompletionBlock)completedBlock;
  • SDWebImageOptions，设置的图片加载以及缓存策略，有几种类型
typedef NS_OPTIONS(NSUInteger, SDWebImageOptions) {/**默认情况下，当一个URL下载失败的时候，这个URL会被加入黑名单列表，下次再有这个url的请求则停止请求。如果为true，这个值表示需要再尝试请求。*/SDWebImageRetryFailed = 1 << 0,/**默认情况下，当UI可以交互的时候就开始加载图片。这个标记可以阻止这个时候加载。而是当UIScrollView开始减速滑动的时候开始加载。*/SDWebImageLowPriority = 1 << 1,/**这个flag启动渐进式下载图像，类似浏览器加载图像那样逐步显示（从上倒下加载）*/SDWebImageProgressiveLoad = 1 << 2,/**一个图片缓存了，还是会重新请求.并且缓存侧略依据NSURLCache而不是SDImageCache。即在URL没变但是服务器图片发生更新时使用，这时我们需要在NSMutableRequest中设置上（If-Modified-Since-其实是缓存的最后修改时间，有后台返回），这个参数是在上一次网络请求之后，NSResponse中的Last-Modified获取，并保存下载，在下次发送网络请求的时候添加到请求头中；这样当我们下载同一张照片的时候，其实是拿取的上次GET请求的NSURLCache缓存中的图片，并且如果后台发生变化会重新请求图片*/SDWebImageRefreshCached = 1 << 3,/**启动后台下载，实现原理是通过向系统询问后台的额外时间来完成请求的。 如果后台任务到期，则操作将被取消*/SDWebImageContinueInBackground = 1 << 4,/**当设置了NSMutableURLRequest.HTTPShouldHandleCookies = YES时，可以控制存储NSHTTPCookieStorage中的cookie*/SDWebImageHandleCookies = 1 << 5,/**允许不安全的SSL证书，用于测试环境，在正式环境中谨慎使用*/SDWebImageAllowInvalidSSLCertificates = 1 << 6,/**默认情况下,image在加载的时候是按照他们在队列中的顺序装载的(就是先进先出)。这个flag会把他们移动到队列的前端,并且立刻装载,而不是等到当前队列装载的时候再装载。*/SDWebImageHighPriority = 1 << 7,/**默认情况下,占位图会在图片下载的时候显示.这个flag开启会延迟占位图显示的时间,等到图片下载完成之后才会显示占位图.*/SDWebImageDelayPlaceholder = 1 << 8,/**一般不会在动画图片上调用 transformDownloadedImage 代理方法，这样不能够管理动画图片这个flag为尝试转换动画图片*/SDWebImageTransformAnimatedImage = 1 << 9,/**图片在下载后被加载到imageView。这个flag避免自动设置图片，来手动设置一下图片（引用一个滤镜或者加入透入动画）*/SDWebImageAvoidAutoSetImage = 1 << 10,/**默认情况下，图像将根据其原始大小进行解码。 在iOS上，此flat会将图片缩小到与设备的受限内存兼容的大小。    但如果设置了SDWebImageAvoidDecodeImage则此flat不起作用。 如果设置了SDWebImageProgressiveLoad它将被忽略*/SDWebImageScaleDownLargeImages = 1 << 11,/**结合SDWebImageQueryMemoryData设置同步查询图像数据（一般不建议这么使用，除非是在同一个runloop里避免单元格复用时发生闪现）*/SDWebImageQueryMemoryData = 1 << 12,/**结合SDWebImageQueryMemoryData设置同步查询图像数据（一般不建议这么使用，除非是在同一个runloop里避免单元格复用时发生闪现）*/SDWebImageQueryMemoryDataSync = 1 << 13,/**如果内存查询没有的时候，强制同步磁盘查询（这三个查询可以组合使用，一般不建议这么使用，除非是在同一个runloop里避免单元格复用时发生闪现）*/SDWebImageQueryDiskDataSync = 1 << 14,/*** 默认情况下，当缓存丢失时，SD将从网络下载图像。 此flat可以防止这样，使其仅从缓存加载。*/SDWebImageFromCacheOnly = 1 << 15,/*** 默认情况下，SD在下载之前先从缓存中查找，此flat可以防止这样，使其仅从网络下载*/SDWebImageFromLoaderOnly = 1 << 16,/*** 默认情况下，SD在图像加载完成后使用SDWebImageTransition进行某些视图转换，此转换仅适用于从网络下载图像。 此flat可以强制为内存和磁盘缓存应用视图转换。*/SDWebImageForceTransition = 1 << 17,/**默认情况下，SD在查询缓存和从网络下载时会在后台解码图像，这有助于提高性能，因为在屏幕上渲染图像时，需要首先对其进行解码。这发生在Core Animation的主队列中。然而此过程也可能会增加内存使用量。如果由于过多的内存消耗而遇到问题，可以用此flat禁止解码图像。*/SDWebImageAvoidDecodeImage = 1 << 18,/*** 默认情况下，SD会解码动画图像，该flat强制只解码第一帧并生成静态图。*/SDWebImageDecodeFirstFrameOnly = 1 << 19,/**默认情况下，对于SDAnimatedImage，SD会在渲染过程中解码动画图像帧以减少内存使用量。 但是用户可以指定将所有帧预加载到内存中，以便在大量imageView共享动画图像时降低CPU使用率。这实际上会在后台队列中触发preloadAllAnimatedImageFrames（仅限磁盘缓存和下载）。*/SDWebImagePreloadAllFrames = 1 << 20
};

代码实现

    NSURL *url = [NSURL URLWithString:@"https://datongyungou.oss-cn-qingdao.aliyuncs.com/upload/user/9/avatar/20210726/1627294004154_123748.jpg"];[self.mainImageView sd_setImageWithURL:url];

[self.mainImageView sd_setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"] placeholderImage:[UIImage imageNamed:@"placeholder.png"]];

SDWebImageManager *manager = [SDWebImageManager sharedManager] ;
[manager downloadImageWithURL:imageURL options:0 progress:^(NSInteger   receivedSize, NSInteger expectedSize) { // progression tracking code}  completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType,   BOOL finished, NSURL *imageURL) { if (image) { // do something with image}}];

加载动态图片

  • SDAnimatedImageView和SDAnimatedImage
SDAnimatedImageView *imageView = [SDAnimatedImageView new];
SDAnimatedImage *animatedImage = [SDAnimatedImage imageNamed:@"image.gif"];
imageView.image = animatedImage;

ContentModel（UIImageView）

在这里插入图片描述

参考文献

github - SDWebImage
iOS - SDWebImage的简单使用
深入解读SDWebImage


http://chatgpt.dhexx.cn/article/sOAgMKZU.shtml

相关文章

SDWebImage-解码、压缩图像

SDWebImage-解码、压缩图像

一、简单介绍 研究了下SDWebImage的源码&#xff0c;借鉴了别人的一些资料&#xff0c;感觉逐渐的明白的一些原理&#xff0c;现在就来记录下。 在我们使用 UIImage 的时候&#xff0c;创建的图片通常不会直接加载到内存&#xff0c;而是在渲染的时候默认在主线程上再进行解码…
阅读更多...
sdwebimage 加载webp图片

sdwebimage 加载webp图片

sdwebimage加载 webp / git 配置宏 - (void)setUpCusPhoto {_scrollView [UIScrollView new];_scrollView.frame self.view.bounds;[self.view addSubview:_scrollView];//webpUIImageView *view [[UIImageView alloc] init];view.frame CGRectMake(10, 100, 320, 200);NS…
阅读更多...
SDWebImage 5.0简介

SDWebImage 5.0简介

一、 SDWebImage原理简介 1.结构 (设计思路借鉴&#xff1a;提供多种接口&#xff0c;到底层调用到同一个方法&#xff0c;减少调用方对可选参数的传递) UIImageViewWebCache和UIButtonWebCache直接为表层的 UIKit框架提供接口, SDWebImageManger&#xff08;SDWebImageManager…
阅读更多...
SDWebImage的主流程

SDWebImage的主流程

SDWebImage提供了UIImageView的分类来实现从网络端下载数据并缓存到内存和磁盘。非常的流行,现在就主流程分析下. 主要的学习链接 &#xff1a;SDWebImage源码解读 - 简书 SDWebImage有如下特点&#xff1a; 提供了UIImageView和UIButton的分类。以支持加载网络图片并缓存…
阅读更多...
SDWebImage的缓存策略

SDWebImage的缓存策略

SDWebImage 相信对大多数开发者来说&#xff0c;都是一个不陌生的名字。它除了帮助我们读取网络图片&#xff0c;还会处理这些图片的缓存。它的缓存机制到底是什么样的呢&#xff0c;让我给跟大家唠叨唠叨&#xff0c;希望你能有收获。 基本结构 闲言少叙&#xff0c;咱们这就…
阅读更多...
SDWebImage源码解析

SDWebImage源码解析

这段时间研究了一下SDWebImage源码&#xff0c;因个人能力有限&#xff0c;如有不对的地方&#xff0c;请指出或留言&#xff0c;谢谢&#xff01; SDWebImage是一个开源的第三方库&#xff0c;它提供了UIImageView的一个分类&#xff0c;以支持从远程服务器下载并缓存图片的功…
阅读更多...
【iOS】SDWebImage

【iOS】SDWebImage

文章目录 SDWebImage日常使用一些主要功能获取图片缓存 缓存机制独立的异步图像下载独立的异步图像缓存 图片加载全过程 源码分析架构图结构SDWebImageManager1. SDWebImageOptions2. SDWebImageManagerDelegate SDWebImageCompatSDWebImageCompat.hSDWebImageCompat.m sd_imag…
阅读更多...
开源框架:SDWebImage

开源框架:SDWebImage

引言: SDWebImage是我搞iOS以来少数佩服的框架,膜拜一下作者.真的写的非常棒! 这套开源框架还是蛮重要的, 涉及到异步加载图片源和自动缓存. 我们如果能够熟练使用其API 就可以实现很多复杂的需求了. 作者依旧在更新,目前3.0 版本已经非常强大! 简化了更多的API接口.加强了…
阅读更多...
iOS 第三方框架－SDWebImage解读

iOS 第三方框架－SDWebImage解读

在iOS的图片加载框架中&#xff0c;SDWebImage可谓是占据大半壁江山。它支持从网络中下载且缓存图片&#xff0c;并设置图片到对应的UIImageView控件或者UIButton控件。在项目中使用SDWebImage来管理图片加载相关操作可以极大地提高开发效率&#xff0c;让我们更加专注于业务逻…
阅读更多...
iOS——SDWebImage解读

iOS——SDWebImage解读

前言 在iOS的图片加载框架中&#xff0c;SDWebImage占据了大半壁江山。它提供了UIImageView的一个分类&#xff0c;支持从网络中下载且缓存图片&#xff0c;并设置图片到对应的UIImageView控件或者UIButton控件。在项目中使用SDWebImage来管理图片加载相关操作可以极大地提高开…
阅读更多...
SDWebImage异步加载图片及缓存的管理与清理

SDWebImage异步加载图片及缓存的管理与清理

一、SDWebImage介绍 1、在项目的开发过程中&#xff0c;我们经常会用到异步加载图片的功能&#xff0c;先从网络上异步下载图片&#xff0c;然后通过UIImageView显示在屏幕上。这是一个经常使用的功能&#xff0c;基本上所有的联网应用程序都要用到的功能&#xff0c;现在GitH…
阅读更多...
iOS SDWebImage详细介绍

iOS SDWebImage详细介绍

在iOS的图片加载框架中&#xff0c;SDWebImage使用频率非常高。它支持从网络中下载且缓存图片&#xff0c;并设置图片到对应的UIImageView控件或者UIButton控件。在项目中使用SDWebImage来管理图片加载相关操作可以极大地提高开发效率&#xff0c;让我们更加专注于业务逻辑实现…
阅读更多...
JNA入门

JNA入门

1&#xff0c;什么是JNA&#xff1f; JNA全称Java Native Access&#xff0c;是一个建立在JNI技术之上的Java开源框架。 2&#xff0c;JNA有什么用&#xff1f; Java开发过程中&#xff0c;有时候会需要和C&#xff0c;C等交互&#xff0c;JNA相当于中间的适配器 3&#xf…
阅读更多...
JNA —— Java调用C/C++动态库

JNA —— Java调用C/C++动态库

工作所需&#xff0c;要使用Java调用c/c的动态库&#xff0c;实现Java程序使用动态库中的函数。 搜索了一番&#xff0c;常用的有JNI、JNA方法。 JNI&#xff08;Java Native Interface&#xff09; JNI定义了一种公用的语法&#xff0c;当Java和c/c都遵循这样的语法时就可以互…
阅读更多...
关于JAVA中的JNA

关于JAVA中的JNA

1、jna是什么 jna是java native access的简称&#xff0c;用他可以调用C、C代码&#xff0c;特别是windows中强大的库文件&#xff08;dll&#xff0c;在linux下是so文件&#xff09;&#xff0c;这样java就可以操控底层的一些东西&#xff0c;比如调用加密机、智能卡之类的 2、…
阅读更多...
JNA与JNI谁更受青睐呢

JNA与JNI谁更受青睐呢

JNA(Java Native Access)框架是一个开源的Java框架&#xff0c;是SUN公司主导开发的&#xff0c;建立在经典的JNI的基础之上的一个框架。非常强大、易用。其中JNA是对JNI的封装&#xff0c;能让java使用者更好的使用本地的动态库 一、JNA与JNI的比较 JNI: JNI允许Java代码和其…
阅读更多...
JNA实战系列：第一个简单的JNA开发程序

JNA实战系列：第一个简单的JNA开发程序

文章目录 第一个简单的JNA的开发程序一、引入依赖包二、创建一个接口&#xff0c;继承Libary类三、在Java中使用dll中封装的方法总结:JNA中调用C、CDLL或者.so库中的函数的步骤总结:思考 第一个简单的JNA的开发程序 假如有一个helloworld.h和一个helloworld.dll文件&#xff0…
阅读更多...
Java通过JNA调用so库 Linux环境

Java通过JNA调用so库 Linux环境

记录一下自己的JNA调研成果&#xff0c;需求是公司同事用C写了一个红外测温SDK&#xff0c;编译成so文件后提供给客户使用。客户需要一个Linux环境用Java调用so库的一个demo&#xff0c;刚好就我一个懂点Java&#xff0c;所有有了这次调研。 因为JNA相关资料实在太少&#xff…
阅读更多...
JNI便捷开发框架JNA框架之入门（一）

JNI便捷开发框架JNA框架之入门（一）

一、JNA介绍 JNA(Java Native Access)框架是一个开源的Java框架&#xff0c;是SUN公司主导开发的&#xff0c;建立在经典的JNI的基础之上的一个框架。它提供一组Java工具类用于在运行期动态访问系统本地共享类库而不需要编写任何Native/JNI代码。开发人员只要在一个java接口中…
阅读更多...
JNA简介

JNA简介

2019独角兽企业重金招聘Python工程师标准>>> JNA JNA&#xff08;Java Native Access &#xff09;提供一组Java工具类用于在运行期动态访问系统本地库&#xff08;native library&#xff1a;如Window的dll&#xff09;而不需要编写任何Native/JNI代码。开发人员只…
阅读更多...
推荐文章

Copyright @ 2022~2023