Kingfisher 使用

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()

你可能感兴趣的:(Kingfisher 使用)