SDWebImage 新版接口使用方法

最新的库结构如下

初次导入，如果你的 Xcode 不是最新的，可能会遇到问题，解决版本

(1) 下载了SDWebImage.framework，然后拖到了工程中，然后：

#import "UIImageView+WebCache.h"

死活import不进啊，提示"UIImageView+WebCache.h file not found"

解决方法,最新版本的SDWebImage需要import的不是上面那一句了，需要：

#import<SDWebImage/UIImageView+WebCache.h>

然后build，一切OK。

(2) 另外一个问题就是：

Symbol Not Found: _objc_storeStrong

因为在no arc项目中引用了arc 的SDWebImage,更改一下： Build Settings->Other Linker Flags 添加 -fobjc-arc.

 

---------------------------------------------------------------------------

第一步，在需要的地方导入头文件

#import<SDWebImage/UIImageView+WebCache.h>

第二步，调用sd_setImageWithURL：方法缓存图片，注意，这就是新版本的新方法，旧方法是 setImageWithURL : 。下面将几个方法都介绍一下。

//1 图片缓存的基本代码，就是这么简单

    [self.image1 sd_setImageWithURL:imagePath1];

//2 用block 可以在图片加载完成之后做些事情 [self.image2 sd_setImageWithURL:imagePath2 completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) { NSLog(@"这里可以在图片加载完成之后做些事情"); }];

//3 给一张默认图片，先使用默认图片，当图片加载完成后再替换 [self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@"default"]];

//4 使用默认图片，而且用block 在完成后做一些事情 [self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@"default"] completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, NSURL *imageURL) { NSLog(@"图片加载完成后做的事情"); }];

//5 options 选择方式  [self.image1 sd_setImageWithURL:imagePath1 placeholderImage:[UIImage imageNamed:@"default"] options:SDWebImageRetryFailed];

除了带options选项的方法，其他的方法都是综合存储，也就是内存缓存和磁盘缓存结合的方式，如果你只需要内存缓存，那么在options这里选择SDWebImageCacheMemoryOnly就可以了。

 

当你调用 setImageWithURL: 方法的时候，他会自动去给你干这么多事，当你需要在某一具体时刻做事情的时候，你可以覆盖这些方法。比如在下载某个图片的过程中要响应一个事件，就覆盖这个方法：

//覆盖方法，指哪打哪，这个方法是下载imagePath2的时候响应

  SDWebImageManager *manager = [SDWebImageManager sharedManager];

  [manager downloadImageWithURL:imagePath2 options:SDWebImageRetryFailed progress:^(NSInteger receivedSize, NSInteger expectedSize) {

    NSLog(@"显示当前进度");

  } completed:^(UIImage *image, NSError *error, SDImageCacheType cacheType, BOOL finished, NSURL *imageURL) {

    NSLog(@"下载完成");

  }];

 

－－－－－－－－－－－－－－－－－－－－－－－－－－

 

如果想取出 SD 缓存在本地的图片，可以使用下面代码

NSURL *url = [NSURL URLWithString:[model.content objectForKey:@"image"]];

            //请求网络地址数据的同步方法

            //因为这个方法在子线程(全局队列)中执行,所以不需要考虑死线程的问题

            SDWebImageManager *manager = [SDWebImageManager sharedManager];

             [manager diskImageExistsForURL:url];

            if ([manager diskImageExistsForURL:url]) {

                LOG(@"11111")

                self.speakImage = [[manager imageCache] imageFromDiskCacheForKey:url.absoluteString];

            }else{

                LOG(@"3333333")

                NSData *data = [NSData dataWithContentsOfURL:url];

                self.speakImage = [UIImage imageWithData:data];

            }

－－－－－－－－－－－－－－－－－－－－－－－－－－

SDWebImage 在从 URL 获取超过 2 m 的图片时，会造成在内存小的机器上闪退，解决方法，重写一下内置的方法

如上图中的 UIImage+MultiFormat.m 中

+ (UIImage *)sd_imageWithData:(NSData *)data {

    UIImage *image;

    NSString *imageContentType = [NSData sd_contentTypeForImageData:data];

    if ([imageContentType isEqualToString:@"image/gif"]) {

        image = [UIImage sd_animatedGIFWithData:data];

    }

#ifdef SD_WEBP

    else if ([imageContentType isEqualToString:@"image/webp"])

    {

        image = [UIImage sd_imageWithWebPData:data];

    }

#endif

    else {

        image = [[UIImage alloc] initWithData:data];

        UIImageOrientation orientation = [self sd_imageOrientationFromImageData:data];

        if (orientation != UIImageOrientationUp) {

            image = [UIImage imageWithCGImage:image.CGImage

                                        scale:image.scale

                                  orientation:orientation];

        }

    }


    //------------------------------------------------------------
    // 这里是修改的代码，根据不同屏幕尺寸对图片进行裁切，使内存中图片占用较小
    //------------------------------------------------------------

    float width = 0.0;



    switch ((int)[UIScreen mainScreen].bounds.size.width) {

        case 320:

            width = 640.0;

            break;

        case 375:

            width = 750.0;

            break;

        case 414:

            width = 1242.0;

            break;

        default:

            width = 640.0;

            break;

    }



    //对网络图片进行缩放

    float   scaleSize = width/image.size.width;

    

    if (scaleSize < 1) {

        

        UIGraphicsBeginImageContext(CGSizeMake(image.size.width * scaleSize, image.size.height * scaleSize));

        [image drawInRect:CGRectMake(0, 0, image.size.width * scaleSize, image.size.height * scaleSize)];

        UIImage *scaledImage = UIGraphicsGetImageFromCurrentImageContext();

        

        UIGraphicsEndImageContext();

        

        return scaledImage;

    }



    return image;

}

 

-----------------------------------------------------------------------------------

SDWebImageDownloader

这个下载器改版很大,现在里面就一个方法,就是发起前往下载图片的函数:

    [[SDWebImageDownloader sharedDownloader] downloadImageWithURL:imageUrl options:SDWebImageDownloaderProgressiveDownload progress:^(NSUInteger receivedSize, long long expectedSize) { NSLog(@"%u %lld",receivedSize,expectedSize); } completed:^(UIImage *aImage, NSData *data, NSError *error, BOOL finished) { //self.image = aImage; NSLog(@"成功了:%d",UIImageJPEGRepresentation(aImage, 1).length); }]; 

 

进度Block返回的信息有两个参数:1:下载进度. 2:文件大小.

 

我这里解释一下里面的options枚举的作用

SDWebImageDownloaderOptions

1:SDWebImageDownloaderLowPriority

　　这个属于默认的使用模式了,前往下载,返回进度Block信息,完成时调用completedBlock

2:SDWebImageDownloaderProgressiveDownload

　　这个是新版本加的功能,设置后,在返回进度Block的同时,返回completedBlock,里面的UIImage就是当前下载时的图片,可以实现将图片一点点显示出来的功能.

 

那么SDWebImageDownloader 在新版本的中的分工很明确,只做一件事情,那就是下载,只是下载而已,所以,下载成功以后的图片资源是不会自动缓存的.

如果要缓存,这里需要使用到

SDImageCache

SDImageCacheType 当下载请求结束时,通过这个枚举来告知图片的来源

1:SDImageCacheTypeNone     网络



2:SDImageCacheTypeDisk     设备硬盘



3:SDImageCacheTypeMemory   内存

 

将上面两步骤的需求合并可直接使用

SDWebImageManager

新版本的管理类的改动也相当大,而且就一个方法了,如下:

 

     [[SDWebImageManager sharedManager] downloadWithURL:imageUrl options:SDWebImageLowPriority progress:^(NSUInteger receivedSize, longlong ,UIImageJPEGRepresentation(aImage, 1).length);  

    }];  

 

这样发起的下载请求,就会自动缓存图片资源了.

那么任何发起的下载请求,都会返回一个代理. 这个写法很神奇,值得深究啊.

也就是:SDWebImageOperation 将这个委托缓存一下,做什么用呢?一件事情,取消下载请求.

 

这边文章介绍了整个SDWebImage的运作原理, 真TMD 的复杂

http://blog.csdn.net/uxyheaven/article/details/7909373