Kingfisher 是一个轻量级的纯 Swift 库，用于从网络下载和缓存图片。该项目深受流行的 SDWebImage 的启发。它为您提供了一个在下一个应用程序中使用纯 Swift 选择的机遇。

功能

• [x] 异步图像下载和缓存。
• [x] 基于 URLSession 的网络。提供基本图像处理器和过滤器。
• [x] 内存和磁盘多层缓存。
• [x] 可取消的下载和处理任务以提高性能。
• [x] 独立组件。根据需要单独使用下载器或缓存系统。
• [x] 预取图像并按需从缓存中显示。
• [x] 为 UIImageView、NSImage 和 UIButton 提供扩展以直接从 URL 设置图像。
• [x] 设置图像时内置过渡动画。
• [x] 可扩展的图像处理和图像格式支持。

最简单的用例是将图像设置为图像视图，使用 UIImageView 扩展。

let url = URL(string: "url_of_your_image")
imageView.kf.setImage(with: url)

Kingfisher 将从 url 下载图像，将其发送到内存缓存和磁盘缓存，并在 imageView 中显示。当您稍后使用相同的代码时，图像将从缓存中检索并立即显示。

要求

• iOS 8.0+ / macOS 10.10+ / tvOS 9.0+ / watchOS 2.0+
• Swift 3 (Kingfisher 3.x)，Swift 2.3 (Kingfisher 2.x)

Kingfisher 的主要开发将支持 Swift 3。仅对 Kingfisher 2.x 进行关键错误修复。

Kingfisher 3.0 迁移指南 - 如果您从早期版本升级到 Kingfisher 3.x，请阅读此文档以获取更多信息。

下一步

我们准备了一个 维基页面。您可以在那里找到许多有用的信息。

• 安装指南 - 遵循它将 Kingfisher 集成到项目中。
• 速查表 - 想知道 Kingfisher 能做什么以及它在您的项目中看起来像什么？请参阅此页面以获取有用的代码片段。如果您已经熟悉 Kingfisher，您还可以学习新技巧来改进您对 Kingfisher 的使用！
• API 参考文档 - 最后，请记住，在需要更详细参考时，一定要阅读完整内容。

其他

Kingfisher 的未来

我希望保持 Kingfisher 体积轻盈。这个框架将专注于提供下载和缓存图像的简单解决方案。这并不意味着框架不能改进。Kingfisher 已远远不是完美的，所以将进行必要的和有用的更新，使其变得更好。

开发与测试

我们热烈欢迎任何贡献和拉动请求。然而，在您计划实现一些功能或尝试解决某个不确定的问题之前，建议首先发起一场讨论。

测试图像包含在另一个项目中，以保持此项目仓库快速且精炼。您可以在 Kingfisher 的根目录中运行 ./setup.sh 以克隆测试图像。如果您需要运行测试目标，我们将不胜感激。希望您的拉动请求可以构建并让所有测试全部通过。：）

关于标志

Kingfisher 的标志灵感来源于 Tangram (七巧板)，这是一种由中国七个平面形状组成的分割拼图。我相信它是一只翠鸟而不是麻雀，但有人坚持说它是鸽子。我想我应该给它取个名字。嗨，伙计们，你有什么建议吗？

联系方式

在 Twitter 或 新浪微博 上关注和联系我。如果您发现任何问题，只需 提交工单。我们同样热烈欢迎拉动请求。

许可证

Kingfisher 在 MIT 许可证下发布。有关详细信息，请参阅 LICENSE 文件。