0

Coil

Kotlin 协程支持的 Android 图像加载。「Image loading for Android backed by Kotlin Coroutines.」

Official Site
Github repo
Main metrics

Github stars Tracking Chart

原文：https://github.com/coil-kt/coil/blob/master/README-zh.md。


Coil

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

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

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

由 Instacart 用heart打造。

下载

Coil 允许使用mavenCentral(). 

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

快速使用

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

// 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())
}

也可以查看 Coli 文档获得更多信息： 完整的文档在这里。

环境要求

R8 / Proguard

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

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

许可证

Copyright 2020 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.

Overview

Name With Ownercoil-kt/coil
Primary LanguageKotlin
Program languageKotlin (Language Count: 3)
PlatformAndroid
License:Apache License 2.0
Release Count55
Last Release Name3.0.0-alpha06 (Posted on )
First Release Name0.6.0 (Posted on )
Created At2019-08-10 21:28:21
Pushed At2024-05-04 08:02:28
Last Commit At
Stargazers Count10.3k
Watchers Count104
Fork Count633
Commits Count1.6k
Has Issues Enabled
Issues Count778
Issue Open Count45
Pull Requests Count1072
Pull Requests Open Count8
Pull Requests Close Count131
Has Wiki Enabled
Is Archived
Is Fork
Is Locked
Is Mirror
Is Private

Coil

An image loading library for Android backed by Kotlin Coroutines. Coil is:

  • Fast: Coil performs a number of optimizations including memory and disk caching, downsampling the image in memory, re-using Bitmaps, automatically pausing/cancelling requests, and more.
  • Lightweight: Coil adds ~1500 methods to your APK (for apps that already use OkHttp and Coroutines), which is comparable to Picasso and significantly less than Glide and Fresco.
  • Easy to use: Coil's API leverages Kotlin's language features for simplicity and minimal boilerplate.
  • Modern: Coil is Kotlin-first and uses modern libraries including Coroutines, OkHttp, Okio, and AndroidX Lifecycles.

Coil is an acronym for: Coroutine Image Loader.

Made with ❤️ at Instacart. Translations: 한국어

Download

Coil is available on mavenCentral().

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

Quick Start

To load an image into an ImageView, use the load extension function:

// 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...

Requests can be configured with an optional trailing lambda:

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

To get an image imperatively, use the get suspend function:

val drawable = Coil.get("https://www.example.com/image.jpg")

Coil requires Java 8 bytecode. Here's how to enable it.

Check out Coil's full documentation here.

Requirements

  • AndroidX
  • Min SDK 14+
  • Compile SDK: 28+
  • Java 8+

R8 / Proguard

Coil is fully compatible with R8 out of the box and doesn't require adding any extra rules.

If you use Proguard, you may need to add rules for Coroutines, OkHttp and Okio.

License

Copyright 2019 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.
To the top