SDWebImage ReadMe.md文档简单说明SDWebImage ReadMe.md 文档

注1：该文章简单翻译了sdwebimage最新版本（3.7.5）的readme.md，时间紧促，如有不当请指正修改，十分感激。

版本3.7.5|平台ios|开源协议mit|

该库为uiimageview提供了一个分类来处理远程图片资源的加载。

它：

注：sdwebimage3.0版本并没有完全向后兼容2.0版本且要求的最低配置为ios5.1.1版本。如果你需要在ios5.0以前的版本使用，那么请您使用2.0版本。

how is sdwebimage better than x?

只需要包含uiimageview+webcache.h头文件，并在tableview的数据源方法tableview:cellforrowatindexpath: 中调用sd_setimagewithurl:placeholderimage:方法即可。异步下载和缓存处理这一切都将会自动为你处理。

使用block，你将能够得到图片的下载进度并获知图片是否下载成功或者失败：

注意：如果图像请求在完成前被取消了，那么成功和失败的block块将都不会被调用。

uiimageview+webcache分类背后调用的是sdwebimagemanager类的方法，负责图像的异步下载和缓存处理。你可以直接使用这个类来下载图片和进行缓存处理。

这有一个如何使用sdwebimagemanager的简单示例：

它也可以独立使用异步图片下载：

也可以单独使用基于图像的高速异步缓存处理。sdimagecache提供内存高速缓存和可选的磁盘高速缓存。磁盘高速缓存写入操作是异步的，所以不需要在用户界面添加不必要的延迟。

为了方便，sdimagecache类提供了一个单一的实例，但如果你想自定义缓存空间，那么可以创建自己的实例。

您可以使用querydiskcacheforkey：done：方法查找缓存。如果该方法返回nil，则说明当前image没有缓存。你需要负责下载和进行缓存处理。图像缓存的key通常为该图像的url。

默认情况下，如果对应图片的内存缓存不存在，那么sdimagecache将查找磁盘缓存。可以通过调用imagefrommemorycacheforkey：方法来阻止。

你可以调用storeimage:forkey: method:方法保存图片到缓存。

默认情况下，图像将被进行内存缓存和磁盘缓存（异步）。如果你只想要内存缓存，那么可以使用storeimage:forkey:todisk:方法，第三个参数传no即可。

有时，你可能会因为url的一部分是动态的而不希望使用url作为图像缓存的key。 sdwebimagemanager提供了一种方式来设置，输入url输出对应的字符串。

下面的示例在应用程序的委托中设置一个过滤器，在使用它的缓存键之前将从url中删除任何查询字符串

uitableviewcell通过第一个单元格设置的图像决定图像的尺寸。如果你加载的网络图片和占位符图像尺寸不一致，那么您可能会遇到奇怪的变形比例问题。下面的文章给出了解决此问题的方法：

<a href="http://www.wrichards.com/blog/2011/11/sdwebimage-fixed-width-cell-images/">http://www.wrichards.com/blog/2011/11/sdwebimage-fixed-width-cell-images/</a>

sdwebimage默认情况下做了很好的缓存处理。它忽略通过http服务器返回的所有类型的缓存控制头，并且没有时间限制地缓存返回的图像

它意味着你的url指向的图片是一成不变的。更好的做法是如果url指向的图片发生了改变，那么图片也应该变化。

在这种情况下，你可以使用sdwebimagerefreshcached标志。这将略微降低性能，但会尊重http缓存控制头：

有三种方法把sdwebimage安装到您的项目中：

<a href="http://520it.com/"></a>