<返回更多

Android妙用的图片加载框架——Coil使用与解析

2022-10-18  CSDN  
加入收藏

简介

Coil 是一个 Android 图片加载库,通过 Kotlin 协程的方式加载图片。特点如下:

添加依赖:

implementation("io.coil-kt:coil:1.4.0")

简单使用

// URL
imageView.load("https://www.example.com/image.jpg")

// Resource
imageView.load(R.drawable.image)

// File
imageView.load(File("/path/to/image.jpg"))

// And more...

可以使用 lambda 语法轻松配置请求选项:

imageView.load("https://www.example.com/image.jpg") {
    crossfade(true) //渐进进出
    placeholder(R.drawable.image) //加载中占位图
    transformations(CircleCropTransformation())  //圆形图
    error(R.drawable.image) //加载错误占位图
}

高斯模糊

//正常图片
mBinding.image1.load(imageUrl)

//高斯模糊-轻微模糊
mBinding.image11.load(imageUrl) {
     transformations(BlurTransformation(this@MainActivity, 5f, 10f))
     scale(Scale.FILL)
}

//高斯模式-严重模糊
mBinding.image12.load(imageUrl) {
     transformations(BlurTransformation(this@MainActivity, 20f, 40f))
     scale(Scale.FILL)
 }

效果图:

 

圆角

        //没有圆角
        mBinding.image1.load(imageUrl){
            transformations(RoundedCornersTransformation())
            scale(Scale.FILL)
        }

        //圆角一样
        mBinding.image11.load(imageUrl) {
            transformations(RoundedCornersTransformation(20f))
            scale(Scale.FILL)
        }

        //圆角不一样
        mBinding.image12.load(imageUrl) {
            transformations(
                RoundedCornersTransformation(
                    topLeft = 20f,
                    topRight = 20f,
                    bottomLeft = 50f,
                    bottomRight = 50f
                )
            )
            scale(Scale.FILL)
        }

效果图:

 

圆形

布局文件

<ImageView
     android:id="@+id/image1"
     android:layout_gravity="center"
     android:layout_width="150dp"
     android:layout_height="150dp" />

代码:

mBinding.image1.load(imageUrl){
     transformations(CircleCropTransformation())
     scale(Scale.FILL)
}

效果图:

 

灰色变换 GrayscaleTransformation

简单来说就是把彩色图变成灰色的

mBinding.image1.load(imageUrl) {
    transformations(GrayscaleTransformation())
}

效果图:

 

Gif

添加依赖

implementation("io.coil-kt:coil-gif:1.4.0")

官方文档:
https://coil-kt.github.io/coil/gifs/

创建 gif ImageLoader 实例

val imageLoader = ImageLoader.Builder(context)
    .componentRegistry {
        if (SDK_INT >= 28) {
            add(ImageDecoderDecoder(context))
        } else {
            add(GifDecoder())
        }
    }
    .build()

 //设置全局唯一实例
 Coil.setImageLoader(imageLoader)

加载 gif 图片:

mBinding.image1.load(gifUrl)

效果图如下:

 

监听下载过程

mBinding.image1.load(imageUrl) {
      listener(
           onStart = { request ->
               Log.d("coil-", "onStart")
            },
           onError = { request, throwable ->
               Log.d("coil-", "onError")
           },
           onCancel = { request ->
               Log.d("coil-", "onCancel")
           },
           onSuccess = { request, metadata ->
               Log.d("coil-", "onSuccess")
           }
       )
}

取消下载

val imageUrl = "https://t7.baidu.com/it/u=433422559,1779762296&fm=193&f=GIF"

val disposable = mBinding.image1.load(imageUrl)

//取消加载
disposable.dispose()

替换 okhttp 实例

coil 底层是使用 okhttp 作为网络请求工具,可以设置 okHttpClient 实例

val okHttpClient = OkHttpClient.Builder()
       .cache(CoilUtils.createDefaultCache(this))
       .build()

val imageLoader = ImageLoader.Builder(this).okHttpClient {
     okHttpClient
}.build()

Coil.setImageLoader(imageLoader)

自定义

  val okHttpClient = OkHttpClient.Builder()
            .cache(CoilUtils.createDefaultCache(this))
            .build()

        val imageLoader = ImageLoader.Builder(this)
            .availableMemoryPercentage(0.2)
            .diskCachePolicy(CachePolicy.ENABLED)  //磁盘缓策略 ENABLED、READ_ONLY、WRITE_ONLY、DISABLED
            .crossfade(true) //淡入淡出
            .crossfade(1000)  //淡入淡出时间
            .okHttpClient {  //设置okhttpClient实例
                okHttpClient
            }.build()

        Coil.setImageLoader(imageLoader)

availableMemoryPercentage 设置用于此 ImageLoader 的内存缓存和位图池的可用内存百分比,范围:0-1 , 如果为0 , 则禁用内存缓存。

默认行为:

 

memoryCachePolicy 内存缓存策略,有4中策略,默认为 CachePolicy.ENABLED

 

diskCachePolicy 磁盘缓存策略,方式和内存策略一直

crossfade 开启淡入淡出

Coil 源码分析

Coil 是一个单例类

 

转载请标明出处:
http://blog.csdn.NET/zhaoyanjun6/article/details/122040645

本文出自【赵彦军的博客】

文末

Coil是Android上的一个全新的图片加载框架,全名叫做 coroutine image loader,即协程图片加载库。与传统的图片加载库Glide,Picasso或Fresco等相比。该具有轻量(只有大约1500个方法)、快、易于使用、更现代的API等优势。

它支持GIF和SVG,并且可以执行四个默认转换:模糊,圆形裁剪,灰度和圆角。

声明:本站部分内容来自互联网,如有版权侵犯或其他问题请与我们联系,我们将立即删除或处理。
▍相关推荐
更多资讯 >>>