一、什么是Coil
Coil是一个Android开源的图片加载库，使用Kotlin协程来加载图片，Coil在 2020 年 10 月 22 日才发布了 1.0.0 版本，但却受到了 Android官方的推广，Coil有以下几个特点：
- 更快：Coil在性能上做了很多优化，包括内存缓存和磁盘缓存、对内存中的图片进行采样、复用Bitmap、支持根据生命周期变化自动暂停和取消图片请求等
- 更轻量级： Coil大约会给你的App增加两千个方法（前提是你的 App 已经集成了OkHttp和Coroutines），Coil的方法数和Picasso相当，相比Glide和Fresco要轻量级很多
- 更容易使用：Coil’s API 充分利用了Kotlin语言的新特性，简化并减少了很多重复代码
- 更流行：Coil首选Kotlin语言开发，并且使用包含 Coroutines、OkHttp、Okio 和 AndroidX Lifecycles 在内的更现代化的开源库
Coil的首字母由来：Coroutine，Image 和Loader 得到 Coil
Coil开源库github地址：https://github.com/coil-kt/coil
Coil官方文档：https://coil-kt.github.io/coil
二、引入Coil
Coil要求AndroidX与Java 8+环境
在 app/build.gradle 中添加Coil依赖包
implementation("io.coil-kt:coil:1.2.1")
AndroidManifest.xml 中加上网络权限
<uses-permission android:name="android.permission.INTERNET" />
1、ImageView加载图片
在activity_main.xml中声明ImageView，并使用Coil为ImageView加载图片：
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
tools:context=".MainActivity">
<ImageView
android:id="@+id/imageView"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_margin="16dp" />
<Button
android:id="@+id/button"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_margin="16dp"
android:text="点击" />
</LinearLayout>
1.1、普通加载
val url = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
button.setOnClickListener {
imageView.load(url)
}
- 通过扩展方法load加载url
- 除了String以外，还支持HttpUrl 、Url、 File、 DrawableRes Int 、Drawable、 Bitmap等各种类型的加载
举例子：
// Resource
imageView.load(R.drawable.image)
// File
imageView.load(File("/path/to/image.jpg"))
1.2、crossfade(淡入淡出)加载
val url = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
reloadButton.setOnClickListener {
imageView.load(url) {
crossfade(true)
}
}
1.3、crossfade的动画时间
val url = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
reloadButton.setOnClickListener {
imageView.load(url) {
crossfade(3000)
}
}
1.4、placeholder
placeholder预置展位图
val url = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
button.setOnClickListener {
imageView.load(url) {
placeholder(R.drawable.placeholder)
crossfade(3000)
}
}
1.5、error
加载失败时的错误占位图片
val url = "https://notfound.png"
......
button.setOnClickListener {
imageView.load(url) {
error(R.drawable.error)
}
}
1.6、高斯模糊
BlurTransformation：高斯模糊变换
activity_main.xml代码中把ImageView的高度设置成300dp
val url = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
button.setOnClickListener {
imageView.load(url) {
transformations(BlurTransformation(context = applicationContext, radius = 5f, sampling = 5f))
}
}
1.7、灰度变换
GrayscaleTransformation：灰度变换
val url = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
button.setOnClickListener {
imageView.load(url) {
transformations(GrayscaleTransformation())
}
}
1.8、圆形
CircleCropTransformation：圆形变换
val url = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
button.setOnClickListener {
imageView.load(url) {
transformations(CircleCropTransformation())
}
}
1.9、圆角
RoundedCornersTransformation：圆角矩形变换
val url = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
button.setOnClickListener {
imageView.load(url) {
transformations(
RoundedCornersTransformation(
topLeft = 10f,
topRight = 10f,
bottomLeft = 10f,
bottomRight = 10f
)
)
}
}
上面左右可以设置圆角：topLeft = 10f,topRight = 10f,bottomLeft = 0f,bottomRight = 0f
下面左右可以设置圆角：topLeft = 0f,topRight = 0f,bottomLeft = 10f,bottomRight = 10f
2、Gif加载
添加依赖包：
implementation("io.coil-kt:coil-gif:1.4.0")
官方文档：https://coil-kt.github.io/coil/gifs/
创建 gif ImageLoader 实例
private val gifUrl = "https://img.zcool.cn/community/01ca905aebe350a801219b7f53a0e4.gif"
......
button.setOnClickListener {
val imageLoader = ImageLoader.Builder(this)
.componentRegistry {
if (SDK_INT >= 28) {
add(ImageDecoderDecoder())
} else {
add(GifDecoder())
}
}
.build()
//设置全局唯一实例
Coil.setImageLoader(imageLoader)
imageView.load(gifUrl) //加载gif图片
}
}
3、视频帧加载
implementation("io.coil-kt:coil-video:1.2.2")//支持Video
private val videoUrl = "https://vd4.bdstatic.com/mda-jbppbefbbztvws50/sc/mda-jbppbefbbztvws50.mp4"
......
button.setOnClickListener {
//创建 gif ImageLoader 实例
val imageLoader = ImageLoader.Builder(applicationContext)
.componentRegistry {
add(VideoFrameDecoder(this@MainActivity))
}.build()
//设置全局唯一实例
Coil.setImageLoader(imageLoader)
imageView.load(videoUrl)
}
}
5、监听下载过程
private val imageUrl = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
button.setOnClickListener {
imageView.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")
}
)
}
}
6、取消下载
private val imageUrl = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
button.setOnClickListener {
val disposable = imageView.load(imageUrl)
//取消加载
disposable.dispose()
}
f3d98b1c429f4968bffd8f9dc6d22ef2.png
7、替换 okhttp 实例
coil底层是使用okhttp作为网络请求工具，可以设置okHttpClient实例
private val imageUrl = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
button.setOnClickListener {
val okHttpClient = OkHttpClient.Builder()
.cache(CoilUtils.createDefaultCache(this))
.build()
val imageLoader = ImageLoader.Builder(this).okHttpClient {
okHttpClient
}.build()
Coil.setImageLoader(imageLoader)
imageView.load(imageUrl)
}
8、自定义
private val imageUrl = "https://img-blog.csdnimg.cn/20210124002108308.png"
......
button.setOnClickListener {
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)
imageView.load(imageUrl)
}
转载：https://blog.csdn.net/qq_35091074/article/details/134089606
