详解Android官推Kotlin-First的图片加载库

val fakeImageLoader = object : ImageLoader {

private val drawable = ColorDrawable(Color.BLACK)

override fun enqueue(request: ImageRequest): Disposable {

request.target?.onStart(drawable)

request.target?.onSuccess(drawable)

return disposable

}

override suspend fun execute(request: ImageRequest): ImageResult {

return SuccessResult(

drawable = drawable, request = request,

metadata = ImageResult.Metadata(

memoryCacheKey = MemoryCache.Key(“”),

isSampled = false,

dataSource = DataSource.MEMORY_CACHE,

isPlaceholderMemoryCacheKeyPresent = false

)

)

}

}

ImageRequest

ImageRequest 为 ImageLoader 加载图片提供所有的必要信息，同时我们也可以使用自定义的 Target 进行处理。

val request = ImageRequest.Builder(context)

.data(“https://www.example.com/image.jpg”)

.target { drawable ->

// Handle the result.

}

.build()

context.imageLoader.enqueue(request)

ImageRequest 基于 Builder 模式来进行创建，包含了加载图片的各个配置项，这里重点看下最常用的配置项。

Disposable

Disposable 是调用 load() 方法之后的返回值，主要是用于取消图片加载：

interface Disposable {

/**

• 如果图片加载请求已经完成或者取消，则返回 true

*/

val isDisposed: Boolean

/**

• 取消正在进行的图片加载请求以及释放相关的资源，而且该方法是幂等的

*/

fun dispose()

/**

• 非阻塞式地等待任务结束

*/

@ExperimentalCoilApi

suspend fun await()

}

图片变换

图片变换是图片加载库中很常见的功能，Coil 将其抽象成 Transformation 接口，可以看到在 transform() 方法中有一个 BitmapPool 参数，这是因为在实现图形变换的时候往往需要一个 Bitmap，此时可以直接在 BitmapPool 中获取，从而复用已有的 Bitmap。

interface Transformation {

fun key(): String

suspend fun transform(pool: BitmapPool, input: Bitmap, size: Size): Bitmap

}

imageView.load(“https://www.example.com/image.jpg”) {

transformations(CircleCropTransformation())

}

Coil 主要提供了这几个图片变换的效果：

功能拓展

=============================================================

Coil 在提供了很多必要功能的基础上，预留了很多的拓展点给开发者实现自定义。Coil 的图片加载主要包括四个主要的模块：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-naPyrGgc-1618816390068)(https://upload-images.jianshu.io/upload_images/25509081-4c13201b91f3e134.png?imageMogr2/auto-orient/strip%7CimageView2/2/w/1240)]

Interceptors

Coil 的 Interceptor 无疑是借鉴了 okhttp 的设计思路，极大方便了后续的功能拓展，例如我们可以给 Coil 添加一个自定义的缓存层：

class CustomCacheInterceptor(

private val context: Context,

private val cache: LruCache<String, Drawable>

) : Interceptor {

override suspend fun intercept(chain: Interceptor.Chain): ImageResult {

val value = cache.get(chain.request.data.toString())

if (value != null) {

return SuccessResult(

drawable = value.bitmap.toDrawable(context),

request = chain.request,

metadata = TODO()

)

}

return chain.proceed(chain.request)

}

}

Mappers、Fetchers

外部在调用 load() 时，传入的 String 参数既可能指向本地资源文件，也可能指向网络图片，Mappers 和 Fetchers 搭配使用，可以对资源类型进行区分，举个例子：

imageView.load(“android.resource://example.package.name/drawable/image”)

imageView.load(“https://www.example.com/image.jpg”)

StringMapper 会将传入的 String 转换为对应的 Uri。

internal class StringMapper : Mapper<String, Uri> {

override fun map(data: String) = data.toUri()

}

ResourceUriFetcher 会判断 Uri 的 scheme 类型是否为 android.resource，是的话代表本地资源文件，而 HttpUriFetcher 则判断 Uri 的 scheme 是否为 http 或 https，是的话代表网络图片。

internal class HttpUriFetcher(callFactory: Call.Factory) : HttpFetcher(callFactory) {

override fun handles(data: Uri) = data.scheme == “http” || data.scheme == “https”

override fun key(data: Uri) = data.toString()

override fun Uri.toHttpUrl(): HttpUrl = HttpUrl.get(toString())

}

Decoders

Android 支持了很多图像格式，但也有很多它不支持的格式（例如：Gif、SVG、视频帧等），所以 Coil 便提供了对应的拓展库。

**① Gif（GifDecoder 支持所有 API 级别，但速度较慢，ImageDecoderDecoder 的加载速度快，但仅在 API 28 及更高版本可用） **

implementation(“io.coil-kt:coil-gif:1.1.1”)

val imageLoader = ImageLoader.Builder(context)

.componentRegistry {

if (SDK_INT >= 28) {

add(ImageDecoderDecoder())

} else {

add(GifDecoder())

}

}

.build()

② SVG（如果请求的 MIME 类型是 image/svg+xml，则会自动检测并解码所有 SVG）

implementation(“io.coil-kt:coil-svg:1.1.1”)

val imageLoader = ImageLoader.Builder(context)

.componentRegistry {

add(SvgDecoder(context))

}

.build()

③ 视频帧（仅支持 File 和 Uri）