Kingfisher官方版

Kingfisher简介

Kingfisher提供图像下载功能。这个软件可以用来配置网络镜像下载方案，让用户可以从网上下载镜像。您可以配置图像缓存方案。您可以直接输入远程图像地址来读取图像资源或从数据提供者处获取图像。软件仍然可以获得许多图像源方案，并且支持来自本地文件的图像。LocalFileImageDataPvider是一个符合类型的ImageDataPvider，用于从本地文件L加载图像，支持来自Base Stng的图像，使用BaseImageDataPvider提供来自编码数据基础的图像，所有你期望的其他功能(比如缓存或者图像处理器)应该和你从L获取图像时一样工作，并且支持从Asset生成图像，AssetImageDataPvider可以使用它在给定时间从L或者Asset生成图像！

Kingfisher软件功能

Kingfisher是一个功能强大的纯Swift库，用于从Web下载和缓存图像。它为您提供了在下一个应用程序中使用纯Swift方法处理远程图像的机会。

特性

异步图像下载和缓存。

从LSession基于网络的连接或本地提供的数据加载图像。

提供有用的图像处理器和过滤器。

以及内存和磁盘的多层混合缓存。

对缓存行为的精细控制。可定制的到期日期和大小限制。

取消下载并自动重用以前下载的内容以提高性能。

组件。根据需要使用下载器、缓存系统和图像处理器。

预取图像并从缓存中显示它们，以增强您的应用程序。

请检查、和的扩展UIImageView，以便直接从L. NSImageViewNSButtonUIButton设置图像

设置图像时的内置过渡动画。

加载图像时可以自定义的占位符和指示器。

易于扩展的图像处理和图像格式。

低数据模式支持。

SwiftUI支持。

Kingfisher软件特色

1.下载高分辨率图像。

2.向下采样以匹配图像视图的大小。

3.用给定的半径使它变圆。

4.下载时显示系统指示器和占位符图像。

5.当它准备好的时候，它会用“淡入”效果动画小缩略图。

6.原始的大图像也会缓存到磁盘上以备后用，从而避免在详细视图中再次下载。

7.任务完成后(无论成功还是失败)，都会打印控制台日志。

Kingfisher教程

最常见的任务

只要有可能，基于API的视图扩展(对于UIImageView、NSImageView、UIButton和NSButton)应该是您的首选。它使您的代码简单而优雅。

用l设置图像

让url = L(字符串:“https://example.com/image.jpg”)

imageView .KF .SetImage(带有:url)

这个简单的代码:

1.图像url.absoluteStng是否缓存在密钥下。

2.如果在缓存(内存或磁盘)中找到该图像，请将其设置为imageView.image

3.如果没有，请创建一个请求并从下载网址。

4.将下载的数据转换为UIImage对象。

5.将映像缓存到内存缓存，并将数据存储到磁盘缓存。

6.设置imageView.image来显示它。

稍后，当您再次调用setImage的相同命令url时，除非清除缓存，否则将只执行前两个步骤。

显示占位符。

让image = UIImage(命名为“deflt_pfile_icon”)

imageView .KF .SetImage(带有:url，占位符:Image)

Image将在imageView中显示同时从下载的url。

您也可以使用自定义用户视图或NSView占位符来满足以下占位符条件:

从“我的视图”中移除的实例将根据需要添加到“图像视图”中。

下载时显示负载指示器

下载时，UIActivityIndicatorView会在图像视图中显示一个。

淡入下载的图像

imageView.kf.setImage(带有:url，选项:[。过渡(。淡入度(0.2))])

完成处理程序

圆角图像

获取没有用户界面的图像

有时，您只想使用Kingfisher来获取图像，而不是将其设置为图像视图。用法KingfisherMar:

快速获取

翠鸟(Kingfisher)正在使用混合存储ImageCache来管理缓存的图像。它由内存存储和磁盘存储组成，并提供高级API作为缓存系统。如果未指定，将在Kingfisher中使用此ImageCache.deflt实例。

请使用另一个缓存密钥。

默认情况下，绝对缓存将被用作缓存键。您可以通过ImageResource用自己的密钥创建一个来更改它。

翠鸟稍后将使用缓存键在缓存中搜索图像。对不同的图像使用不同的键。

缓存中有图像吗？

如果在检索图像时使用处理器，则处理后的图像将存储在缓存中。在这种情况下，还要传递处理器标识符:

从缓存中获取图像

设置缓存限制

对于内存存储，您可以设置其总成本限制和计数限制:

默认情况下，totalCostLimit的内存缓存为设备总内存的25%，镜像数量不受限制。

对于磁盘存储，您可以通过大小限制来设置文件系统上的空间。

设置缓存的默认到期时间。

内存存储和磁盘存储都有默认的过期设置。从上次访问开始，内存中的映像将在5分钟后到期，而磁盘内存中的映像将在一周后到期。您可以通过以下方式更改该值:

如果您想在缓存图像时覆盖此到期时间，请输入一个选项:

过期的内存缓存将被清除2分钟。如果你想让它更频繁地发生:

保存图像以便手动缓存。

默认情况下，检查扩展方法，KingfisherMar并存储检索到的图像以进行自动缓存。但是，您也可以存储图像来缓存自己:

如果您有图像的原始数据，也可以将其传递给ImageCache，这将有助于Kingfisher确定图像应该以哪种格式存储:

从缓存中手动删除图像

翠鸟自动管理它的缓存。但是，您仍然可以从缓存中手动删除图像:

cache . defrt . remove image(forKey:cacheKey)

或者，通过更多的控制:

清除缓存

报告磁盘存储大小

创建自己的缓存并使用它。

手动下载图像

一般可以使用Kingfisher或者KingfisherMar的视图展开方式来检索图像。他们将首先尝试搜索缓存，以防止不必要的下载任务。在某些情况下，如果您只想下载目标映像而不想缓存它:

预发送修改请求

对图像资源拥有权限控制后，可以使用以下命令修改请求。request修饰符:

异步请求修饰符

如果您需要在修改请求之前做一些异步工作，请创建一个类型并遵循asyncimagedowloadrequestmodifier:

与上面类似，可以使用。requestModifier使用此修饰符。在这种情况下，setimage(带有:options:)orimageedownloader . download image(带有:options:))方法将不再返回DownloadTask(因为它不会立即启动下载任务)。相反，在onDownloadTaskStarted，如果需要引用一个任务，可以从回调中观察到一个:

取消下载任务

如果您开始下载，下载任务将返回A。您可以使用它来取消正在进行的下载任务:

在调用task时，任务是否已经完成？。取消()，不会发生任何事情。

同样，视图扩展方法也返回DownloadTask。您可以保存和取消它:

或者，您可以调用cancelDownloadTask图像视图来取消当前的下载任务:

身份验证NSLCredential

使用ImageDownloader()中的默认行为。从接收到时执行转换)。如果您需要提供自己的凭据，请设置身份验证挑战者: