README zh

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

更快: Coil 在性能上有很多优化，包括内存缓存和磁盘缓存，把缩略图存保存在内存中，循环利用 bitmap，自动暂停和取消图片网络请求等。
更轻量级: Coil 只有2000个方法（前提是你的 APP 里面集成了 OkHttp 和 Coroutines），Coil 和 Picasso 的方法数差不多，相比 Glide 和 Fresco 要轻量很多。
更容易使用: Coil 的 API 充分利用了 Kotlin 语言的新特性，简化和减少了很多样板代码。
更流行: Coil 首选 Kotlin 语言开发并且使用包含 Coroutines, OkHttp, Okio 和 AndroidX Lifecycles 在内最流行的开源库。

Coil 名字的由来：取 Coroutine Image Loader 首字母得来。

下载¶

Coil 可以在 mavenCentral() 下载

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

快速上手¶

可以使用 ImageView 的扩展函数 load 加载一张图片：

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

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

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

// And more...

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

imageView.load("https://example.com/image.jpg") {
    crossfade(true)
    placeholder(R.drawable.image)
    transformations(CircleCropTransformation())
}

Jetpack Compose¶

引入 Jetpack Compose 扩展库:

implementation("io.coil-kt:coil-compose:2.6.0")

使用 AsyncImage 加载图片:

AsyncImage(
    model = "https://example.com/image.jpg",
    contentDescription = null,
)

图片加载器 `ImageLoader`¶

imageView.load 使用单例 ImageLoader 来把 ImageRequest 加入队列. ImageLoader 单例可以通过扩展方法来获取：

val imageLoader = context.imageLoader

此外，你也可以通过创建 ImageLoader 实例从而实现依赖注入：

val imageLoader = ImageLoader(context)

如果你不需要 ImageLoader 作为单例，请把Gradle依赖替换成 io.coil-kt:coil-base.

图片请求 `ImageRequest`¶

如果想定制 ImageRequest 的加载目标，可以依照如下方式把 ImageRequest 加入队列：

val request = ImageRequest.Builder(context)
    .data("https://example.com/image.jpg")
    .target { drawable ->
        // Handle the result.
    }
    .build()
val disposable = imageLoader.enqueue(request)

如果想命令式地执行图片加载，也可以直接调用 execute(ImageRequest)：

val request = ImageRequest.Builder(context)
    .data("https://example.com/image.jpg")
    .build()
val drawable = imageLoader.execute(request).drawable

请至 Coil 的完整文档获得更多信息。

R8 / Proguard¶

Coil 兼容 R8 混淆，您无需再添加其他的规则

如果您需要混淆代码，可能需要添加对应的混淆规则：Coroutines, OkHttp。

License¶

Copyright 2023 Coil Contributors

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

   https://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.