Kingfisher 是一个轻量级的、纯 Swift 库，用于从 Web 下载和缓存图像。该项目深受流行的 SDWebImage 的启发。它为您提供了在下一个应用中使用纯 Swift 替代方案的机会。

特性

• 异步图像下载和缓存。
• URLSession 基于的网络。提供基本的图像处理器和过滤器。
• 内存和磁盘的多层缓存。
• 可取消的下载和处理任务，以提高性能。
• 独立组件。根据需要分别使用下载器或缓存系统。
• 预先加载图像并在必要时从缓存中显示它们。
• 为 UIImageView、NSImage 和 UIButton 提供扩展，以从 URL 直接设置图像。
• 设置图像时内置过渡动画。
• 加载图像时可自定义占位符。
• 可扩展的图像处理和图像格式支持。

最简单的用例是将图像设置到使用 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 4 (Kingfisher 4.x), Swift 3 (Kingfisher 3.x)

Main development of Kingfisher is based on Swift 4. Only critical bug fixes will be applied to Kingfisher 3.x.

• Kingfisher 4.0 迁移 - Kingfisher 3.x 应与 Kingfisher 4.0 源兼容。进行主要更新的原因是我们需要明确指定 Xcode 的 Swift 版本。Kingfisher 3 中的所有已弃用方法都已移除，因此在从 Kingfisher 3 迁移到 Kingfisher 4 之前，请确保没有遗留警告。如果您在迁移过程中遇到任何问题，请打开问题以进行讨论。
• Kingfisher 3.0 迁移指南 - 如果您是从更早版本升级到 Kingfisher 3.x，请阅读此内容获取更多信息。

下一步

我们准备了一个 维基页面。在那里您可以找到大量有用的东西。

• 安装指南 - 按照它将 Kingfisher 集成到您的项目中。
• 速查表- 好奇Kingfisher能做什么，以及应用在你的项目中会是什么样子吗？请参考此页面获取有用的代码片段。如果你已经熟悉Kingfisher，你还可以学习新技巧来改进你对Kingfisher的使用！
• API参考 - 最后，请记住，无论何时你需要更详细的参考资料时，请阅读完整的文档。

其他

Kingfisher的未来

我想保持Kingfisher的轻量级。这个框架将专注于提供下载和缓存图片的简单解决方案。但这并不意味着框架不能改善。Kingfisher远非完美，所以我们将进行必要的和有用的更新，使其更好。

开发和测试

我们热烈欢迎任何贡献和pull请求。然而，在你计划实现某些功能或试图修复不确定性问题之前，建议先开启一个讨论。

测试图片包含在另一个项目中，以保持本项目仓库快速和精简。在你需要运行测试目标时，可以在Kingfisher根目录下运行./setup.sh来克隆测试图片。如果你能保证你的pull请求构建并所有测试通过，我们会非常感激。：）

关于标志

Kingfisher的标志灵感来源于七巧板，一个由七个平面形状组成的中国传统拼图玩具。我相信她是一只翠鸟，而不是燕雀，但有人坚持认为她是一只鸽子。我想给她起个名字。嘿，伙计们，你们有什么建议吗？

联系方式

在Twitter或新浪微博上关注和联系我。如果你发现了一个问题，只需提交工单。我们也热烈欢迎pull请求。

贡献者

本项目的存在离不开所有贡献者。 [贡献].

赞助者

感谢所有赞助者！🙏[成为赞助者]

赞助商

通过成为赞助商来支持本项目。你的标志将显示在此处，并带有一个链接到你的网站。 [成为赞助商]

许可

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