Kingfisher 非常类似于OC中的SDWebImage, 是实现图片加载和缓存的三方库
常用的方法有:
imageView.kf_setImageWithURL(NSURL(string: "http://your_image_url.png")!)
imageView.kf_setImageWithURL(NSURL(string: "http://your_image_url.png")!, placeholderImage: nil)
通常来说,
Kingfisher将图片资源下载到本地后,是以图片资源的相对地址作为缓存图片的Key,用户再次调用链接下载图片,Kingfisher首先会去查找本地是否有该图片的缓存,根据的就是这个Key。
当然,
Kingfisher 还给用户提供了接口来指定 Key
let URL = NSURL(string: "http://your_image_url.png")!let resource = Resource(downloadURL: URL, cacheKey: "your_customized_key")
imageView.kf_setImageWithResource(resource)
在图片加载完成后,我们有可能希望他会以动画的形式展现出来,Kingfisher也是提供了接口的:
imageView.kf_setImageWithURL(NSURL(string: "your_image_url")!, placeholderImage: nil, optionsInfo: [.Transition(ImageTransition.Fade(1))])
可以多研究下
optionsInfo 这个参数,可以很方便的实现以下功能,记得参数是以数组的形式传进去的:
public enum KingfisherOptionsInfoItem {
case TargetCache(ImageCache?) //这里可以指定图片的放在那个Cache里
case Downloader(ImageDownloader?) //使用哪个下载器
case Transition(ImageTransition) //加载完成后,以什么样的方式展现出来(动画)
case DownloadPriority(Float) //下载优先级
case ForceRefresh //是否强制刷新(忽略本地缓存)
case ForceTransition //强制动画
case CacheMemoryOnly //只查找内存? 只在内存缓存?
case BackgroundDecode //后台解码
case CallbackDispatchQueue(dispatch_queue_t?) //在哪个队列下载
case ScaleFactor(CGFloat) //缩放比例 origin.size / scaleFactor = new.size, 即 >1 是缩小, (0, 1)是放大
case PreloadAllGIFData //预先加载Gif数据
}
如果加载的图片比较大,可以加载的过程中显示加载UI(Activity),只要一句代码就可以:
testImageView.kf_showIndicatorWhenLoading = true
imageView.kf_setImageWithURL(NSURL(string: "http://your_image_url.png")!)
不过这里的Activity貌似不能自定义,里边的方法是私有的的(private)
除了使用Activity显示加载过程,也可以使用block回调实现加载进度计算,自己自定义去显示加载进度
imageView.kf_setImageWithURL(NSURL(string: "your_image_url")!, placeholderImage: nil, optionsInfo: nil, progressBlock: { (receivedSize, totalSize) -> () in
print("Download Progress: \(receivedSize)/\(totalSize)")
completionHandler: { (image, error, cacheType, imageURL) -> () in
print("Downloaded and set!")
}
关于Gif的显示
let imageView = AnimatedImageView()
imageView.kf_setImageWithURL(NSURL(string: "your_animated_gif_image_url")!)
预加载图片
let urls = ["http://example.com/image1.jpg", "http://example.com/image2.jpg"].map { NSURL(string: $0)! }let prefetcher = ImagePrefetcher(urls: urls, optionsInfo: nil, progressBlock: nil, completionHandler: { (skippedResources, failedResources, completedResources) -> () in print("These resources are prefetched: \(completedResources)")})
prefetcher.start()