更新日志
[3.6.3] - 2026 年 9 月 18 日
- 修复使用 Android Gradle 插件 9.4.0 和 R8 的构建因 Kotlin 模块名称元数据中包含无效字符而失败的问题。
[3.6.2] - 2026 年 9 月 4 日
- 修复当等待中的请求被取消时,
DeDupeConcurrentRequestStrategy会挂起该 key 的请求的问题。(#3566) - 修复使用 Compose Multiplatform 1.13 时出现的 JS/WASM 链接错误。(#3568)
[3.6.1] - 2026 年 9 月 1 日
- 修复启用 ES 模块时 JS 构建失败的问题。(#3558)
[3.6.0] - 2026 年 8 月 26 日
- 新增:支持在 JS/WASM 上加载
blob:URL(对象 URL)。(#3504) - 新增:添加
ImageRequest.Builder.allowPartialImage与ImageLoader.Builder.allowPartialImage,用于配置 Android 上的StaticImageDecoder是否接受部分图像。该选项默认启用,与先前 Coil 版本的行为一致。(#3494) - 修复使用倒置约束测量时
AsyncImage崩溃的问题。(#3470) - 修复 Compose
filterQuality未应用于由 Drawable 支持的图像(包括 GIF)的问题。(#3469) - 修复 JS/WASM 图像解码器内存泄漏问题。(#3503)
- 修复在 R8 9.0+ 优化构建中使用
GenericViewTarget时图像无法渲染的问题。(#3518) - 在 JVM 上使用
Runtime.maxMemory()确定最大内存缓存大小,而不是假定有 512 MB 的可用内存。(#3458) - 将 ProGuard 规则打包到非 Android JVM 构件中。(#3476)
- 将 Android 编译 SDK 更新至 37。
- 将 Kotlin 更新至 2.4.10。
- 将 Compose 更新至 1.12.0。
- 将 Okio 更新至 3.18.1。
- 将 Skiko 更新至 0.150.1。
- 将
kotlinx-io-okio更新至 0.9.1。
[3.5.0] - 2026 年 6 月 10 日
自 3.4.0 以来的变更:
- 重要:移除
iosX64与macosX64目标。(#3386) - 重要:将 Android 最低 SDK 版本提升至 23。(#3283)
- 新增:在 JS/WASM 上添加快速 WebP 尺寸提取功能,以避免回退到完整的 Skia 解码。(#3341)
- 移除
ImageLoader.Builder.memoryCacheMaxSizePercentWhileInBackground上的实验性注解。(#3439) - 修复
CacheStrategy实现无法刷新已缓存的失败响应(例如已过期的缓存404响应)的问题。(#3401) - 在协程上下文中查找
ContinuationInterceptor而非CoroutineDispatcher。(#3415) - 将 Android 编译 SDK 更新至 36。
- 将 Kotlin 语言版本更新至 2.2。
- 将 Kotlin 更新至 2.4.0。
- 将 Compose 更新至 1.11.1。
- 将 Okio 更新至 3.17.0。
- 将 Skiko 更新至 0.144.6。
- 将
androidx.annotation更新至 1.10.0。
自 3.5.0-beta01 以来的变更:
- 移除
ImageLoader.Builder.memoryCacheMaxSizePercentWhileInBackground上的实验性注解。(#3439) - 在协程上下文中查找
ContinuationInterceptor而非CoroutineDispatcher。(#3415) - 将 Kotlin 语言版本更新至 2.2。
- 将 Kotlin 更新至 2.4.0。
- 将 Compose 更新至 1.11.1。
- 将 Skiko 更新至 0.144.6。
[3.5.0-beta01] - 2026 年 5 月 4 日
- 移除
iosX64与macosX64目标。(#3386) - 将 Android 最低 SDK 版本提升至 23。(#3283)
- 在 JS/WASM 上添加快速 WebP 尺寸提取功能,以避免回退到完整的 Skia 解码。(#3341)
- 修复
CacheStrategy实现无法刷新已缓存的失败响应(例如已过期的缓存404响应)的问题。(#3401) - 将编译 SDK 更新至 36。
- 将 Kotlin 更新至 2.3.21。
- 将 Compose 更新至 1.11.0-beta03。
- 将 Okio 更新至 3.17.0。
- 将 Skiko 更新至 0.144.5。
- 将
androidx.annotation更新至 1.10.0。
[3.4.0] - 2026 年 2 月 24 日
- 新增:添加
ConcurrentRequestStrategy,以支持合并针对相同 key 的正在进行的网络请求。(#2995,#3326)DeDupeConcurrentRequestStrategy启用了该行为,并允许等待者等待正在进行的网络请求的结果。- 该行为属于实验性功能,目前默认处于禁用状态。
- 目前,请求始终根据其
diskCacheKey进行合并。
OkHttpNetworkFetcherFactory、KtorNetworkFetcherFactory和NetworkFetcher.Factory现在接受concurrentRequestStrategy。
- 新增:在 JS/WASM 上使用 Web Worker 解码图像,以避免阻塞浏览器主线程。(#3305)
- 新增:为非 Compose 多平台构件添加对 Linux 原生目标(
linuxX64和linuxArm64)的支持。(#3054) - 新增:添加仅限 Compose 的 API,以改进后续请求之间的过渡效果。(#3141,#3175)
ImageRequest.Builder.useExistingImageAsPlaceholder支持在未设置占位图时从上一张图像淡入淡出。ImageRequest.Builder.preferEndFirstIntrinsicSize允许CrossfadePainter优先使用结束绘制器(end painter)的固有尺寸。
- 新增:在
coil-gif中添加ImageLoader.Builder.repeatCount(Int),用于设置全局动图重复播放次数。(#3143) - 新增:在
coil-video中添加对优先使用内嵌视频缩略图的支持。(#3107) - 新增:将
coil-lint与coil-core一同发布,并添加 lint 检查以捕获在ImageRequest.Builder代码块中意外调用kotlin.error()的情况。(#3304) - 将 Kotlin 语言版本设置为 2.1。(#3302)
- 使
BitmapFetcher在通用代码中可用。(#3286) - 在 Android 上创建单例
ImageLoader时使用applicationContext。(#3246) - 默认缓存符合条件的非 2xx HTTP 响应(例如
404),并停止缓存不可缓存的响应(例如500)。(#3137,#3139) - 修复消费 OkHttp 响应体时的潜在竞态条件。(#3186)
- 修复
maxBitmapSize边缘情况,以防止 Android 上因 Bitmap 过大而发生崩溃。(#3259) - 将 Kotlin 更新至 2.3.10。
- 将 Compose 更新至 1.9.3。
- 将 Okio 更新至 3.16.4。
- 将 Skiko 更新至 0.9.22.2。
- 将
kotlinx-io-okio更新至 0.9.0。 - 将
androidx.core更新至 1.16.0。 - 将
androidx.lifecycle更新至 2.9.4。 - 将
androidx.exifinterface更新至 1.4.2。
[3.3.0] - 2025 年 7 月 22 日
- 新增:引入新 API,用于在应用处于后台时限制 Android 上的
MemoryCache.maxSize。- 如果设置了
ImageLoader.Builder.memoryCacheMaxSizePercentWhileInBackground,当应用处于后台时,ImageLoader的内存缓存将被限制为其最大尺寸的指定百分比。该设置目前默认禁用。 - 当应用处于后台时,将从内存缓存中剪裁图像以达到受限的最大尺寸,但内存缓存对最近剪裁图像的弱引用不受影响。这意味着如果图像当前在其他位置被引用(例如
AsyncImage、ImageView等),它仍将存在于内存缓存中。 - 该 API 有助于减少后台内存使用量,防止应用过早被终止,并有助于减轻用户设备上的内存压力。
- 如果设置了
- 新增:为
SvgDecoder添加Svg.Parser实参。- 这使得在默认 SVG 解析器不满足需求时,可以使用自定义的 SVG 解析器。
- 为
SvgDecoder添加density实参,以支持提供自定义密度倍数。 - 添加
Uri.Builder以支持复制和修改Uri。 - 添加
ImageLoader.Builder.mainCoroutineContext,以支持在测试中覆盖 Coil 对Dispatchers.main.immediate的使用。 - 修复在动画结束且取消对
start图像的引用时,CrossfadePainter.intrinsicSize发生变化的问题。这与CrossfadeDrawable的行为保持一致。 - 修复无法从 Java 访问
ImageLoaders.executeBlocking的问题。 - 在
coil-network-ktor3中使用kotlinx.io的 Okio 互操作模块。 - 将
kotlinx-datetime更新至0.7.1。- 此版本包含仅影响
coil-network-cache-control模块的二进制不兼容变更。有关更多信息,请参见此处。
- 此版本包含仅影响
- 将 Kotlin 更新至 2.2.0。
- 将 Compose 更新至 1.8.2。
- 将 Okio 更新至 3.15.0。
- 将 Skiko 更新至 0.9.4.2。
[3.2.0] - 2025 年 5 月 13 日
自 3.1.0 以来的变更:
- 重要:由于 Compose
1.8.0的要求,coil-compose和coil-compose-core现在需要 Java 11 字节码。有关如何启用它,请参见此处。 - 修改
AsyncImagePreviewHandler的函数式构造函数,使其返回AsyncImagePainter.State.Success而非AsyncImagePainter.State.Loading。 - 修复
ConstraintsSizeResolver#size()中的取消操作。 - 修复使用 R8 构建时缺少
PlatformContext的警告。 - 修复当返回默认
FakeImageLoaderEngine响应时,FakeImageLoaderEngine未设置Transition.Factory.NONE的问题。 - 移除
ColorImage上的实验性注解。 - 在
CacheControlCacheStrategy中延迟解析网络标头。 - 重构
CircleCropTransformation和RoundedCornersTransformation以共享通用代码。 - 如果
ExifOrientationStrategy不是RESPECT_PERFORMANCE,则在内部回退到使用BitmapFactory。 - 将 Kotlin 更新至 2.1.20。
- 将 Compose 更新至 1.8.0。
- 将 Okio 更新至 3.11.0。
- 将 Skiko 更新至 0.9.4。
- 将 Coroutines 更新至 1.10.2。
- 将
accompanist-drawablepainter更新至 0.37.3。
自 3.2.0-rc02 以来的变更:
- 如果
ExifOrientationStrategy不是RESPECT_PERFORMANCE,则在内部回退到使用BitmapFactory。 - 将 Compose 更新至 1.8.0。
- 将
accompanist-drawablepainter更新至 0.37.3。
[3.2.0-rc02] - 2025 年 4 月 26 日
- 修复在非 JVM 目标上使用
KtorNetworkFetcherFactory(Ktor 3) 加载图像时,图像请求因ClosedByteChannelException失败的问题。
[3.2.0-rc01] - 2025 年 4 月 24 日
- 重要:由于 Compose
1.8.0的要求,coil-compose和coil-compose-core现在需要 Java 11 字节码。有关如何启用它,请参见此处。 - 修改
AsyncImagePreviewHandler的函数式构造函数,使其返回AsyncImagePainter.State.Success而非AsyncImagePainter.State.Loading。 - 修复
ConstraintsSizeResolver#size()中的取消操作。 - 修复使用 R8 构建时缺少
PlatformContext的警告。 - 修复当返回默认
FakeImageLoaderEngine响应时,FakeImageLoaderEngine未设置Transition.Factory.NONE的问题。 - 移除
ColorImage上的实验性注解。 - 在
CacheControlCacheStrategy中延迟解析网络标头。 - 重构
CircleCropTransformation和RoundedCornersTransformation以共享通用代码。 - 在
coil-network-ktor2和coil-network-ktor3中使用kotlinx.io的 Okio 互操作模块。 - 将 Kotlin 更新至 2.1.20。
- 将 Compose 更新至 1.8.0-rc01。
- 将 Okio 更新至 3.11.0。
- 将 Skiko 更新至 0.9.4。
- 将 Coroutines 更新至 1.10.2。
[3.1.0] - 2025 年 2 月 4 日
- 提升
AsyncImage性能。- 根据可组合项是新实例化还是复用,运行时性能提升了 25% 至 40%。内存分配也减少了 35% 至 48%。更多信息请参见此处。
- 添加
ColorImage并弃用FakeImage。ColorImage用于在测试和预览中返回模拟值。它解决了与FakeImage相同的用例,但位于coil-core而非coil-test中,更易于访问。
- 移除
coil-compose-core对Dispatchers.Main.immedate的依赖。- 这同时也修复了在 Paparazzi 和 Roborazzi 屏幕截图测试中,
AsyncImagePainter无法同步执行ImageRequest的问题。
- 这同时也修复了在 Paparazzi 和 Roborazzi 屏幕截图测试中,
- 添加对格式为
data:[<mediatype>][;base64],<data>的数据 URI 的支持。 - 添加
AnimatedImageDecoder.ENCODED_LOOP_COUNT,以支持使用 GIF 元数据中编码的重复次数。 - 向
NetworkRequest添加Extras以支持自定义扩展。 - 添加
DiskCache.Builder.cleanupCoroutineContext并弃用DiskCache.Builder.cleanupDispatcher。 - 添加
ImageLoader.Builder.imageDecoderEnabled,以支持在 API 29 及以上版本中选择性禁用android.graphics.ImageDecoder。 - 如果没有为
ImageRequest的数据类型注册Keyer,则输出一条警告日志。 - 将
CrossfadePainter公开。 - 在所有多平台目标上支持
Transformation。 - 在
CacheControlCacheStrategy中支持将 0 作为Expires标头的值。 - 修复当
ContentScale更改为/从None变更时,AsyncImage/SubcomposeAsyncImage/rememberAsyncImage未启动新ImageRequest的问题。 - 将 Kotlin 更新至 2.1.10。
- 注意:如果使用了 Kotlin Native,由于 LLVM 更新,该版本需要使用 Kotlin 2.1.0 或更高版本进行编译。
- 将 Compose 更新至 1.7.3。
- 将
androidx.core更新至 1.15.0。
[3.0.4] - 2024 年 11 月 25 日
- 修复矢量 Drawable 无法在 Android Studio 预览中渲染的问题。
- 修复尺寸超过
maxBitmapSize的请求可能会发生内存缓存未命中的问题。 - 修复
FakeImage无法在 Android 上渲染的问题。 - 修复当与
AsyncImage/rememberAsyncImagePainter/SubcomposeAsyncImage一起使用时,若请求的Transformation发生变化却未启动新图像请求的问题。 - 修复
ScaleDrawable和CrossfadeDrawable不遵循着色(tint)状态的问题。 - 允许
ImageDecoder解码部分图像源。这与BitmapFactory中的行为一致。 - 修复解码后未调用
Bitmap.prepareToDraw()的问题。 - 对于非光栅化图像,
SvgDecoder不应返回isSampled = true。 - 如果 immediate main 调度器不可用,在 Compose 中回退到
Dispatchers.Unconfined。此机制仅在预览/测试环境中使用。 - 将 Ktor 2 更新至
2.3.13。
[3.0.3] - 2024 年 11 月 14 日
- 修复根据
ImageView的ScaleType设置ImageRequest.scale的问题。 - 修复在删除其文件后,
DiskCache无法跟踪条目移除的边缘情况。 - 记录错误日志时将 throwable 传递给
Logger。 - 不再将
kotlin-stdlib-jdk7和kotlin-stdlib-jdk8替换为kotlin-stdlib。
[3.0.2] - 2024 年 11 月 9 日
- 修复在 Android 上使用自定义
CacheStrategy调用OkHttpNetworkFetcherFactory时崩溃的问题。 - 修复
CacheControlCacheStrategy计算缓存条目寿命不正确的问题。 - 修复在 API >= 28 上,仅当
ImageRequest.bitmapConfig为ARGB_8888或HARDWARE时才会生效的问题。
[3.0.1] - 2024 年 11 月 7 日
- 修复在由硬件 Bitmap 支持的
BitmapImage上调用Image.toBitmap时崩溃的问题。 - 修复
AsyncImageModelEqualityDelegate.Default对非ImageRequest模型进行错误相等性比较的问题。
[3.0.0] - 2024 年 11 月 4 日
Coil 3.0.0 是 Coil 的下一个主要版本,全面支持 Compose Multiplatform。
要查看 3.0.0 中的完整改进和重要变更列表,请查阅升级指南。
自 3.0.0-rc02 以来的变更:
- 移除其余已弃用的方法。
[3.0.0-rc02] - 2024 年 10 月 28 日
要查看 3.x 中的完整改进和重要变更列表,请查阅升级指南。自 3.0.0-rc01 以来的变更:
- 添加
BlackholeDecoder。这简化了仅磁盘缓存的预加载。 - 为
ConstraintsSizeResolver和DrawScopeSizeResolver添加remember函数。 - 移除作为
AsyncImage形参的EqualityDelegate。现在应通过LocalAsyncImageModelEqualityDelegate进行设置。 - 修复当父级可组合项使用
IntrinsicSize时AsyncImage无法渲染的问题。 - 修复当
AsyncImagePainter没有子绘制器时AsyncImage填满可用约束的问题。 - 修复由于忽略
EqualityDelegate,观察rememberAsyncImagePainter的状态会导致无限重组的问题。 - 修复解析包含特殊字符的
File/Path路径时的问题。 - 修复在
VideoFrameDecoder中使用自定义FileSystem实现时的问题。 - 将 Ktor 更新至
3.0.0。 - 将
androidx.annotation更新至1.9.0。
[3.0.0-rc01] - 2024 年 10 月 8 日
要查看 3.x 中的完整改进和重要变更列表,请查阅升级指南。自 3.0.0-alpha10 以来的变更:
- 破坏性变更:默认禁用
addLastModifiedToFileCacheKey,并允许针对每个请求进行设置。可以使用相同的标志重新启用该行为。 - 新增:引入新的
coil-network-cache-control构件,实现了对Cache-Control标头的支持。 - 新增:为
SvgDecoder.Factory添加scaleToDensity属性。该属性确保具有固有尺寸的 SVG 会乘上设备密度(仅在 Android 上受支持)。 - 将
ExifOrientationPolicy重命名为ExifOrientationStrategy。 - 在获取时从
MemoryCache中移除不可共享的图像。 - 将
ConstraintsSizeResolver公开。 - 稳定
setSingletonImageLoaderFactory。 - 在
coil-network-ktor3中恢复优化的 JVM I/O 函数。 - 将
pdf添加到 MIME 类型列表中。 - 将编译 SDK 更新至 35。
- 将 Kotlin 更新至 2.0.20。
- 将 Okio 更新至 3.9.1。
[3.0.0-alpha10] - 2024 年 8 月 7 日
- 破坏性变更:将
ImageLoader.Builder.networkObserverEnabled替换为用于NetworkFetcher的ConnectivityChecker接口。- 要禁用网络观察程序,请将
ConnectivityChecker.ONLINE传递给KtorNetworkFetcherFactory/OkHttpNetworkFetcherFactory的构造函数。
- 要禁用网络观察程序,请将
- 新增:支持在所有平台上加载 Compose Multiplatform 资源。要加载资源,请使用
Res.getUri:
kotlin
AsyncImage(
model = Res.getUri("drawable/image.jpg"),
contentDescription = null,
)- 为
ImageLoader和ImageRequest添加maxBitmapSize属性。- 该属性默认为 4096x4096,为已分配 Bitmap 的尺寸提供了安全上限。这有助于避免因意外使用
Size.ORIGINAL加载超大图像而导致内存不足异常。
- 该属性默认为 4096x4096,为已分配 Bitmap 的尺寸提供了安全上限。这有助于避免因意外使用
- 将
ExifOrientationPolicy转换为接口以支持自定义策略。 - 修复
Uri对 Windows 文件路径的处理。 - 从
ImageAPI 中移除@ExperimentalCoilApi。 - 将 Kotlin 更新至 2.0.10。
[3.0.0-alpha09] - 2024 年 7 月 23 日
- 破坏性变更:将
io.coil-kt.coil3:coil-network-ktor构件重命名为io.coil-kt.coil3:coil-network-ktor2,后者依赖于 Ktor 2.x。此外,引入了依赖于 Ktor 3.x 的io.coil-kt.coil3:coil-network-ktor3。wasmJs支持仅在 Ktor 3.x 中可用。 - 新增:添加
AsyncImagePainter.restart()以手动重启图像请求。 - 从
NetworkClient及相关类中移除@ExperimentalCoilApi。 - 优化
ImageRequest以避免不必要的Extras和Map分配。
[2.7.0] - 2024 年 7 月 17 日
- 微调内部协程的使用,以提高
ImageLoader.execute、AsyncImage、SubcomposeAsyncImage和rememberAsyncImagePainter的性能。(#2205) - 修复分块响应的重复网络调用问题。(#2363)
- 将 Kotlin 更新至 2.0.0。
- 将 Compose UI 更新至 1.6.8。
- 将 Okio 更新至 3.9.0。
[3.0.0-alpha08] - 2024 年 7 月 8 日
- 破坏性变更:将
ImageRequest和ImageLoader的dispatcher方法重命名为coroutineContext。例如,ImageRequest.Builder.dispatcher现已变更为ImageRequest.Builder.coroutineContext。重命名的原因是该方法现在接受任意CoroutineContext,不再仅限于Dispatcher。 - 修复:修复因竞态条件可能导致的
IllegalStateException: Reading a state that was created after the snapshot was taken or in a snapshot that has not yet been applied。- 注意:此修改重新引入了对
Dispatchers.Main.immediate的软依赖。因此,在 JVM 上应重新添加对kotlinx-coroutines-swing的依赖项。若未导入,ImageRequest将无法立即调度,并在设置ImageRequest.placeholder或从内存缓存解析之前产生一帧延迟。
- 注意:此修改重新引入了对
[3.0.0-alpha07] - 2024 年 6 月 26 日
- 破坏性变更:
AsyncImagePainter默认不再等待onDraw,而是直接使用Size.ORIGINAL。- 这修复了与 Roborazzi/Paparazzi 的兼容性问题,并整体提升了测试可靠性。
- 若要恢复为等待
onDraw的行为,请将DrawScopeSizeResolver设置为你的ImageRequest.sizeResolver。
- 破坏性变更:重构多平台
ImageAPI。值得注意的是,asCoilImage已重命名为asImage。 - 破坏性变更:
AsyncImagePainter.state已更改为StateFlow<AsyncImagePainter.State>。使用collectAsState观察其值。这提升了性能。 - 破坏性变更:
AsyncImagePainter.imageLoader和AsyncImagePainter.request已合并为StateFlow<AsyncImagePainter.Inputs>。使用collectAsState观察其值。这提升了性能。 - 破坏性变更:移除对
android.resource://example.package.name/drawable/imageURI 的支持,因为它会阻碍资源缩减优化。- 如果仍需要该功能,可以在组件注册表中手动包含
ResourceUriMapper。
- 如果仍需要该功能,可以在组件注册表中手动包含
- 新增:引入
AsyncImagePreviewHandler,以支持控制AsyncImagePainter的预览渲染行为。- 使用
LocalAsyncImagePreviewHandler覆盖预览行为。 - 作为此更改和其他
coil-compose改进的一部分,AsyncImagePainter现在默认尝试执行ImageRequest,而不是默认显示ImageRequest.placeholder。在预览环境中,使用网络或文件的请求预计会失败,但 Android 资源应该可以正常工作。
- 使用
- 新增:支持按帧索引提取视频图像。(#2183)
- 新增:支持向任何
CoroutineDispatcher方法传递CoroutineContext。(#2241)。 - 新增:在 JS 和 WASM JS 上支持弱引用内存缓存。
- 在 Compose 中不调度到
Dispatchers.Main.immediate。附带影响是在 JVM 上不再需要导入kotlinx-coroutines-swing。 - 在 Compose 中不调用
async也不创建 disposable 以提高性能(感谢 @mlykotom!)。(#2205) - 修复向
Options传递全局ImageLoaderextras 的问题。(#2223) - 修复
crossfade(false)在非 Android 目标上不起作用的问题。 - 修复 VP8X 功能标志字节偏移量。(#2199)
- 将非 Android 目标上的
SvgDecoder改为渲染至 Bitmap,而不是在绘制时渲染图像。这提升了性能。- 可以使用
SvgDecoder(renderToBitmap)控制此行为。
- 可以使用
- 将
ScaleDrawable从coil-gif移至coil-core。 - 将 Kotlin 更新至 2.0.0。
- 将 Compose 更新至 1.6.11。
- 将 Okio 更新至 3.9.0。
- 将 Skiko 更新至 0.8.4。
- 要查看 3.x 中的完整重要变更列表,请查阅升级指南。
[3.0.0-alpha06] - 2024 年 2 月 29 日
- 将 Skiko 降级至 0.7.93。
- 要查看 3.x 中的完整重要变更列表,请查阅升级指南。
[3.0.0-alpha05] - 2024 年 2 月 28 日
- 新增:支持
wasmJs目标。 - 创建
DrawablePainter和DrawableImage,以支持在非 Android 平台上绘制非Bitmap支持的Image。ImageAPI 属于实验性质,在 Alpha 各版本之间可能会发生变动。
- 更新
ContentPainterModifier以实现Modifier.Node。 - 修复:在后台线程上延迟注册组件回调和网络观察程序。这修复了通常在主线程上发生的初始化缓慢问题。
- 修复:修复
ImageRequest未使用ImageLoader.Builder.placeholder/error/fallback的问题。 - 将 Compose 更新至 1.6.0。
- 将 Coroutines 更新至 1.8.0。
- 将 Okio 更新至 3.8.0。
- 将 Skiko 更新至 0.7.94。
- 要查看 3.x 中的完整重要变更列表,请查阅升级指南。
[2.6.0] - 2024 年 2 月 23 日
- 使
rememberAsyncImagePainter、AsyncImage和SubcomposeAsyncImage成为可重启和可跳过的。通过避免在可组合项的实参未发生更改时进行重组,提升了性能。- 为
rememberAsyncImagePainter、AsyncImage和SubcomposeAsyncImage添加可选的modelEqualityDelegate实参,用于控制model是否会触发重组。
- 为
- 更新
ContentPainterModifier以实现Modifier.Node。 - 修复:在后台线程上延迟注册组件回调和网络观察程序。这修复了通常在主线程上发生的初始化缓慢问题。
- 修复:在
rememberAsyncImagePainter、AsyncImage和SubcomposeAsyncImage中,若ImageRequest.listener或ImageRequest.target发生更改,避免重新发起新的图像请求。 - 修复:避免在
AsyncImagePainter中对图像请求进行重复观察。 - 将 Kotlin 更新至 1.9.22。
- 将 Compose 更新至 1.6.1。
- 将 Okio 更新至 3.8.0。
- 将
androidx.collection更新至 1.4.0。 - 将
androidx.lifecycle更新至 2.7.0。
[3.0.0-alpha04] - 2024 年 2 月 1 日
- 破坏性变更:从
OkHttpNetworkFetcherFactory和KtorNetworkFetcherFactory的公共 API 中移除Lazy。 - 在
OkHttpNetworkFetcherFactory中公开Call.Factory而不是OkHttpClient。 - 将
NetworkResponseBody转换为包装ByteString。 - 将 Compose 降级至 1.5.12。
- 要查看完整的重要变更列表,请查阅升级指南。
[3.0.0-alpha03] - 2024 年 1 月 20 日
- 破坏性变更:
coil-network已重命名为coil-network-ktor。此外,新增了依赖 OkHttp 且不需要指定 Ktor 引擎的coil-network-okhttp构件。- 取决于导入的构件,你可以使用
KtorNetworkFetcherFactory或OkHttpNetworkFetcherFactory手动引用Fetcher.Factory。
- 取决于导入的构件,你可以使用
- 支持在 Apple 平台上加载
NSUrl。 - 为
AsyncImage添加clipToBounds形参。 - 要查看完整的重要变更列表,请查阅升级指南。
[3.0.0-alpha02] - 2024 年 1 月 10 日
- 破坏性变更:
coil-gif、coil-network、coil-svg和coil-video的包已更新,使其所有类分别归属于coil.gif、coil.network、coil.svg和coil.video。这有助于避免与其他构件的类名冲突。 - 破坏性变更:
ImageDecoderDecoder已重命名为AnimatedImageDecoder。 - 新增:
coil-gif、coil-network、coil-svg和coil-video的组件现在会自动添加到每个ImageLoader的ComponentRegistry中。- 明确地说,与
3.0.0-alpha01不同,你无需手动将NetworkFetcher.Factory()添加到你的ComponentRegistry中。只需导入io.coil-kt.coil3:coil-network:[version]和一个 Ktor 引擎即可加载网络图像。 - 手动将这些组件添加到
ComponentRegistry也是安全的。任何手动添加的组件都优先于自动添加的组件。 - 如有需要,可以使用
ImageLoader.Builder.serviceLoaderEnabled(false)禁用此行为。
- 明确地说,与
- 新增:在所有平台上支持
coil-svg。它在 Android 上由 AndroidSVG 支持,在非 Android 平台上由 SVGDOM 支持。 - Coil 现在内部使用 Android 的
ImageDecoderAPI,这在直接从文件、资源或 content URI 解码时具有性能优势。 - 修复:多处
coil3.Uri解析修复。 - 要查看完整的重要变更列表,请查阅升级指南。
[3.0.0-alpha01] - 2023 年 12 月 30 日
- 新增:Compose Multiplatform 支持。Coil 现已成为一个 Kotlin Multiplatform 库,支持 Android、JVM、iOS、macOS 和 JavaScript。
- Coil 的 Maven 坐标已更新为
io.coil-kt.coil3,其导入语句已更新为coil3。这使得 Coil 3 可以与 Coil 2 并存运行而不会产生二进制兼容性问题。例如,io.coil-kt:coil:[version]现在是io.coil-kt.coil3:coil:[version]。 coil-base和coil-compose-base构件分别重命名为coil-core和coil-compose-core,以符合 Coroutines、Ktor 和 AndroidX 所使用的命名规范。- 要查看完整的重要变更列表,请查阅升级指南。
[2.5.0] - 2023 年 10 月 30 日
- 新增:添加
MediaDataSourceFetcher.Factory以支持在coil-video中解码MediaDataSource实现。(#1795) - 将
SHIFT6m设备添加到硬件 Bitmap 黑名单中。(#1812) - 修复:防范返回单边无界尺寸的绘制器。(#1826)
- 修复:当缓存的标头包含非 ASCII 字符时,在
304 Not Modified后磁盘缓存加载失败的问题。(#1839) - 修复:
FakeImageEngine未更新拦截器链的请求的问题。(#1905) - 将编译 SDK 更新至 34。
- 将 Kotlin 更新至 1.9.10。
- 将 Coroutines 更新至 1.7.3。
- 将
accompanist-drawablepainter更新至 0.32.0。 - 将
androidx.annotation更新至 1.7.0。 - 将
androidx.compose.foundation更新至 1.5.4。 - 将
androidx.core更新至 1.12.0。 - 将
androidx.exifinterface:exifinterface更新至 1.3.6。 - 将
androidx.lifecycle更新至 2.6.2。 - 将
com.squareup.okhttp3更新至 4.12.0。 - 将
com.squareup.okio更新至 3.6.0。
[2.4.0] - 2023 年 5 月 21 日
- 将
DiskCache的get/edit重命名为openSnapshot/openEditor。 - 在
AsyncImagePainter中不再自动将ColorDrawable转换为ColorPainter。 - 使用
@NonRestartableComposable注解简单的AsyncImage重载。 - 修复:在
ImageSource中延迟调用Context.cacheDir。 - 修复:修复发布
coil-bom的问题。 - 修复:修复在禁用硬件 Bitmap 时始终将 Bitmap 配置设置为
ARGB_8888的问题。 - 将 Kotlin 更新至 1.8.21。
- 将 Coroutines 更新至 1.7.1。
- 将
accompanist-drawablepainter更新至 0.30.1。 - 将
androidx.compose.foundation更新至 1.4.3。 - 将
androidx.profileinstaller:profileinstaller更新至 1.3.1。 - 将
com.squareup.okhttp3更新至 4.11.0。
[2.3.0] - 2023 年 3 月 25 日
- 新增:引入新的
coil-test构件,其中包含FakeImageLoaderEngine。该类可用于硬编码图像加载器响应,以确保在测试中获得一致且同步(来自主线程)的响应。更多信息请参见此处。 - 新增:向
coil-base(coil的子模块)和coil-compose-base(coil-compose的子模块)添加基准配置文件。- 这提升了 Coil 的运行时性能,并根据 Coil 在应用中的使用方式提供更好的帧时间。
- 修复:修复解析包含编码数据的
file://URI 的问题。#1601 - 修复:如果传递了不存在的目录,
DiskCache现在可以正确计算其最大大小。#1620 - 将
Coil.reset作为公共 API。#1506 - 启用 Java 默认方法生成。#1491
- 将 Kotlin 更新至 1.8.10。
- 将
accompanist-drawablepainter更新至 0.30.0。 - 将
androidx.annotation更新至 1.6.0。 - 将
androidx.appcompat:appcompat-resources更新至 1.6.1。 - 将
androidx.compose.foundation更新至 1.4.0。 - 将
androidx.core更新至 1.9.0。 - 将
androidx.exifinterface:exifinterface更新至 1.3.6。 - 将
androidx.lifecycle更新至 2.6.1。 - 将
okio更新至 3.3.0。
[2.2.2] - 2022 年 10 月 1 日
- 确保图像加载器在注册其系统回调之前已完全初始化。#1465
- 在 API 30+ 上的
VideoFrameDecoder中设置首选 Bitmap 配置以避免色带问题。#1487 - 修复
FileUriMapper中解析包含#的路径的问题。#1466 - 修复从磁盘缓存读取包含非 ASCII 标头的响应的问题。#1468
- 修复解码 asset 子文件夹中的视频的问题。#1489
- 将
androidx.annotation更新至 1.5.0。
[2.2.1] - 2022 年 9 月 8 日
- 修复:
RoundedCornersTransformation现在能正确缩放inputBitmap。 - 移除对
kotlin-parcelize插件的依赖。 - 将编译 SDK 更新至 33。
- 将
androidx.appcompat:appcompat-resources降级至 1.4.2 以解决 #1423。
[2.2.0] - 2022 年 8 月 16 日
- 新增:向
coil-video添加ImageRequest.videoFramePercent,以支持将视频帧指定为视频时长的百分比。 - 新增:添加
ExifOrientationPolicy以配置BitmapFactoryDecoder如何处理 EXIF 方向数据。 - 修复:若传递了未定义维度的尺寸,
RoundedCornersTransformation不再抛出异常。 - 修复:将 GIF 的帧延迟读取为两个无符号字节,而不是一个有符号字节。
- 将 Kotlin 更新至 1.7.10。
- 将 Coroutines 更新至 1.6.4。
- 将 Compose 更新至 1.2.1。
- 将 OkHttp 更新至 4.10.0。
- 将 Okio 更新至 3.2.0。
- 将
accompanist-drawablepainter更新至 0.25.1。 - 将
androidx.annotation更新至 1.4.0。 - 将
androidx.appcompat:appcompat-resources更新至 1.5.0。 - 将
androidx.core更新至 1.8.0。
[2.1.0] - 2022 年 5 月 17 日
- 新增:支持加载
ByteArray。(#1202) - 新增:支持使用
ImageRequest.Builder.css为 SVG 设置自定义 CSS 规则。(#1210) - 修复:将
GenericViewTarget的私有方法转换为 protected。(#1273) - 将编译 SDK 更新至 32。(#1268)
[2.0.0] - 2022 年 5 月 10 日
Coil 2.0.0 是该库的一次重大迭代,包含破坏性变更。有关如何升级,请查阅升级指南。
- 新增:在
coil-compose中引入AsyncImage。更多信息请查看文档。
kotlin
// 显示来自网络的图像。
AsyncImage(
model = "https://example.com/image.jpg",
contentDescription = null,
)
// 显示来自网络的图像,带有占位符、圆形裁剪和淡入淡出动画。
AsyncImage(
model = ImageRequest.Builder(LocalContext.current)
.data("https://example.com/image.jpg")
.crossfade(true)
.build(),
placeholder = painterResource(R.drawable.placeholder),
contentDescription = stringResource(R.string.description),
contentScale = ContentScale.Crop,
modifier = Modifier.clip(CircleShape)
)- 新增:引入公共
DiskCacheAPI。- 使用
ImageLoader.Builder.diskCache和DiskCache.Builder配置磁盘缓存。 - 在 Coil 2.0 中不应使用 OkHttp 的
Cache。更多信息请参见此处。 - 仍然支持
Cache-Control和其他缓存标头——但不支持Vary标头,因为缓存仅检查 URL 是否匹配。此外,仅缓存响应代码在 [200..300) 范围内的响应。 - 升级到 2.0 时,现有的磁盘缓存将被清除。
- 使用
- 最低支持的 API 现为 21。
ImageRequest的默认Scale现在为Scale.FIT。- 进行此更改是为了让
ImageRequest.scale与其他具有默认Scale的类保持一致。 - 具有
ImageViewTarget的请求仍会自动检测其Scale。
- 进行此更改是为了让
- 重构图像流水线(pipeline)类:
Mapper、Fetcher和Decoder经过重构,更加灵活。Fetcher.key已替换为新的Keyer接口。Keyer根据输入数据创建缓存键。- 添加
ImageSource,允许Decoder直接使用 Okio 的文件系统 API 读取File。
- 重构 Jetpack Compose 集成:
rememberImagePainter和ImagePainter分别重命名为rememberAsyncImagePainter和AsyncImagePainter。- 弃用
LocalImageLoader。有关更多信息,请查阅弃用信息。
- 禁用生成运行时非空断言。
- 如果使用 Java,向函数传递带有非空注解的 null 实参将不再立即抛出
NullPointerException。Kotlin 的编译时空安全可防止这种情况发生。 - 此更改有助于减小库的大小。
- 如果使用 Java,向函数传递带有非空注解的 null 实参将不再立即抛出
Size现在由表示其宽度和高度的两个Dimension值组成。Dimension可以是正像素值或Dimension.Undefined。更多信息请参见此处。- 从库中移除了
BitmapPool和PoolableViewTarget。 - 从库中移除了
VideoFrameFileFetcher和VideoFrameUriFetcher。改用支持所有数据源的VideoFrameDecoder。 - 从库中移除了
BlurTransformation和GrayscaleTransformation。如果仍在使用它们,可以将它们的代码复制到项目中。 - 将
Transition.transition修改为非挂起函数,因为不再需要挂起过渡直到其完成。 - 添加对
bitmapFactoryMaxParallelism的支持,用于限制正在进行的BitmapFactory操作的最大数量。该值默认为 4,有助于提高 UI 性能。 - 添加对
interceptorDispatcher、fetcherDispatcher、decoderDispatcher和transformationDispatcher的支持。 - 添加用于处理通用
ViewTarget逻辑的GenericViewTarget。 - 将
ByteBuffer添加到默认支持的数据类型中。 Disposable经过重构,公开底层ImageRequest的作业(job)。- 重构
MemoryCacheAPI。 - 若
ImageRequest.fallback为 null,现在会在Target上设置ImageRequest.error。 Transformation.key替换为Transformation.cacheKey。- 将 Kotlin 更新至 1.6.10。
- 将 Compose 更新至 1.1.1。
- 将 OkHttp 更新至 4.9.3。
- 将 Okio 更新至 3.0.0。
自 2.0.0-rc03 以来的变更:
- 将
Dimension.Original转换为Dimension.Undefined。- 这稍微改变了非像素维度的语义,以修复尺寸系统中的某些边缘情况(示例)。
- 如果 ContentScale 为 None,则使用
Size.ORIGINAL加载图像。 - 修复先应用
ImageView.load构建器实参而非最后应用的问题。 - 修复如果响应未修改则不合并 HTTP 标头的问题。
[2.0.0-rc03] - 2022 年 4 月 11 日
- 移除
ScaleResolver接口。 - 将
Size构造函数转换为函数。 - 将
Dimension.Pixels的toString修改为仅输出其像素值。 - 防范
SystemCallbacks.onTrimMemory中罕见的崩溃。 - 将 Coroutines 更新至 1.6.1。
[2.0.0-rc02] - 2022 年 3 月 20 日
- 将
ImageRequest的默认尺寸恢复为当前屏幕的尺寸,而不是Size.ORIGINAL。 - 修复
DiskCache.Builder被标记为实验性的问题。只有DiskCache的方法属于实验性质。 - 修复将图像加载到具有
WRAP_CONTENT单边维度的ImageView时,会以原始尺寸加载图像而不是适配有界维度的问题。 - 移除
MemoryCache.Key、MemoryCache.Value和Parameters.Entry中的解构组件函数(component functions)。
[2.0.0-rc01] - 2022 年 3 月 2 日
自 1.4.0 以来的重大变更:
- 最低支持的 API 现为 21。
- 重构 Jetpack Compose 集成。
rememberImagePainter已重命名为rememberAsyncImagePainter。- 添加对
AsyncImage和SubcomposeAsyncImage的支持。更多信息请查看文档。 - 弃用
LocalImageLoader。有关更多信息,请查阅弃用信息。
- Coil 2.0 拥有自己的磁盘缓存实现,不再依赖 OkHttp 进行磁盘缓存。
- 使用
ImageLoader.Builder.diskCache和DiskCache.Builder配置磁盘缓存。 - 不应在 Coil 2.0 中使用 OkHttp 的
Cache,因为如果在写入时线程被中断,缓存可能会损坏。 - 仍然支持
Cache-Control和其他缓存标头——但不支持Vary标头,因为缓存仅检查 URL 是否匹配。此外,仅缓存响应代码在 [200..300) 范围内的响应。 - 升级到 2.0 时,现有的磁盘缓存将被清除。
- 使用
ImageRequest的默认Scale现在为Scale.FIT。- 进行此更改是为了让
ImageRequest.scale与其他具有默认Scale的类保持一致。 - 具有
ImageViewTarget的请求仍会自动检测其缩放比例。
- 进行此更改是为了让
ImageRequest的默认尺寸现在为Size.ORIGINAL。- 重构图像流水线类:
Mapper、Fetcher和Decoder经过重构,更加灵活。Fetcher.key已替换为新的Keyer接口。Keyer根据输入数据创建缓存键。- 添加
ImageSource,允许Decoder直接使用 Okio 的文件系统 API 读取File。
- 禁用生成运行时非空断言。
- 如果使用 Java,向函数传递带有非空注解的形参作为 null 将不再立即抛出
NullPointerException。Kotlin 的编译时空安全可防止这种情况发生。 - 此更改有助于减小库的大小。
- 如果使用 Java,向函数传递带有非空注解的形参作为 null 将不再立即抛出
Size现在由表示其宽度和高度的两个Dimension值组成。Dimension可以是正像素值或Dimension.Original。- 从库中移除了
BitmapPool和PoolableViewTarget。 - 从库中移除了
VideoFrameFileFetcher和VideoFrameUriFetcher。改用支持所有数据源的VideoFrameDecoder。 - 从库中移除了
BlurTransformation和GrayscaleTransformation。如果仍在使用它们,可以将它们的代码复制到项目中。 - 将
Transition.transition修改为非挂起函数,因为不再需要挂起过渡直到其完成。 - 添加对
bitmapFactoryMaxParallelism的支持,用于限制正在进行的BitmapFactory操作的最大数量。该值默认为 4,有助于提高 UI 性能。 - 添加对
interceptorDispatcher、fetcherDispatcher、decoderDispatcher和transformationDispatcher的支持。 - 添加用于处理通用
ViewTarget逻辑的GenericViewTarget。 - 将
ByteBuffer添加到默认支持的数据类型中。 Disposable经过重构,公开底层ImageRequest的作业。- 重构
MemoryCacheAPI。 - 若
ImageRequest.fallback为 null,现在会在Target上设置ImageRequest.error。 Transformation.key替换为Transformation.cacheKey。- 将 Kotlin 更新至 1.6.10。
- 将 Compose 更新至 1.1.1。
- 将 OkHttp 更新至 4.9.3。
- 将 Okio 更新至 3.0.0。
自 2.0.0-alpha09 以来的变更:
- 移除
-Xjvm-default=all编译器标志。 - 修复并发执行多个带有 must-revalidate/e-tag 的请求时导致图像加载失败的问题。
- 修复
<svg标签后若有换行符则DecodeUtils.isSvg返回 false 的问题。 - 使
LocalImageLoader.provides弃用信息更加清晰。 - 将 Compose 更新至 1.1.1。
- 将
accompanist-drawablepainter更新至 0.23.1。
[2.0.0-alpha09] - 2022 年 2 月 16 日
- 修复
AsyncImage创建无效约束的问题。(#1134) - 为
AsyncImagePainter添加ContentScale实参。(#1144)- 应将其设置为与
Image上设置的相同值,以确保图像以正确的尺寸加载。
- 应将其设置为与
- 添加
ScaleResolver以支持为ImageRequest延迟解析Scale。(#1134)ImageRequest.scale应替换为ImageRequest.scaleResolver.scale()。
- 将 Compose 更新至 1.1.0。
- 将
accompanist-drawablepainter更新至 0.23.0。 - 将
androidx.lifecycle更新至 2.4.1。
[2.0.0-alpha08] - 2022 年 2 月 7 日
- 更新
DiskCache和ImageSource以使用 Okio 的FileSystemAPI。(#1115)
[2.0.0-alpha07] - 2022 年 1 月 30 日
- 显著提高
AsyncImage的性能,并将AsyncImage拆分为AsyncImage和SubcomposeAsyncImage。(#1048)SubcomposeAsyncImage提供loading/success/error/content插槽(slot)API,并使用性能较低的子组合(subcomposition)。AsyncImage提供placeholder/error/fallback实参,用于覆盖加载时或请求失败时绘制的Painter。AsyncImage不使用子组合,性能显著优于SubcomposeAsyncImage。- 从
SubcomposeAsyncImage.content中移除AsyncImagePainter.State实参。如需使用,请使用painter.state。 - 为
AsyncImage和SubcomposeAsyncImage同时添加onLoading/onSuccess/onError回调。
- 弃用
LocalImageLoader。(#1101) - 添加对
ImageRequest.tags的支持。(#1066) - 将
DecodeUtils中的isGif、isWebP、isAnimatedWebP、isHeif和isAnimatedHeif移至 coil-gif。将isSvg添加至 coil-svg。(#1117) - 将
FetchResult和DecodeResult转换为非数据类。(#1114) - 移除未使用的
DiskCache.Buildercontext 实参。(#1099) - 修复具有原始尺寸的 Bitmap 资源的缩放问题。(#1072)
- 修复
ImageDecoderDecoder中未能关闭ImageDecoder的问题。(#1109) - 修复将 Drawable 转换为 Bitmap 时缩放不正确的问题。(#1084)
- 将 Compose 更新至 1.1.0-rc03。
- 将
accompanist-drawablepainter更新至 0.22.1-rc。 - 将
androidx.appcompat:appcompat-resources更新至 1.4.1。
[2.0.0-alpha06] - 2021 年 12 月 24 日
- 添加
ImageSource.Metadata,以支持无需缓冲或临时文件即可从 asset、资源和 content URI 中进行解码。(#1060) - 延迟执行图像请求,直到
AsyncImage获得正向约束。(#1028) - 修复当同时设置了
loading、success和error时AsyncImage使用DefaultContent的问题。(#1026) - 使用 androidx
LruCache替代平台的LruCache。(#1047) - 将 Kotlin 更新至 1.6.10。
- 将 Coroutines 更新至 1.6.0。
- 将 Compose 更新至 1.1.0-rc01。
- 将
accompanist-drawablepainter更新至 0.22.0-rc。 - 将
androidx.collection更新至 1.2.0。
[2.0.0-alpha05] - 2021 年 11 月 28 日
- 重要:重构
Size,以支持针对任一维度使用图像的原始尺寸。Size现在由表示其宽度和高度的两个Dimension值组成。Dimension可以是正像素值或Dimension.Original。- 进行此项更改是为了在某一维度为固定像素值时,更好地支持无界宽度/高度值(例如
wrap_content、Constraints.Infinity)。
- 修复:支持
AsyncImage的检查模式(预览)。 - 修复:如果
imageLoader.memoryCache为 null,则SuccessResult.memoryCacheKey始终应为null。 - 将类似构造函数的
ImageLoader、SizeResolver和ViewSizeResolver的invoke函数转换为顶层函数。 - 将
CrossfadeDrawable的起始和结束 Drawable 设为公共 API。 - 对
ImageLoader的 placeholder/error/fallback Drawable 进行 mutate 操作。 - 向
SuccessResult的构造函数添加默认实参。 - 依赖于
androidx.collection而不是androidx.collection-ktx。 - 将 OkHttp 更新至 4.9.3。
[2.0.0-alpha04] - 2021 年 11 月 22 日
- 新增:向
coil-compose添加AsyncImage。AsyncImage是一个异步执行ImageRequest并渲染结果的可组合项。- 在大多数用例中,
AsyncImage旨在替代rememberImagePainter。 - 其 API 尚未最终定型,在 2.0 正式发布前可能会有变动。
- 它拥有与
Image类似的 API,并支持相同的实参:Alignment、ContentScale、alpha、ColorFilter和FilterQuality。 - 它支持使用
content、loading、success和error实参覆盖每个AsyncImagePainter状态所绘制的内容。 - 它修复了
rememberImagePainter在解析图像尺寸和缩放比例时的诸多设计问题。 - 使用示例:
kotlin
// 仅绘制图像。
AsyncImage(
model = "https://example.com/image.jpg",
contentDescription = null, // 尽量避免使用 `null`,尽可能将其设置为本地化字符串。
)
// 绘制具有圆形裁剪、淡入淡出的图像,并覆盖 `loading` 状态。
AsyncImage(
model = ImageRequest.Builder(LocalContext.current)
.data("https://example.com/image.jpg")
.crossfade(true)
.build(),
contentDescription = null,
modifier = Modifier
.clip(CircleShape),
loading = {
CircularProgressIndicator()
},
contentScale = ContentScale.Crop
)
// 绘制具有圆形裁剪、淡入淡出的图像,并覆盖所有状态。
AsyncImage(
model = ImageRequest.Builder(LocalContext.current)
.data("https://example.com/image.jpg")
.crossfade(true)
.build(),
contentDescription = null,
modifier = Modifier
.clip(CircleShape),
contentScale = ContentScale.Crop
) { state ->
if (state is AsyncImagePainter.State.Loading) {
CircularProgressIndicator()
} else {
AsyncImageContent() // 绘制图像。
}
}- 重要:将
ImagePainter重命名为AsyncImagePainter,将rememberImagePainter重命名为rememberAsyncImagePainter。- 不再支持
ExecuteCallback。若要让AsyncImagePainter跳过等待调用onDraw,请改为设置ImageRequest.size(OriginalSize)(或任意尺寸)。 - 为
rememberAsyncImagePainter添加可选的FilterQuality实参。
- 不再支持
- 在
DiskCache中使用协程进行清理操作,并添加DiskCache.Builder.cleanupDispatcher。 - 修复使用
ImageLoader.Builder.placeholder设置占位图时的 Compose 预览。 - 使用
@ReadOnlyComposable标记LocalImageLoader.current以生成更高效的代码。 - 将 Compose 更新至 1.1.0-beta03,并依赖于
compose.foundation而不是compose.ui。 - 将
androidx.appcompat-resources更新至 1.4.0。
[2.0.0-alpha03] - 2021 年 11 月 12 日
- 添加在 Android 29+ 上加载音乐缩略图的功能。(#967)
- 修复:使用
context.resources加载当前软件包的资源。(#968) - 修复:
clear->dispose的替换表达式。(#970) - 将 Compose 更新至 1.0.5。
- 将
accompanist-drawablepainter更新至 0.20.2。 - 将 Okio 更新至 3.0.0。
- 将
androidx.annotation更新至 1.3.0。 - 将
androidx.core更新至 1.7.0。 - 将
androidx.lifecycle更新至 2.4.0。- 移除对
lifecycle-common-java8的依赖,因为其已合并入lifecycle-common。
- 移除对
[2.0.0-alpha02] - 2021 年 10 月 24 日
- 添加新的
coil-bom构件,包含物料清单 (BOM)。- 导入
coil-bom可让你在无需指定版本的情况下依赖其他 Coil 构件。
- 导入
- 修复使用
ExecuteCallback.Immediate时加载图像失败的问题。 - 将 Okio 更新至 3.0.0-alpha.11。
- 这同时也解决了与 Okio 3.0.0-alpha.11 的兼容性问题。
- 将 Kotlin 更新至 1.5.31。
- 将 Compose 更新至 1.0.4。
[2.0.0-alpha01] - 2021 年 10 月 11 日
Coil 2.0.0 是该库的下一个重大迭代版本,具有新功能、性能改进、API 改进以及各种错误修复。在 2.0.0 正式发布之前,本版本可能与后续的 Alpha 版本存在二进制/源码级的不兼容。
- 重要:最低支持的 API 现为 21。
- 重要:启用
-Xjvm-default=all。 - 重要:Coil 现在拥有自己的磁盘缓存实现,不再依赖 OkHttp 进行磁盘缓存。
- 做出此项更改是为了:
- 更好地支持解码图像时的线程中断。当频繁快速地启动和停止图像请求时,这能提升性能。
- 支持公开由
File支持的ImageSource。当 Android API 需要File进行解码(例如MediaMetadataRetriever)时,这可以避免不必要的复制。 - 支持直接读写磁盘缓存文件。
- 使用
ImageLoader.Builder.diskCache和DiskCache.Builder配置磁盘缓存。 - 不应在 Coil 2.0 中使用 OkHttp 的
Cache,因为如果在写入时被中断,缓存可能会损坏。 - 仍然支持
Cache-Control和其他缓存标头——但不支持Vary标头,因为缓存仅检查 URL 是否匹配。此外,仅缓存响应代码在 [200..300) 范围内的响应。 - 可以使用
ImageLoader.Builder.respectCacheHeaders启用或禁用对缓存标头的支持。 - 升级到 2.0 时,现有的磁盘缓存将被清除并重建。
- 做出此项更改是为了:
- 重要:
ImageRequest的默认Scale现在为Scale.FIT。- 进行此更改是为了让
ImageRequest.scale与其他具有默认Scale的类保持一致。 - 具有
ImageViewTarget的请求仍会自动检测其缩放比例。
- 进行此更改是为了让
- 对图像流水线类的重大更改:
Mapper、Fetcher和Decoder经过重构,更加灵活。Fetcher.key已替换为新的Keyer接口。Keyer根据输入数据创建缓存键。- 添加
ImageSource,允许Decoder直接解码File。
- 从库中移除了
BitmapPool和PoolableViewTarget。移除 Bitmap 池化(pooling)的原因是:- 它在 <= API 23 上最有效,但在更新的 Android 版本中效果逐渐减弱。
- 移除 Bitmap 池化后,Coil 可以使用不可变 Bitmap,这带来了性能收益。
- 管理 Bitmap 池存在运行时开销。
- Bitmap 池化会对 Coil 的 API 产生设计限制,因为它需要跟踪 Bitmap 是否符合池化条件。移除 Bitmap 池化允许 Coil 在更多地方公开结果
Drawable(例如Listener、Disposable)。此外,这意味着 Coil 不必清除ImageView,而清除操作可能会引发问题。 - Bitmap 池化容易出错。分配新的 Bitmap 比尝试复用可能仍在使用中的 Bitmap 要安全得多。
- 重构
MemoryCache使其更加灵活。 - 禁用生成运行时非空断言。
- 如果使用 Java,向函数传递带有非空注解的形参作为 null 将不再立即抛出
NullPointerException。如果使用 Kotlin,则基本没有变化。 - 此更改有助于减小库的大小。
- 如果使用 Java,向函数传递带有非空注解的形参作为 null 将不再立即抛出
- 从库中移除了
VideoFrameFileFetcher和VideoFrameUriFetcher。改用支持所有数据源的VideoFrameDecoder。 - 添加对
bitmapFactoryMaxParallelism的支持,用于限制正在进行的BitmapFactory操作的最大数量。该值默认为 4,有助于提高 UI 性能。 - 添加对
interceptorDispatcher、fetcherDispatcher、decoderDispatcher和transformationDispatcher的支持。 Disposable经过重构,公开底层ImageRequest的作业。- 将
Transition.transition修改为非挂起函数,因为不再需要挂起过渡直到其完成。 - 添加用于处理通用
ViewTarget逻辑的GenericViewTarget。 - 从库中移除了
BlurTransformation和GrayscaleTransformation。- 如果仍在使用它们,可以将它们的代码复制到项目中。
- 若
ImageRequest.fallback为 null,现在会在Target上设置ImageRequest.error。 Transformation.key替换为Transformation.cacheKey。ImageRequest.Listener分别在onSuccess和onError中返回SuccessResult/ErrorResult。- 将
ByteBuffer添加到默认支持的数据类型中。 - 移除多个类中的
toString实现。 - 将 OkHttp 更新至 4.9.2。
- 将 Okio 更新至 3.0.0-alpha.10。
[1.4.0] - 2021 年 10 月 6 日
- 新增:向
ImagePainter.State.Success和ImagePainter.State.Error添加ImageResult。(#887)- 这对
ImagePainter.State.Success和ImagePainter.State.Error的签名构成了二进制不兼容变更,但这些 API 被标记为实验性。
- 这对
- 仅当
View.isShown为true时才执行CrossfadeTransition。先前仅检查View.isVisible。(#898) - 修复因舍入问题导致缩放倍数略小于 1 时可能发生的内存缓存未命中。(#899)
- 将非内联的
ComponentRegistry方法公开。(#925) - 依赖于
accompanist-drawablepainter并移除 Coil 的自定义DrawablePainter实现。(#845) - 移除对 Java 8 方法的使用以防止脱糖问题。(#924)
- 将
ImagePainter.ExecuteCallback提升为稳定 API。(#927) - 将 compileSdk 更新至 31。
- 将 Kotlin 更新至 1.5.30。
- 将 Coroutines 更新至 1.5.2。
- 将 Compose 更新至 1.0.3。
[1.3.2] - 2021 年 8 月 4 日
coil-compose现在依赖于compose.ui而不是compose.foundation。compose.ui是一个更轻量的依赖项,因为它是compose.foundation的子集。
- 将 Jetpack Compose 更新至 1.0.1。
- 将 Kotlin 更新至 1.5.21。
- 将 Coroutines 更新至 1.5.1。
- 将
androidx.exifinterface:exifinterface更新至 1.3.3。
[1.3.1] - 2021 年 7 月 28 日
- 将 Jetpack Compose 更新至
1.0.0。热烈祝贺 Compose 团队推出稳定版本! - 将
androidx.appcompat:appcompat-resources更新至 1.3.1。
[1.3.0] - 2021 年 7 月 10 日
- 新增:添加对 Jetpack Compose 的支持。基于 Accompanist 的 Coil 集成,但包含多项改动。更多信息请查看文档。
- 添加
allowConversionToBitmap以启用/禁用Transformation的自动 Bitmap 转换。(#775) - 向
ImageDecoderDecoder和GifDecoder添加enforceMinimumFrameDelay,以便在 GIF 的帧延迟低于阈值时重写该延迟。(#783)- 该选项默认禁用,但会在未来版本中默认启用。
- 添加对启用/禁用
ImageLoader内部网络观察程序的支持。(#741) - 修复
BitmapFactoryDecoder解码出的 Bitmap 的密度。(#776) - 修复 Licensee 找不到 Coil 许可证 URL 的问题。(#774)
- 将
androidx.core:core-ktx更新至 1.6.0。
[1.2.2] - 2021 年 6 月 4 日
- 修复将具有共享状态的 Drawable 转换为 Bitmap 时的竞态条件。(#771)
- 修复
ImageLoader.Builder.fallback设置了errorDrawable 而非fallbackDrawable 的问题。 - 修复
ResourceUriFetcher返回错误数据源的问题。(#770) - 修复在 API 26 和 27 上针对无可用文件描述符的日志检查。
- 修复平台矢量 Drawable 支持的版本检查错误。(#751)
- 更新 Kotlin (1.5.10)。
- 更新 Coroutines (1.5.0)。
- 将
androidx.appcompat:appcompat-resources更新至 1.3.0。 - 将
androidx.core:core-ktx更新至 1.5.0。
[1.2.1] - 2021 年 4 月 27 日
- 修复
VideoFrameUriFetcher尝试处理 http/https URI 的问题。(#734)
[1.2.0] - 2021 年 4 月 12 日
- 重要:在
SvgDecoder中使用 SVG 的视图边界(view bounds)来计算其宽高比。(#688)- 此前,
SvgDecoder使用 SVG 的width/height元素来确定宽高比,但这并未正确遵循 SVG 规范。 - 若要恢复旧行为,请在构建
SvgDecoder时设置useViewBoundsAsIntrinsicSize = false。
- 此前,
- 新增:添加
VideoFrameDecoder以支持从任意来源解码视频帧。(#689) - 新增:支持使用源内容而非仅根据 MIME 类型进行自动 SVG 检测。(#654)
- 新增:支持使用
ImageLoader.newBuilder()共享资源。(#653)- 重要的是,这支持在
ImageLoader实例之间共享内存缓存。
- 重要的是,这支持在
- 新增:使用
AnimatedTransformation添加对动图变换的支持。(#659) - 新增:添加对动画 Drawable 的启动/结束回调的支持。(#676)
- 修复解析 HEIF/HEIC 文件的 EXIF 数据的问题。(#664)
- 修复禁用 Bitmap 池化时未采用
EmptyBitmapPool实现的问题。(#638)- 即使没有此修复,Bitmap 池化仍会被正确禁用,但此前使用的是开销更大的
BitmapPool实现。
- 即使没有此修复,Bitmap 池化仍会被正确禁用,但此前使用的是开销更大的
- 修复
MovieDrawable.getOpacity错误返回透明的问题。(#682) - 防范默认临时目录不存在的情况。(#683)
- 使用 JVM IR 后端进行构建。(#670)
- 更新 Kotlin (1.4.32)。
- 更新 Coroutines (1.4.3)。
- 更新 OkHttp (3.12.13)。
- 将
androidx.lifecycle:lifecycle-common-java8更新至 2.3.1。
[1.1.1] - 2021 年 1 月 11 日
- 修复因多次恢复协程而导致
ViewSizeResolver.size抛出IllegalStateException的情况。 - 修复从主线程调用时
HttpFetcher永久阻塞的问题。- 使用
ImageRequest.dispatcher(Dispatchers.Main.immediate)强制在主线程上执行的请求将失败并抛出NetworkOnMainThreadException,除非将ImageRequest.networkCachePolicy设置为CachePolicy.DISABLED或CachePolicy.WRITE_ONLY。
- 使用
- 如果视频具有旋转元数据,旋转来自
VideoFrameFetcher的视频帧。 - 更新 Kotlin (1.4.21)。
- 更新 Coroutines (1.4.2)。
- 更新 Okio (2.10.0)。
- 更新
androidx.exifinterface:exifinterface(1.3.2)。
[1.1.0] - 2020 年 11 月 24 日
- 重要:将
CENTER和MATRIX两种ImageView缩放类型解析为OriginalSize。(#587)- 此更改仅在未显式指定请求尺寸时影响隐式尺寸解析算法。
- 进行此项更改是为了确保图像请求的视觉结果与
ImageView.setImageResource/ImageView.setImageURI保持一致。若要恢复旧行为,请在构造请求时设置ViewSizeResolver。
- 重要:如果 View 的布局参数为
WRAP_CONTENT,则从ViewSizeResolver返回屏幕尺寸。(#562)- 先前,只有在 View 完全完成布局后才会返回屏幕尺寸。这一变更使常规行为更加一致和直观。
- 添加控制 alpha 预乘(pre-multiplication)的功能。(#569)
- 在
CrossfadeDrawable中支持优先使用精确的固有尺寸。(#585) - 检查包含版本的完整 GIF 标头。(#564)
- 添加空的 Bitmap 池实现。(#561)
- 将
EventListener.Factory改为函数式接口。(#575) - 稳定
EventListener。(#574) - 为
ImageRequest.Builder.placeholderMemoryCacheKey添加String重载。 - 向
ViewSizeResolver构造函数添加@JvmOverloads。 - 修复:在
CrossfadeDrawable中对起始/结束 Drawable 进行 mutate 操作。(#572) - 修复:修复 GIF 在二次加载时不播放的问题。(#577)
- 更新 Kotlin (1.4.20) 并迁移至
kotlin-parcelize插件。 - 更新 Coroutines (1.4.1)。
[1.0.0] - 2020 年 10 月 22 日
自 0.13.0 以来的变更:
- 添加
Context.imageLoader扩展函数。(#534) - 添加
ImageLoader.executeBlocking扩展函数。(#537) - 替换单例图像加载器时不关闭前一个实例。(#533)
自 1.0.0-rc3 以来的变更:
- 修复:防范缺少/无效的 ActivityManager。(#541)
- 修复:允许 OkHttp 缓存失败的响应。(#551)
- 将 Kotlin 更新至 1.4.10。
- 将 Okio 更新至 2.9.0。
- 将
androidx.exifinterface:exifinterface更新至 1.3.1。
[1.0.0-rc3] - 2020 年 9 月 21 日
- 因不稳定原因,回滚使用
-Xjvm-default=all编译器标志。- 与以前的候选发布版本相比,这是源码兼容但二进制不兼容的更改。
- 添加
Context.imageLoader扩展函数。(#534) - 添加
ImageLoader.executeBlocking扩展函数。(#537) - 替换单例图像加载器时不关闭前一个实例。(#533)
- 更新 AndroidX 依赖项:
androidx.exifinterface:exifinterface-> 1.3.0
[1.0.0-rc2] - 2020 年 9 月 3 日
- 此版本需要 Kotlin 1.4.0 或更高版本。
- 包含 0.13.0 中的所有变更。
- 依赖于基础 Kotlin
stdlib而非stdlib-jdk8。
[0.13.0] - 2020 年 9 月 3 日
- 重要:默认在主线程上启动拦截器链。(#513)
- 这在很大程度上恢复了
0.11.0及更低版本的行为,即在主线程上同步检查内存缓存。 - 若要恢复为与
0.12.0相同的行为(在ImageRequest.dispatcher上检查内存缓存),请设置ImageLoader.Builder.launchInterceptorChainOnMainThread(false)。 - 更多信息请参阅
launchInterceptorChainOnMainThread。
- 这在很大程度上恢复了
- 修复:修复在已分离的 Fragment 中的
ViewTarget上启动请求时可能发生的内存泄漏。(#518) - 修复:使用
ImageRequest.context加载资源 URI。(#517) - 修复:修复可能导致后续请求无法保存到磁盘缓存的竞态条件。(#510)
- 修复:在 API 18 上使用
blockCountLong和blockSizeLong。
- 将
ImageLoaderFactory设为 fun 接口。 - 添加
ImageLoader.Builder.addLastModifiedToFileCacheKey,支持启用/禁用向从File加载的图像的内存缓存键添加最后修改时间戳。
- 将 Kotlin 更新至 1.4.0。
- 将 Coroutines 更新至 1.3.9。
- 将 Okio 更新至 2.8.0。
[1.0.0-rc1] - 2020 年 8 月 18 日
- 此版本需要 Kotlin 1.4.0 或更高版本。
- 将 Kotlin 更新至 1.4.0 并启用
-Xjvm-default=all。- 关于如何在构建文件中启用
-Xjvm-default=all,请参见此处。 - 这会为默认 Kotlin 接口方法生成 Java 8 默认方法。
- 关于如何在构建文件中启用
- 移除 0.12.0 中所有现存的已弃用方法。
- 将 Coroutines 更新至 1.3.9。
[0.12.0] - 2020 年 8 月 18 日
- 破坏性变更:
LoadRequest和GetRequest已替换为ImageRequest:ImageLoader.execute(LoadRequest)->ImageLoader.enqueue(ImageRequest)ImageLoader.execute(GetRequest)->ImageLoader.execute(ImageRequest)ImageRequest实现了equals/hashCode。
- 破坏性变更:许多类已重命名和/或更改了包路径:
coil.request.RequestResult->coil.request.ImageResultcoil.request.RequestDisposable->coil.request.Disposablecoil.bitmappool.BitmapPool->coil.bitmap.BitmapPoolcoil.DefaultRequestOptions->coil.request.DefaultRequestOptions
- 破坏性变更:
SparseIntArraySet已从公共 API 中移除。 - 破坏性变更:
TransitionTarget不再实现ViewTarget。 - 破坏性变更:
ImageRequest.Listener.onSuccess的签名已更改为返回ImageResult.Metadata,而不仅是DataSource。 - 破坏性变更:移除对
LoadRequest.aliasKeys的支持。该 API 更好地通过直接读/写访问内存缓存来处理。
- 重要:内存缓存中的值不再同步解析(如果从主线程调用)。
- 做出此项更改也是为了支持在后台调度器上执行
Interceptor。 - 此更改还将更多工作从主线程移出,从而提高性能。
- 做出此项更改也是为了支持在后台调度器上执行
- 重要:
Mappers现在在后台调度器上执行。附带影响是,不再自动支持自动 Bitmap 采样。若要获得相同的效果,请将前一个请求的MemoryCache.Key用作后续请求的placeholderMemoryCacheKey。请参阅此处的示例。placeholderMemoryCacheKeyAPI 提供了更多自由度,因为你可以将带有不同数据的两个图像请求“链接”起来(例如小图/大图的不同 URL)。
- 重要:Coil 的
ImageView扩展函数已从coil.api包移至coil包。- 使用查找 + 替换将
import coil.api.load重构为import coil.load。很遗憾,无法使用 Kotlin 的ReplaceWith功能来替换导入。
- 使用查找 + 替换将
- 重要:如果 Drawable 不是相同的图像,则使用标准淡入淡出。
- 重要:在 API 24+ 上优先使用不可变 Bitmap。
- 重要:已弃用
MeasuredMapper,改用新的Interceptor接口。有关如何将MeasuredMapper转换为Interceptor的示例,请参见此处。Interceptor是一个限制少得多的 API,允许使用更广泛的自定义逻辑。
- 重要:
ImageRequest.data现在为非空。如果创建ImageRequest时未设置其数据,它将返回NullRequestData作为其数据。
- 新增:添加对直接读/写访问
ImageLoader的MemoryCache的支持。有关更多信息,请查阅文档。 - 新增:添加对
Interceptor的支持。有关更多信息,请查阅文档。Coil 的Interceptor设计深受 OkHttp 的启发! - 新增:支持使用
ImageLoader.Builder.bitmapPoolingEnabled启用/禁用 Bitmap 池化。- Bitmap 池化在 API 23 及以下版本中最有效,但在 API 24 及以上版本中仍可能有益(通过积极调用
Bitmap.recycle)。
- Bitmap 池化在 API 23 及以下版本中最有效,但在 API 24 及以上版本中仍可能有益(通过积极调用
- 新增:支持在解码时中断线程。
- 修复解析 content-type 标头中的多个分段的问题。
- 重构 Bitmap 引用计数以使其更加健壮。
- 修复 API < 19 设备上的 WebP 解码问题。
- 在 EventListener API 中公开 FetchResult 和 DecodeResult。
- 使用 SDK 30 进行编译。
- 将 Coroutines 更新至 1.3.8。
- 将 OkHttp 更新至 3.12.12。
- 将 Okio 更新至 2.7.0。
- 更新 AndroidX 依赖项:
androidx.appcompat:appcompat-resources-> 1.2.0androidx.core:core-ktx-> 1.3.1
[0.11.0] - 2020 年 5 月 14 日
- 破坏性变更:此版本移除了所有现有的已弃用函数。
- 这使得可以移除 Coil 的
ContentProvider,从而在应用启动时不运行任何代码。
- 这使得可以移除 Coil 的
- 破坏性变更:将
SparseIntArraySet.size转换为 val。(#380) - 破坏性变更:将
Parameters.count()移至扩展函数。(#403) - 破坏性变更:将
BitmapPool.maxSize设为 Int。(#404)
- 重要:使
ImageLoader.shutdown()变为可选(类似于OkHttpClient)。(#385)
- 将默认内存缓存大小减少至 20%。(#390)
- 若要恢复现有行为,请在创建
ImageLoader时设置ImageLoaderBuilder.availableMemoryPercentage(0.25)。
- 若要恢复现有行为,请在创建
- 将 Coroutines 更新至 1.3.6。
- 将 OkHttp 更新至 3.12.11。
[0.10.1] - 2020 年 4 月 26 日
- 修复在 API 23 及以下版本上解码大型 PNG 时的 OOM 问题。(#372)。
- 这禁用了针对 PNG 文件的 EXIF 方向解码。PNG 的 EXIF 方向极少使用,且读取 PNG EXIF 数据(即使为空)也需要将整个文件缓冲到内存中,这对性能不利。
- 对
SparseIntArraySet进行了细微的 Java 兼容性改进。
- 将 Okio 更新至 2.6.0。
[0.10.0] - 2020 年 4 月 20 日
重点关注
此版本弃用了大部分 DSL API,转而直接使用构建器。 变更如下所示:
kotlin// 0.9.5(旧) val imageLoader = ImageLoader(context) { bitmapPoolPercentage(0.5) crossfade(true) } val disposable = imageLoader.load(context, "https://example.com/image.jpg") { target(imageView) } val drawable = imageLoader.get("https://example.com/image.jpg") { size(512, 512) } // 0.10.0(新) val imageLoader = ImageLoader.Builder(context) .bitmapPoolPercentage(0.5) .crossfade(true) .build() val request = LoadRequest.Builder(context) .data("https://example.com/image.jpg") .target(imageView) .build() val disposable = imageLoader.execute(request) val request = GetRequest.Builder(context) .data("https://example.com/image.jpg") .size(512, 512) .build() val drawable = imageLoader.execute(request).drawable- 如果使用的是
io.coil-kt:coil构件,可以调用Coil.execute(request)使用单例ImageLoader执行请求。
- 如果使用的是
ImageLoader现在具有弱引用内存缓存,用于在图像从强引用内存缓存中逐出后跟踪对它们的弱引用。- 这意味着如果某个图像仍然存在强引用,它将始终从
ImageLoader的内存缓存中返回。 - 通常,这会使内存缓存更加可预测并提高命中率。
- 可以通过
ImageLoaderBuilder.trackWeakReferences启用/禁用此行为。
- 这意味着如果某个图像仍然存在强引用,它将始终从
添加新构件
io.coil-kt:coil-video,用于从视频文件中解码特定帧。在此阅读更多信息。添加新的 EventListener API 用于指标跟踪。
添加 ImageLoaderFactory,可由你的
Application实现以简化单例初始化。
完整版本说明
- 重要:弃用 DSL 语法,改用构建器语法。(#267)
- 重要:弃用
Coil和ImageLoader扩展函数。(#322) - 破坏性变更:从
ImageLoader.execute(GetRequest)返回密封的RequestResult类型。(#349) - 破坏性变更:将
ExperimentalCoil重命名为ExperimentalCoilApi。从@Experimental迁移到@RequiresOptIn。(#306) - 破坏性变更:将
CoilLogger替换为Logger接口。(#316) - 破坏性变更:将 destWidth/destHeight 重命名为 dstWidth/dstHeight。(#275)
- 破坏性变更:重新调整
MovieDrawable构造函数的形参。(#272) - 破坏性变更:
Request.Listener的方法现在接收完整的Request对象,而不仅是其数据。 - 破坏性变更:
GetRequestBuilder构造函数现在需要Context。 - 破坏性变更:
Request上的多个属性现在可为空。 - 行为变更:默认在缓存键中包含形参值。(#319)
- 行为变更:微调
Request.Listener.onStart()的调用时机,使其在Target.onStart()后立即被调用。(#348)
- 新增:添加
WeakMemoryCache实现。(#295) - 新增:添加
coil-video以支持解码视频帧。(#122) - 新增:引入
EventListener。(#314) - 新增:引入
ImageLoaderFactory。(#311) - 新增:在 Android 11 上支持动画 HEIF 图像序列。(#297)
- 新增:改进 Java 兼容性。(#262)
- 新增:支持设置默认
CachePolicy。(#307) - 新增:支持设置默认
Bitmap.Config。(#342) - 新增:添加
ImageLoader.invalidate(key)以清除单个内存缓存项。(#55) - 新增:添加调试日志以解释为何未复用缓存图像。(#346)
- 新增:为 get 请求支持
error和fallbackDrawable。
- 修复:修复 Transformation 缩减输入 Bitmap 尺寸时的内存缓存未命中问题。(#357)
- 修复:确保 BlurTransformation 中的半径低于 RenderScript 的最大值。(#291)
- 修复:修复解码高色彩深度图像的问题。(#358)
- 修复:在 Android 11 及更高版本上禁用针对
ImageDecoderDecoder崩溃的规避处理。(#298) - 修复:修复在 API 23 之前读取 EXIF 数据失败的问题。(#331)
- 修复:修复与 Android R SDK 的不兼容问题。(#337)
- 修复:仅在
ImageView具有匹配的SizeResolver时才启用非精确尺寸。(#344) - 修复:允许缓存图像与请求尺寸最多相差一个像素。(#360)
- 修复:若 View 不可见则跳过淡入淡出过渡。(#361)
- 弃用
CoilContentProvider。(#293) - 使用
@MainThread注解多个ImageLoader方法。 - 若生命周期当前处于已启动状态,避免创建
LifecycleCoroutineDispatcher。(#356) - 对
OriginalSize.toString()使用完整包名。 - 解码软件 Bitmap 时进行预分配。(#354)
- 将 Kotlin 更新至 1.3.72。
- 将 Coroutines 更新至 1.3.5。
- 将 OkHttp 更新至 3.12.10。
- 将 Okio 更新至 2.5.0。
- 更新 AndroidX 依赖项:
androidx.exifinterface:exifinterface-> 1.2.0
[0.9.5] - 2020 年 2 月 6 日
- 修复:确保在检查 View 是否硬件加速之前已附加 View。这修复了请求硬件 Bitmap 时可能未命中内存缓存的问题。
- 更新 AndroidX 依赖项:
androidx.core:core-ktx-> 1.2.0
[0.9.4] - 2020 年 2 月 3 日
- 修复:在 ImageDecoderDecoder 中降采样时遵循宽高比。感谢 @zhanghai。
- 此前,只要内存缓存中 Bitmap 的配置大于或等于请求中指定的配置,就会返回该 Bitmap。例如,如果请求的是
ARGB_8888的 Bitmap,从内存缓存中返回的可能是RGBA_F16的 Bitmap。现在,缓存的配置与请求的配置必须完全一致。 - 在
CrossfadeDrawable和CrossfadeTransition中将scale和durationMillis设为 public。
[0.9.3] - 2020 年 2 月 1 日
- 修复:在
ScaleDrawable内平移子 Drawable 以确保其居中。 - 修复:修复 GIF 和 SVG 无法完全填满边界的问题。
- 将
HttpUrl.get()的调用推迟到后台线程。 - 改进 BitmapFactory 返回 null Bitmap 时的错误信息。
- 将 3 款设备添加到硬件 Bitmap 黑名单中。(#264)
- 更新 AndroidX 依赖项:
androidx.lifecycle:lifecycle-common-java8-> 2.2.0
[0.9.2] - 2020 年 1 月 19 日
- 修复:修复 API 19 之前版本上的 GIF 解码问题。感谢 @mario。
- 修复:修复光栅化矢量 Drawable 未被标记为已采样的问题。
- 修复:Movie 尺寸 <= 0 时抛出异常。
- 修复:修复内存缓存事件未恢复 CrossfadeTransition 的问题。
- 修复:如果被禁用,阻止向所有 target 方法返回硬件 Bitmap。
- 修复:修复 MovieDrawable 未在边界中心定位自身的问题。
- 移除 CrossfadeDrawable 的自动缩放。
- 将
BitmapPool.trimMemory设为 public。 - 将 AnimatedImageDrawable 包装在 ScaleDrawable 中以确保其填满边界。
- 为 RequestBuilder.setParameter 添加 @JvmOverloads。
- 如果未设置 SVG 的 viewBox,则将其设置为其自身尺寸。
- 将状态和层级更改传递给 CrossfadeDrawable 的子项。
- 将 OkHttp 更新至 3.12.8。
[0.9.1] - 2019 年 12 月 30 日
- 修复:修复调用
LoadRequestBuilder.crossfade(false)时的崩溃问题。
[0.9.0] - 2019 年 12 月 30 日
- 破坏性变更:
Transformation.transform现在包含一个Size形参。这是为了支持根据Target的大小更改输出Bitmap大小的变换。带有变换的请求现在也将不受图像采样的影响。 - 破坏性变更:
Transformation现在适用于任何类型的Drawable。此前,如果输入的Drawable不是BitmapDrawable,则会跳过Transformation。现在,在应用Transformation之前会将Drawable渲染为Bitmap。 - 破坏性变更:向
ImageLoader.load传递null数据现在被视为错误,并会调用带有NullRequestDataException的Target.onError和Request.Listener.onError。做出此项更改是为了支持在数据为null时设置fallbackDrawable。此前该请求会被静默忽略。 - 破坏性变更:
RequestDisposable.isDisposed现在是一个val。
- 新增:支持自定义过渡。在此查看更多信息。由于 API 仍在孵化中,过渡功能被标记为实验性。
- 新增:添加
RequestDisposable.await以支持在LoadRequest进行中时挂起。 - 新增:支持在请求数据为 null 时设置
fallbackDrawable。 - 新增:添加
Precision。这使得输出Drawable的大小精确无误,同时为支持缩放的 target(例如ImageViewTarget)启用缩放优化。有关更多信息,请参阅其文档。 - 新增:添加
RequestBuilder.aliasKeys以支持匹配多个缓存键。
- 修复:使 RequestDisposable 线程安全。
- 修复:
RoundedCornersTransformation现在先裁剪到 target 的大小,然后将角变圆。 - 修复:
CircleCropTransformation现在从中心进行裁剪。 - 修复:将多款设备添加到硬件 Bitmap 黑名单。
- 修复:将 Drawable 转换为 Bitmap 时保持宽高比。
- 修复:修复在使用
Scale.FIT时可能发生的内存缓存未命中。 - 修复:确保 Parameters 的迭代顺序是确定性的。
- 修复:在创建 Parameters 和 ComponentRegistry 时进行防御性复制。
- 修复:确保 RealBitmapPool 的 maxSize >= 0。
- 修复:如果 CrossfadeDrawable 没有在动画播放中或未完成,则显示起始 Drawable。
- 修复:调整 CrossfadeDrawable 以考量具有未定义固有尺寸的子项。
- 修复:修复
MovieDrawable缩放不正确的问题。
- 将 Kotlin 更新至 1.3.61。
- 将 Kotlin Coroutines 更新至 1.3.3。
- 将 Okio 更新至 2.4.3。
- 更新 AndroidX 依赖项:
androidx.exifinterface:exifinterface-> 1.1.0
[0.8.0] - 2019 年 10 月 22 日
- 破坏性变更:移除了
SvgDrawable。取而代之的是,SVG 现在由SvgDecoder预渲染为BitmapDrawable。这使得 SVG 在主线程上的渲染开销显著降低。此外,SvgDecoder构造函数现在需要Context。 - 破坏性变更:
SparseIntArraySet扩展函数已移至coil.extension包。
- 新增:支持按请求设置网络标头。在此查看更多信息。
- 新增:添加新的
ParametersAPI,以支持通过图像流水线传递自定义数据。 - 新增:在 RoundedCornersTransformation 中支持单个圆角半径。感谢 @khatv911。
- 新增:添加
ImageView.clear()以支持主动释放资源。 - 新增:支持从其他软件包加载资源。
- 新增:为 ViewSizeResolver 添加
subtractPadding属性,用于在测量时启用/禁用扣除 View 的内边距。 - 新增:改进 HttpUrlFetcher 的 MIME 类型检测。
- 新增:向 MovieDrawable 和 CrossfadeDrawable 添加 Animatable2Compat 支持。
- 新增:添加
RequestBuilder<*>.repeatCount用于设置 GIF 的重复次数。 - 新增:将 BitmapPool 的创建加入公共 API。
- 新增:使用
@MainThread注解 Request.Listener 的方法。
- 修复:使 CoilContentProvider 对测试可见。
- 修复:在资源缓存键中包含夜间模式。
- 修复:通过临时将源写入磁盘来规避 ImageDecoder 原生崩溃。
- 修复:正确处理联系人显示照片 URI。
- 修复:将着色传递给 CrossfadeDrawable 的子项。
- 修复:修复多处未关闭源的情况。
- 修复:添加包含损坏/不完整硬件 Bitmap 实现的设备黑名单。
- 针对 SDK 29 进行编译。
- 将 Kotlin Coroutines 更新至 1.3.2。
- 将 OkHttp 更新至 3.12.6。
- 将 Okio 更新至 2.4.1。
- 将
coil-base中的appcompat-resources从compileOnly改为implementation。
[0.7.0] - 2019 年 9 月 8 日
- 破坏性变更:
ImageLoaderBuilder.okHttpClient(OkHttpClient.Builder.() -> Unit)现已变更为ImageLoaderBuilder.okHttpClient(() -> OkHttpClient)。初始值设定项现在也在后台线程上延迟调用。如果设置了自定义OkHttpClient,必须设置OkHttpClient.cache才能启用磁盘缓存。 如果未设置自定义OkHttpClient,Coil 将创建已启用磁盘缓存的默认OkHttpClient。可以使用CoilUtils.createDefaultCache(context)创建默认的 Coil 缓存。例如:
kotlin
val imageLoader = ImageLoader(context) {
okHttpClient {
OkHttpClient.Builder()
.cache(CoilUtils.createDefaultCache(context))
.build()
}
}- 破坏性变更:
Fetcher.key不再具有默认实现。 - 破坏性变更:先前仅调用第一个适用的
Mapper。现在将调用所有适用的Mapper。API 无变动。 - 破坏性变更:少量具名形参重命名:
url->uri,factory->initializer。
- 新增:
coil-svg构件,包含支持自动解码 SVG 的SvgDecoder。由 AndroidSVG 提供支持。感谢 @rharter。 - 新增:
load(String)和get(String)现在接受任何受支持的 Uri 架构(scheme)。例如,你现在可以执行imageView.load("file:///path/to/file.jpg")。 - 新增:重构 ImageLoader,使用
Call.Factory代替OkHttpClient。这允许使用ImageLoaderBuilder.okHttpClient { OkHttpClient() }延迟初始化网络资源。感谢 @ZacSweers。 - 新增:
RequestBuilder.decoder,用于为请求显式设置解码器。 - 新增:
ImageLoaderBuilder.allowHardware,用于为 ImageLoader 默认启用/禁用硬件 Bitmap。 - 新增:在 ImageDecoderDecoder 中支持软件渲染。
- 修复:修复加载矢量 Drawable 的多个错误。
- 修复:支持 WRAP_CONTENT 的 View 尺寸。
- 修复:支持解析超过 8192 字节的 EXIF 数据。
- 修复:淡入淡出时不对不同宽高比的 Drawable 进行拉伸。
- 修复:防范网络观察程序因异常而无法注册的情况。
- 修复:修复 MovieDrawable 中的除以零错误。感谢 @R12rus。
- 修复:支持嵌套的 Android asset 文件。感谢 @JaCzekanski。
- 修复:防范在 Android O 和 O_MR1 上耗尽文件描述符。
- 修复:禁用内存缓存时不再崩溃。感谢 @hansenji。
- 修复:确保始终从主线程调用 Target.cancel。
- 将 Kotlin 更新至 1.3.50。
- 将 Kotlin Coroutines 更新至 1.3.0。
- 将 OkHttp 更新至 3.12.4。
- 将 Okio 更新至 2.4.0。
- 将 AndroidX 依赖项更新至最新稳定版本:
androidx.appcompat:appcompat-> 1.1.0androidx.core:core-ktx-> 1.1.0androidx.lifecycle:lifecycle-common-java8-> 2.1.0
- 将
appcompat替换为作为可选compileOnly依赖项的appcompat-resources。appcompat-resources是一个更小巧的构件。
[0.6.1] - 2019 年 8 月 16 日
- 新增:向 RequestBuilder 添加
transformations(List<Transformation>)。 - 修复:将最后修改日期添加到文件 URI 的缓存键中。
- 修复:确保 View 尺寸至少评估为 1px。
- 修复:在帧之间清除 MovieDrawable 的画布。
- 修复:正确打开 asset。
[0.6.0] - 2019 年 8 月 12 日
- 首次发布。
