YYWebImage 是一个异步图像加载框架（YYKit 的组件）。

它被创建作为SDWebImage，PINRemoteImage和FLAnimatedImage的改进替代品。

它使用YYCache 支持内存和磁盘缓存，并使用 YYImage 支持WebP/APNG/GIF图像解码。
查阅这些项目获取更多信息。

特性

• 从远程或本地 URL 异步加载图像。
• 支持动画 WebP、APNG、GIF（动态缓冲区，内存使用较低）。
• 支持基线/渐进/交错图像解码。
• 为 UIImageView、UIButton、MKAnnotationView 和 CALayer 提供图像加载类别。
• 图像效果：模糊、圆角、缩放、着色、裁剪、旋转等。
• 高效的内存和磁盘图像缓存。
• 高效图像加载器，避免主线程阻塞。
• 完全文档化。

用法

从 URL 加载图像

// load from remote url
imageView.yy_imageURL = [NSURL URLWithString:@"http://github.com/logo.png"];

// load from local url
imageView.yy_imageURL = [NSURL fileURLWithPath:@"/tmp/logo.png"];

加载动画图像

// just replace `UIImageView` with `YYAnimatedImageView`
UIImageView *imageView = [YYAnimatedImageView new];
imageView.yy_imageURL = [NSURL URLWithString:@"http://github.com/ani.webp"];

渐进式加载图像

// progressive
[imageView yy_setImageWithURL:url options:YYWebImageOptionProgressive];

// progressive with blur and fade animation (see the demo at the top of this page)
[imageView yy_setImageWithURL:url options:YYWebImageOptionProgressiveBlur ｜ YYWebImageOptionSetImageWithFadeAnimation];

加载并处理图像

// 1. download image from remote
// 2. get download progress
// 3. resize image and add round corner
// 4. set image with a fade animation

[imageView yy_setImageWithURL:url
    placeholder:nil
    options:YYWebImageOptionSetImageWithFadeAnimation
    progress:^(NSInteger receivedSize, NSInteger expectedSize) {
        progress = (float)receivedSize / expectedSize;
    }
    transform:^UIImage *(UIImage *image, NSURL *url) {
        image = [image yy_imageByResizeToSize:CGSizeMake(100, 100) contentMode:UIViewContentModeCenter];
        return [image yy_imageByRoundCornerRadius:10];
    }
    completion:^(UIImage *image, NSURL *url, YYWebImageFromType from, YYWebImageStage stage, NSError *error) {
        if (from == YYWebImageFromDiskCache) {
            NSLog(@"load from disk cache");
        }
    }];

图像缓存

YYImageCache *cache = [YYWebImageManager sharedManager].cache;

// get cache capacity
cache.memoryCache.totalCost;
cache.memoryCache.totalCount;
cache.diskCache.totalCost;
cache.diskCache.totalCount;

// clear cache
[cache.memoryCache removeAllObjects];
[cache.diskCache removeAllObjects];

// clear disk cache with progress
[cache.diskCache removeAllObjectsWithProgressBlock:^(int removedCount, int totalCount) {
    // progress
} endBlock:^(BOOL error) {
    // end
}];

安装

手动

1. 下载 YYWebImage 子目录下的所有文件。
2. 将源文件添加到您的 Xcode 项目。
3. 链接所需的框架
   • UIKit
   • CoreFoundation
   • QuartzCore
   • AssetsLibrary
   • ImageIO
   • Accelerate
   • MobileCoreServices
   • sqlite3
   • libz
4. 导入 YYWebImage.h。
5. 注意：如果您想支持 WebP 格式，您可能需要将 Vendor/WebP.framework(静态库) 添加到您的 Xcode 项目。

文档

完整的 API 文档在 CocoaDocs 上提供。
您也可以使用 appledoc 在本地安装文档。

需求

此库需要 iOS 6.0+ 和 Xcode 7.0+。

许可

YYWebImage 在 MIT 许可证下提供。有关详细信息，请参阅 LICENSE 文件。

中文介绍

YYWebImage 是一个异步图片加载框架（YYKit 组件之一）。

它的设计目的是尝试替代 SDWebImage、PINRemoteImage、FLAnimatedImage 等开源框架，它支持这些开源框架的大部分功能，同时增加了大量新特性，并且有不小的性能提升。

它底层使用 YYCache 实现内存和磁盘缓存，用 YYImage 实现了 WebP/APNG/GIF 动图的解码和播放。
你可以查看这些项目以获取更多信息。

特性

• 异步的图片加载，支持 HTTP 和本地文件。
• 支持 GIF、APNG、WebP 动画（动态缓存，低内存占用）。
• 支持逐行扫描、隔行扫描、渐进式图像加载。
• 支持 UIImageView、UIButton、MKAnnotationView、CALayer 的 Category 方法。
• 常见图片处理：模糊、圆角、大小调整、裁切、旋转、色调等。
• 高性能的内存和磁盘缓存。
• 高效图片设置方式，避免主线程阻塞。
• 每个类和方法都有完善的文档注释。

用法

从 URL 加载图片

// 加载网络图片
imageView.yy_imageURL = [NSURL URLWithString:@"http://github.com/logo.png"];

// 加载本地图片
imageView.yy_imageURL = [NSURL fileURLWithPath:@"/tmp/logo.png"];

加载动图

// 只需要把 `UIImageView` 替换为 `YYAnimatedImageView` 即可。
UIImageView *imageView = [YYAnimatedImageView new];
imageView.yy_imageURL = [NSURL URLWithString:@"http://github.com/ani.webp"];

渐进式图片加载

// 渐进式：边下载边显示
[imageView yy_setImageWithURL:url options:YYWebImageOptionProgressive];

// 渐进式加载，增加模糊效果和渐变动画 （见本页最上方的GIF演示）
[imageView yy_setImageWithURL:url options:YYWebImageOptionProgressiveBlur ｜ YYWebImageOptionSetImageWithFadeAnimation];

加载、处理图片

// 1. 下载图片
// 2. 获得图片下载进度
// 3. 调整图片大小、加圆角
// 4. 显示图片时增加一个淡入动画，以获得更好的用户体验

[imageView yy_setImageWithURL:url
    placeholder:nil
    options:YYWebImageOptionSetImageWithFadeAnimation
    progress:^(NSInteger receivedSize, NSInteger expectedSize) {
        progress = (float)receivedSize / expectedSize;
    }
    transform:^UIImage *(UIImage *image, NSURL *url) {
        image = [image yy_imageByResizeToSize:CGSizeMake(100, 100) contentMode:UIViewContentModeCenter];
        return [image yy_imageByRoundCornerRadius:10];
    }
    completion:^(UIImage *image, NSURL *url, YYWebImageFromType from, YYWebImageStage stage, NSError *error) {
        if (from == YYWebImageFromDiskCache) {
            NSLog(@"load from disk cache");
        }
    }];

图片缓存

YYImageCache *cache = [YYWebImageManager sharedManager].cache;

// 获取缓存大小
cache.memoryCache.totalCost;
cache.memoryCache.totalCount;
cache.diskCache.totalCost;
cache.diskCache.totalCount;

// 清空缓存
[cache.memoryCache removeAllObjects];
[cache.diskCache removeAllObjects];

// 清空磁盘缓存，带进度回调
[cache.diskCache removeAllObjectsWithProgressBlock:^(int removedCount, int totalCount) {
    // progress
} endBlock:^(BOOL error) {
    // end
}];

安装

手动安装

1. 下载 YYWebImage 文件夹内的所有内容。
2. 将 YYWebImage 内的源文件添加(拖放)到你的工程中。
3. 链接以下框架
   • UIKit
   • CoreFoundation
   • QuartzCore
   • AssetsLibrary
   • ImageIO
   • Accelerate
   • MobileCoreServices
   • sqlite3
   • libz
4. 导入 YYWebImage.h。
5. 注意：如果你需要支持 WebP，可以将 Vendor/WebP.framework(静态库) 添加到你的工程中。你可以通过调用 YYImageWebPAvailable() 来检查 WebP 组件是否正确安装。

文档

你可以在 CocoaDocs 上查看在线 API 文档，也可以使用 appledoc 在本地生成文档。

系统要求

该项目最低支持 iOS 6.0 和 Xcode 7.0。

许可证

YYWebImage 使用 MIT 许可证，详细信息请参阅 LICENSE 文件。

相关链接

移动端图片格式调研

iOS 处理图片的一些小技巧