SDWebImage 3.8.1 开发文档 原文链接:http://www.cnblogs.com/wendingding/p/5110732.html
2016-08-04 00:37
295 查看
SDWebImage ReadMe.md 文档
附:SDWebImage框架github下载地址:https://github.com/rs/SDWebImage
注1:该文章简单翻译了SDWebImage最新版本(3.8.1)的readMe.md,时间紧促,如有不当请指正修改,十分感激。
注2:对该框架的学习将持续进行,在个人的github地址可以得到最新进展。
Web Image
版本3.8.1|平台
iOS|开源协议
MIT|
该库为UIImageView提供了一个分类来处理远程图片资源的加载。
它:
1)为Cocoa Touch框架提供一个UIImageView的分类,加载图片并进行缓存处理。 2)异步图像下载 3)异步存储器+具备自动缓存过期处理的磁盘映像缓存 4)支持GIF播放 5)支持WebP格式 6)背景图像解压缩 7)保证同一个url图片资源不被多次下载 8)保证错误url不被反复尝试下载 9)保证不会阻塞主线程 10)高性能 11)使用GCD和ARC 12)支持Arm64架构
注:SDWebimage3.8版本要求iOS系统版本为iOS7.0或以上(因为内部使用了NSURLSession)。3.0~3.7版本要求iOS系统版本为iOS5.1.1以上。如果你需要在iOS5.0以前的版本使用,那么请您使用2.0版本。
How is SDWebImage better than X?
·AFNetworking已经提供UIImageView相似的功能,还有必要使用SDWebimage吗?
Who Use It(谁用)
查看哪些应用使用了SDWebImage框架,添加你的应用到列表。
How To Use(如何用)
查看api文档CocoaDocs - SDWebImage
TableView加载图片使用UIImageView+WebCache分类
只需要包含UIImageView+WebCache.h头文件,并在tableView的数据源方法tableView:cellForRowAtIndexPath: 中调用sd_setImageWithURL:placeholderImage:方法即可。异步下载和缓存处理这一切都将会自动为你处理。#import <SDWebImage/UIImageView+WebCache.h> ... - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { static NSString *MyIdentifier = @"MyIdentifier"; UITableViewCell *cell = [tableView dequeueReusableCellWithIdentifier:MyIdentifier]; if (cell == nil) { cell = [[[UITableViewCell alloc] initWithStyle:UITableViewCellStyleDefault reuseIdentifier:MyIdentifier] autorelease]; } // Here we use the new provided sd_setImageWithURL: method to load the web image [cell.imageView sd_setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"] placeholderImage:[UIImage imageNamed:@"placeholder.png"]]; cell.textLabel.text = @"My Text"; return cell; }
使用Blocks
使用block,你将能够得到图片的下载进度并获知图片是否下载成功或者失败:// Here we use the new provided sd_setImageWithURL: method to load the web image [cell.imageView sd_setImageWithURL:[NSURL URLWithString:@"http://www.domain.com/path/to/image.jpg"] placeholderImage:[UIImage imageNamed:@"placeholder.png"] completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) { ... completion code here ... }];
注意:如果图像请求在完成前被取消了,那么成功和失败的block块将都不会被调用。
使用SDWebImageManager
UIImageView+WebCache分类背后调用的是SDWebImageManager类的方法,负责图像的异步下载和缓存处理。你可以直接使用这个类来下载图片和进行缓存处理。这有一个如何使用SDWebImageManager的简单示例:
SDWebImageManager *manager = [SDWebImageManager sharedManager]; [manager downloadImageWithURL:imageURL options:0 progress:^(NSInteger receivedSize, NSInteger expectedSize) { // progression tracking code } completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) { if (image) { // do something with image } }];
单独异步下载图片
它也可以独立使用异步图片下载:SDWebImageDownloader *downloader = [SDWebImageDownloader sharedDownloader]; [downloader downloadImageWithURL:imageURL options:0 progress:^(NSInteger receivedSize, NSInteger expectedSize) { // progression tracking code } completed:^(UIImage *image, NSData *data, NSError *error, BOOL finished) { if (image && finished) { // do something with image } }];
单独异步缓存图片
也可以单独使用基于图像的高速异步缓存处理。SDImagecache提供内存高速缓存和可选的磁盘高速缓存。磁盘高速缓存写入操作是异步的,所以不需要在用户界面添加不必要的延迟。为了方便,SDImageCache类提供了一个单一的实例,但如果你想自定义缓存空间,那么可以创建自己的实例。
您可以使用
queryDiskCacheForKey:done:方法查找缓存。如果该方法返回nil,则说明当前image没有缓存。你需要负责下载和进行缓存处理。图像缓存的key通常为该图像的URL。
SDImageCache *imageCache = [[SDImageCache alloc] initWithNamespace:@"myNamespace"]; [imageCache queryDiskCacheForKey:myCacheKey done:^(UIImage *image) { // image is not nil if image was found }];
默认情况下,如果对应图片的内存缓存不存在,那么SDImageCache将查找磁盘缓存。可以通过调用
imageFromMemoryCacheForKey:方法来阻止。
你可以调用
storeImage:forKey: method:方法保存图片到缓存。
[[SDImageCache sharedImageCache] storeImage:myImage forKey:myCacheKey];
默认情况下,图像将被进行内存缓存和磁盘缓存(异步)。如果你只想要内存缓存,那么可以使用storeImage:forKey:toDisk:方法,第三个参数传NO即可。
使用缓存key筛选器
有时,你可能会因为URL的一部分是动态的而不希望使用URL作为图像缓存的key。 SDWebImageManager提供了一种方式来设置,输入URL输出对应的字符串。下面的示例在应用程序的委托中设置一个过滤器,在使用它的缓存键之前将从URL中删除任何查询字符串
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { SDWebImageManager.sharedManager.cacheKeyFilter = ^(NSURL *url) { url = [[NSURL alloc] initWithScheme:url.scheme host:url.host path:url.path]; return [url absoluteString]; }; // Your app init code... return YES; }
常见问题
使用动态图像大小的UITableViewCell
UITableViewCell通过第一个单元格设置的图像决定图像的尺寸。如果你加载的网络图片和占位符图像尺寸不一致,那么您可能会遇到奇怪的变形比例问题。下面的文章给出了解决此问题的方法:http://www.wrichards.com/blog/2011/11/sdwebimage-fixed-width-cell-images/
处理图像刷新
SDWebimage默认情况下做了很好的缓存处理。它忽略通过HTTP服务器返回的所有类型的缓存控制头,并且没有时间限制地缓存返回的图像它意味着你的url指向的图片是一成不变的。更好的做法是如果url指向的图片发生了改变,那么图片也应该变化。
在这种情况下,你可以使用
SDWebImageRefreshCached标志。这将略微降低性能,但会尊重HTTP缓存控制头:
[imageView sd_setImageWithURL:[NSURL URLWithString:@"https://graph.facebook.com/olivier.poitrey/picture"] placeholderImage:[UIImage imageNamed:@"avatar-placeholder.png"] options:SDWebImageRefreshCached];
添加进度指示器
参考:https://github.com/JJSaccolo/UIActivityIndicator-for-SDWebImage
安装
有三种方法把SDWebImage安装到您的项目中:1)使用Cocoapods 2)复制所有文件到您的项目 3)作为静态库导入项目
相关文章推荐
- Android开发:用getDrawingCache方法获取ImageView中的图像需要注意的问题 本篇文章来源于 Linux公社网站(www.linuxidc.com) 原文链接:http:/
- 用SAXReader解析xml文档本篇文章来源于:开发学院 http://edu.codepub.com 原文链接:http://edu.codepub.com/2009/1217/18796.php
- Windows让我们养成了什么臭毛病 本篇文章来源于 黑基网-中国最大的网络安全站点 原文链接:http://www.hackbase.com/news/2010-05-10/35154.html
- 自动备份sql server2005数据库本篇文章来源于:开发学院 http://edu.codepub.com 原文链接:http://edu.codepub.com/2011/0323/30321.php
- SDWebImage 初步使用 及发现readme文档中的问题
- IOS开发笔记 - 基于SDWebImage的网络图片加载处理
- linux的硬链接与软连接(转载,原文地址为http://www.cnblogs.com/sonic4x/archive/2011/08/05/2128543.html)
- 软件开发,创意是灵魂——用HttpWebRequest和正则表达式提取网页中的链接
- Web图片编辑控件开发文档-Xproer.ImageEditor
- iOS开发之SDWebImage(一个可管理远程图片加载的类库)的使用
- 【iOS开发-96】网络请求总结,深浅拷贝copy和mutableCopy,SDWebImage图像下载第三方框架
- Asp.net 火狐和IE的兼容性代码解析本篇文章来源于:开发学院 http://edu.codepub.com 原文链接:http://edu.codepub.com/2010/0308/20818.php
- 移动时代的信息需求(原文链接http://blog.sina.com.cn/s/blog_593af2a70101ac1k.html)
- 7项Web开发者需要了解的新技术(转自:http://sd.csdn.net/a/20110920/304652.html)
- ios 开发随记 SDWebImage
- 不错的介绍JS中Cookie的文章本篇文章来源于:开发学院 http://edu.codepub.com 原文链接:http://edu.codepub.com/2009/0528/4789.php
- Zend Studio 实用快捷键一览表本篇文章来源于:开发学院 http://edu.codepub.com 原文链接:http://edu.codepub.com/2009/0618/6532.php
- cookie与session(再比较) 转载 原文链接http://blog.sina.com.cn/s/blog_4745d1c10100ihnq.html
- session和cookie的区别 本篇文章来源于 站长资讯网 原文链接:http://www.chinahtml.com/1007/128010707619425.html
- iOS开发实战:SDWebImage深度解析