1、基本使用方法
//异步下载并缓存
- (void)sd_setImageWithURL:(nullable NSURL *)url NS_REFINED_FOR_SWIFT;
//使用占位图片,当下载完成后使用新下载的图片进行替换
- (void)sd_setImageWithURL:(nullable NSURL *)url
placeholderImage:(nullable UIImage *)placeholder NS_REFINED_FOR_SWIFT;
//参数options表示下载图片时使用的选项常量,下面还会一一列举
- (void)sd_setImageWithURL:(nullable NSURL *)url
placeholderImage:(nullable UIImage *)placeholder
options:(SDWebImageOptions)options NS_REFINED_FOR_SWIFT;
//操作完成后调用的块。其中typedef void(^SDExternalCompletionBlock)(UIImage * _Nullable image, NSError * _Nullable error, SDImageCacheType cacheType, NSURL * _Nullable imageURL);包含四个参数,cacheType表示图片是从网络下载或本地缓存的
- (void)sd_setImageWithURL:(nullable NSURL *)url
completed:(nullable SDExternalCompletionBlock)completedBlock; - (void)sd_setImageWithURL:(nullable NSURL *)url
placeholderImage:(nullable UIImage *)placeholder
completed:(nullable SDExternalCompletionBlock)completedBlock NS_REFINED_FOR_SWIFT; - (void)sd_setImageWithURL:(nullable NSURL *)url
placeholderImage:(nullable UIImage *)placeholder
options:(SDWebImageOptions)options
completed:(nullable SDExternalCompletionBlock)completedBlock;
//@param progressBlock 表示在图片在下载时调用的块
- (void)sd_setImageWithURL:(nullable NSURL *)url
placeholderImage:(nullable UIImage *)placeholder
options:(SDWebImageOptions)options
progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
completed:(nullable SDExternalCompletionBlock)completedBlock; - (void)sd_setImageWithPreviousCachedImageWithURL:(nullable NSURL *)url
placeholderImage:(nullable UIImage *)placeholder
options:(SDWebImageOptions)options
progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
completed:(nullable SDExternalCompletionBlock)completedBlock __deprecated_msg("This method is misunderstanding and deprecated, consider using `SDWebImageQueryDiskSync` options with `sd_setImageWithURL:` instead");
2、 SDWebImageOptions 常量
typedef NS_OPTIONS(NSUInteger, SDWebImageOptions ) {
SDWebImageRetryFailed = < < ,
SDWebImageLowPriority = < < ,
SDWebImageCacheMemoryOnly = < < ,
SDWebImageProgressiveDownload = < < ,
SDWebImageRefreshCached = < < ,
SDWebImageContinueInBackground = < < ,
SDWebImageHandleCookies = < < ,
SDWebImageAllowInvalidSSLCertificates = < < ,
SDWebImageHighPriority = < < ,
SDWebImageDelayPlaceholder = < < ,
SDWebImageTransformAnimatedImage = < < ,
SDWebImageAvoidAutoSetImage = < < ,
SDWebImageScaleDownLargeImages = < < ,
};
SDWebImageRetryFailed
默认情况下,当一个url下载失败,会尝试重新下载,如果URL在黑名单中那么SDWebImage库不进行重试。这个标志使黑名单失效。SDWebImageLowPriority
默认情况下,在UI交互中开始图片下载,这个标志使这个特性失效,例如导致在UIScrollView减速中延迟下载。SDWebImageCacheMemoryOnly
此标志在下载完成后禁用磁盘上缓存,仅在内存中缓存。SDWebImageProgressiveDownload
这个标志表示可以逐步下载图片,在下载过程中,网页能够逐步的显示图片。默认情况下,图片只在下载完成后一次性显示。SDWebImageRefreshCached
虽然图片已经被缓存了,但是HTTP响应的缓存控制比较重要,如果需要则从远程地址刷新图片。硬盘缓存将用SDWebImage代替NSURLCache,会导致轻微的性能下降。这个项目帮助处理相同的请求URL而图片已经改变的情况,比如Facebook图形api的概要图片。如果一个缓存的图片被刷新,完成块会被缓存图片调用一次,再被最终的图片调用一次。SDWebImageContinueInBackground
在iOS 4+,当app切换到后台继续下载图片。这是通过向系统请求额外的时间来完成,在后台情况下让请求完成。如果后台任务时间过期那么操作将会被取消。SDWebImageHandleCookies
通过设置NSMutableURLRequest来操作cookies保存到NSHTTPCookieStore。 HTTPShouldHandlerCookies = YES。SDWebImageAllowInvalidSSLCertificates
允许使用不信任的SSL证书。测试目的是有效的。在生产环境被警告。SDWebImageHighPriority
默认情况下,图片在队列中排队下载。这个标志移动他们到前面的队列中。SDWebImageDelayPlaceholder
默认情况下,当图片在加载中默认图片被加载。这个标志将延迟默认图片的显示,直到图片完成加载。SDWebImageTransformAnimatedImage
我们通常在动画图片中不调用transformDownloadedImage代理,大部分的变形代码将损坏图片。使用这个标志在任何情况下变形图片。SDWebImageAvoidAutoSetImage
默认情况下,图片是在下载完成后加载到图片视图。但是在一些情况下,我们想要在设置图片之前进行图片处理(比如,提供一个过滤或添加一个折叠动画)。使用这个标志,如果你想在下载成功后在完成块中手动设置图片。SDWebImageScaleDownLargeImages
默认情况下,图片解码为原始的大小。在iOS,这个标志会把图片缩小到与设备的受限内容相兼容的大小。如果设置了SDWebImageProgressDownload标志,那么缩小被设置为无效。
3、主要管理类
SDImageCache 提供图片缓存
SDWebImageCoder 对网络中下载的图片进行解码操作
SDWebImageDownloader 异步下载图片
4、UIKit层和工具层
在进行网络下载图片时都是通过UIImageView+WebCache类中提供的基础方法,但是所有的最终走向UIView+WebCache以下方法中:
- (void)sd_internalSetImageWithURL:(nullable NSURL *)url
placeholderImage:(nullable UIImage *)placeholder
options:(SDWebImageOptions)options
operationKey:(nullable NSString *)operationKey
setImageBlock:(nullable SDSetImageBlock)setImageBlock
progress:(nullable SDWebImageDownloaderProgressBlock)progressBlock
completed:(nullable SDExternalCompletionBlock)completedBlock;
如果好奇UIImageView+WebCache类中的方法还要走向上一层UIView+WebCache类中,那是因为SDWebImage框架还支持对UIButton的图片下载。