2023年6月21日发(作者：)
Android官推kotlin-first的图⽚加载库——Coil的使⽤⼊门⽬录⼀、基本使⽤⼆、常⽤的 APIImageLoaderImageRequestDisposable图⽚变换三、功能拓展InterceptorsMappers、FetchersDecoders参考链接Coil 是⼀个⾮常年轻的图⽚加载库，在 2020 年 10 ⽉ 22 ⽇才发布了 1.0.0 版本，但却受到了 Android 官⽅的推⼴，在Android Developers Backstage 这个博客中专门聊过⼀期。推⼴的原因⽐较简单：⼀⽅⾯是这个库确实做得很好，另⼀⽅⾯是这个库完全是⽤ Kotlin 写的，⽽且运⽤了⼤量 Kotlin 的特性，尤其是协程。所以 Google 嘴上说着不会放弃 Java，但实际上咱们都懂的。Coil 名字的由来：取 Coroutine Image Loader ⾸字母得来，可以看出通过 Kotlin 协程来进⾏图⽚加载，特点如下：更快：Coil 在性能上有很多优化，包括内存缓存和磁盘缓存、把缩略图保存在内存中、通过 BitmapPool 循环利⽤Bitmap、⾃动暂停和取消⽹络请求等更轻量级：Coil 只有 2000 个⽅法，跟 Picasso 的⽅法数差不多，相⽐ Glide 和 Fresco 要轻量⾮常多更容易使⽤：Coil 的 API 充分利⽤ Kotlin 的新特性，⽽且还有丰富的拓展函数，简化和减少了很多样板代码更流⾏：Coil 通过 Kotlin 来开发，并且使⽤包含 Coroutines、okhttp、okio 和 AndroidX Lifecycles 在内的⾮常多流⾏的开源库从 Coil 的特性可以看出，这是⼀个⾮常适合个⼈ App 使⽤的图⽚加载库，特别是纯 Kotlin 开发的 App。⽽且 Coil ⾥⾯运⽤了⼤量 Kotlin 的新特性以及协程，对于我们学习 Kotlin 有⾮常⼤的价值。相⽐于 glide 和 fresco 有着⾮常复杂的结构和惊⼈的代码量，Coil 只有 2000 左右的⽅法数，所以也很适合进⾏源码研究和学习。⼀、基本使⽤Coil 可以在 mavenCentral() 下载implementation("-kt:coil:1.1.1")
Coil 给 ImageView 加了很多拓展函数，所以我们⼀⾏代码便能进⾏图⽚加载// ("/")// ()// (File("/path/to/"))同时我们也可以使⽤ lambda 语法轻松进⾏图⽚加载的配置("/") { crossfade(true) placeholder() transformations(CircleCropTransformation())}⼆、常⽤的 APIImageLoaderImageLoader 是 Coil 中对于图⽚加载的⼤管家，负责处理缓存、数据获取、图像解码、请求管理、Bitmap 缓存池、内存管理等⼯作，⼀般建议只创建⼀个 ImageLoader 并在 App 中进⾏共享，这样性能是最优的。这是因为每个 ImageLoader 都有⾃⼰的内存缓存和 Bitmap 缓存池。我们可以通过构造器来创建和配置 ImageLoader。val imageLoader = r(context) .availableMemoryPercentage(0.25) .crossfade(true) .build()同时由于 ImageLoader 是⼀个接⼝，也就意味着我们可以⾮常⽅便地进⾏测试，例如可以注⼊⼀个 fake 的 ImageLoader，从⽽每次都返回相同的 drawable。val fakeImageLoader = object : ImageLoader { private val drawable = ColorDrawable() override fun enqueue(request: ImageRequest): Disposable { ?.onStart(drawable) ?.onSuccess(drawable) return disposable } override suspend fun execute(request: ImageRequest): ImageResult { return SuccessResult( drawable = drawable, request = request, metadata = ta( memoryCacheKey = (""), isSampled = false, dataSource = _CACHE, isPlaceholderMemoryCacheKeyPresent = false ) ) }}ImageRequestImageRequest 为 ImageLoader 加载图⽚提供所有的必要信息，同时我们也可以使⽤⾃定义的 Target 进⾏处理。val request = r(context) .data("/") .target { drawable -> // Handle the result. } .build()e(request)
ImageRequest 基于 Builder 模式来进⾏创建，包含了加载图⽚的各个配置项，这⾥重点看下最常⽤的配置项配置项contextdatatargetdiskCachePolicydecoderfetcherlifecycle图⽚的地址图⽚加载之后的处理类磁盘缓存策略图⽚解码器将图⽚地址转换成 BufferedSource 或 Drawable⼀般是对应 Activity 或 Fragment 的 Lifecycle作⽤外部传⼊的 Context，⼀般是 ImageView 包含的 ContextmemoryCachePolicy内存缓存策略networkCachePolicy⽹络缓存策略DisposableDisposable 是调⽤ 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}("/") { transformations(CircleCropTransformation())}Coil 主要提供了这⼏个图⽚变换的效果TranformationBlurTransformationCircleCropTransformationGrayscaleTransformation功能⾼斯模糊圆形裁剪图⽚置灰RoundedCornersTransformation添加圆⾓三、功能拓展Coil 在提供了很多必要功能的基础上，预留了很多的拓展点给开发者实现⾃定义。Coil 的图⽚加载主要包括四个主要的模块：模块MappersFetchersDecoders作⽤映射器，实现不同数据类型之间的转换抓取器，将图⽚地址转换成 BufferedSource 或 Drawable解码器，实现各种图像格式的解码Interceptors拦截器，可以对图⽚加载请求进⾏观察、转换和重试InterceptorsCoil 的 Interceptor ⽆疑是借鉴了 okhttp 的设计思路，极⼤⽅便了后续的功能拓展，例如我们可以给 Coil 添加⼀个⾃定义的缓存层class CustomCacheInterceptor( private val context: Context, private val cache: LruCache
2023年6月21日发(作者：)
Android官推kotlin-first的图⽚加载库——Coil的使⽤⼊门⽬录⼀、基本使⽤⼆、常⽤的 APIImageLoaderImageRequestDisposable图⽚变换三、功能拓展InterceptorsMappers、FetchersDecoders参考链接Coil 是⼀个⾮常年轻的图⽚加载库，在 2020 年 10 ⽉ 22 ⽇才发布了 1.0.0 版本，但却受到了 Android 官⽅的推⼴，在Android Developers Backstage 这个博客中专门聊过⼀期。推⼴的原因⽐较简单：⼀⽅⾯是这个库确实做得很好，另⼀⽅⾯是这个库完全是⽤ Kotlin 写的，⽽且运⽤了⼤量 Kotlin 的特性，尤其是协程。所以 Google 嘴上说着不会放弃 Java，但实际上咱们都懂的。Coil 名字的由来：取 Coroutine Image Loader ⾸字母得来，可以看出通过 Kotlin 协程来进⾏图⽚加载，特点如下：更快：Coil 在性能上有很多优化，包括内存缓存和磁盘缓存、把缩略图保存在内存中、通过 BitmapPool 循环利⽤Bitmap、⾃动暂停和取消⽹络请求等更轻量级：Coil 只有 2000 个⽅法，跟 Picasso 的⽅法数差不多，相⽐ Glide 和 Fresco 要轻量⾮常多更容易使⽤：Coil 的 API 充分利⽤ Kotlin 的新特性，⽽且还有丰富的拓展函数，简化和减少了很多样板代码更流⾏：Coil 通过 Kotlin 来开发，并且使⽤包含 Coroutines、okhttp、okio 和 AndroidX Lifecycles 在内的⾮常多流⾏的开源库从 Coil 的特性可以看出，这是⼀个⾮常适合个⼈ App 使⽤的图⽚加载库，特别是纯 Kotlin 开发的 App。⽽且 Coil ⾥⾯运⽤了⼤量 Kotlin 的新特性以及协程，对于我们学习 Kotlin 有⾮常⼤的价值。相⽐于 glide 和 fresco 有着⾮常复杂的结构和惊⼈的代码量，Coil 只有 2000 左右的⽅法数，所以也很适合进⾏源码研究和学习。⼀、基本使⽤Coil 可以在 mavenCentral() 下载implementation("-kt:coil:1.1.1")
Coil 给 ImageView 加了很多拓展函数，所以我们⼀⾏代码便能进⾏图⽚加载// ("/")// ()// (File("/path/to/"))同时我们也可以使⽤ lambda 语法轻松进⾏图⽚加载的配置("/") { crossfade(true) placeholder() transformations(CircleCropTransformation())}⼆、常⽤的 APIImageLoaderImageLoader 是 Coil 中对于图⽚加载的⼤管家，负责处理缓存、数据获取、图像解码、请求管理、Bitmap 缓存池、内存管理等⼯作，⼀般建议只创建⼀个 ImageLoader 并在 App 中进⾏共享，这样性能是最优的。这是因为每个 ImageLoader 都有⾃⼰的内存缓存和 Bitmap 缓存池。我们可以通过构造器来创建和配置 ImageLoader。val imageLoader = r(context) .availableMemoryPercentage(0.25) .crossfade(true) .build()同时由于 ImageLoader 是⼀个接⼝，也就意味着我们可以⾮常⽅便地进⾏测试，例如可以注⼊⼀个 fake 的 ImageLoader，从⽽每次都返回相同的 drawable。val fakeImageLoader = object : ImageLoader { private val drawable = ColorDrawable() override fun enqueue(request: ImageRequest): Disposable { ?.onStart(drawable) ?.onSuccess(drawable) return disposable } override suspend fun execute(request: ImageRequest): ImageResult { return SuccessResult( drawable = drawable, request = request, metadata = ta( memoryCacheKey = (""), isSampled = false, dataSource = _CACHE, isPlaceholderMemoryCacheKeyPresent = false ) ) }}ImageRequestImageRequest 为 ImageLoader 加载图⽚提供所有的必要信息，同时我们也可以使⽤⾃定义的 Target 进⾏处理。val request = r(context) .data("/") .target { drawable -> // Handle the result. } .build()e(request)
ImageRequest 基于 Builder 模式来进⾏创建，包含了加载图⽚的各个配置项，这⾥重点看下最常⽤的配置项配置项contextdatatargetdiskCachePolicydecoderfetcherlifecycle图⽚的地址图⽚加载之后的处理类磁盘缓存策略图⽚解码器将图⽚地址转换成 BufferedSource 或 Drawable⼀般是对应 Activity 或 Fragment 的 Lifecycle作⽤外部传⼊的 Context，⼀般是 ImageView 包含的 ContextmemoryCachePolicy内存缓存策略networkCachePolicy⽹络缓存策略DisposableDisposable 是调⽤ 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}("/") { transformations(CircleCropTransformation())}Coil 主要提供了这⼏个图⽚变换的效果TranformationBlurTransformationCircleCropTransformationGrayscaleTransformation功能⾼斯模糊圆形裁剪图⽚置灰RoundedCornersTransformation添加圆⾓三、功能拓展Coil 在提供了很多必要功能的基础上，预留了很多的拓展点给开发者实现⾃定义。Coil 的图⽚加载主要包括四个主要的模块：模块MappersFetchersDecoders作⽤映射器，实现不同数据类型之间的转换抓取器，将图⽚地址转换成 BufferedSource 或 Drawable解码器，实现各种图像格式的解码Interceptors拦截器，可以对图⽚加载请求进⾏观察、转换和重试InterceptorsCoil 的 Interceptor ⽆疑是借鉴了 okhttp 的设计思路，极⼤⽅便了后续的功能拓展，例如我们可以给 Coil 添加⼀个⾃定义的缓存层class CustomCacheInterceptor( private val context: Context, private val cache: LruCache
发布评论