Kingfisher软件下载-Swift图片下载库 v6.3.0 官方版

　　Kingfisher提供图像下载功能，可以通过这款软件配置网络图像下载方案，让用户可以从web下载图像使用，您可以配置图像缓存方案，直接输入远程图像地址就可以读取图像资源，也可以从数据提供商获取图像，软件可以获取的图像来源方案还是很多的，支持来自本地文件的图像，LocalFileImageDataProvider是符合的类型ImageDataProvider，它用于从本地文件URL加载图像，支持图片来自Base64 String，使用Base64ImageDataProvider以从编码数据的base64提供图像，您期望的所有其他功能（例如缓存或图像处理器）都应该像从URL获取图像时一样工作，支持从AVAsset生成图像，用于AVAssetImageDataProvider从视频URL或AVAsset在给定时间生成图像，如果你需要这款软件就可以下载使用！

软件功能

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

　　特征

　　异步图像下载和缓存。

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

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

　　内存和磁盘的多层混合高速缓存。

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

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

　　独立组件。根据需要分别使用下载器，缓存系统和图像处理器。

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

　　查看，和的扩展名UIImageView，以直接从URL设置图像。NSImageViewNSButtonUIButton

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

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

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

　　低数据模式支持。

　　SwiftUI支持。

软件特色

　　1、下载高分辨率图像。

　　2、对其进行下采样以匹配图像视图的大小。

　　3、使它以给定的半径圆角化。

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

　　5、准备好后，它会以“淡入”效果为小缩略图动画化。

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

　　7、任务完成时（无论是成功还是失败）都会打印控制台日志。

官方教程

　　最常见的任务

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

　　用设置图像 URL

　　let url = URL（字符串：“ https://example.com/image.jpg ”）

　　imageView。KF。setImage（带有：url）

　　这个简单的代码：

　　1、检查是否在key下缓存了图像url.absoluteString。

　　2、如果在缓存（在内存或磁盘）中找到了映像，请将其设置为imageView.image。

　　3、如果不是，请创建一个请求并从下载url。

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

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

　　6、设置imageView.image以显示它。

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

　　显示一个占位符

　　let image = UIImage（名为：“ default_profile_icon ”）

　　imageView。KF。setImage（带有：url，占位符：image）

　　该image会显示在imageView从同时下载url。

　　您还可以使用自定义UIView或NSView占位符，使其符合以下条件Placeholder：

　　在MyView向/从除去实例将被添加imageView根据需要。

　　下载时显示加载指示器

　　UIActivityIndicatorView下载时在图像视图的中央显示一个。

　　淡入下载的图像

　　imageView.kf.setImage(with: url, options: [.transition(.fade(0.2))])

　　完成处理程序

　　圆角图像

　　在没有UI的情况下获取图像

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

　　快取

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

　　使用另一个缓存键

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

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

　　检查缓存中是否有图像

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

　　从缓存中获取图像

　　设置缓存限制

　　对于内存存储，可以设置其totalCostLimit和countLimit：

　　默认情况下，totalCostLimit内存缓存的容量为设备中总内存的25％，并且图像数量没有限制。

　　对于磁盘存储，您可以sizeLimit在文件系统上设置空间。

　　设置缓存的默认过期时间

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

　　如果要在缓存某个图像时覆盖此到期时间，请传入一个选项：

　　过期的内存缓存将清除2分钟。如果您希望它更频繁地发生：

　　存储图像以手动缓存

　　默认情况下，查看扩展方法，KingfisherManager并将存储检索到的图像以自动缓存。但是，您也可以存储图像以缓存自己：

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

　　手动从缓存中删除图像

　　翠鸟自动管理其缓存。但是您仍然可以手动从缓存中删除某个图像：

　　cache.default.removeImage(forKey: cacheKey)

　　或者，通过更多控制：

　　清除缓存

　　报告磁盘存储大小

　　创建自己的缓存并使用它

　　手动下载图像

　　通常，您可以使用Kingfisher的视图扩展方法或KingfisherManager检索图像。他们将尝试首先在缓存中搜索，以防止不必要的下载任务。在某些情况下，如果您只想下载目标图像而不缓存它：

　　发送前修改请求

　　对图像资源具有权限控制后，可以使用以下命令修改请求.requestModifier：

　　异步请求修饰符

　　如果您需要在修改请求之前执行一些异步操作，请创建一个类型并遵循AsyncImageDownloadRequestModifier：

　　与上述类似，您可以使用.requestModifier来使用此修饰符。在这种情况下，setImage(with:options:)orImageDownloader.downloadImage(with:options:)方法将不再返回DownloadTask（因为它不会立即启动下载任务）。相反，onDownloadTaskStarted如果需要引用任务，则可以从回调中观察到一个：