常见问题解答

有问题不在常见问题解答中？查看带有 #coil 标签的 StackOverflow 或搜索 Github 讨论区。

Coil 可以用于 Java 项目或 Kotlin/Java 混合项目吗？

可以！在此阅读。

如何预加载图像？

发起一个不带目标的图像请求：

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

这将预加载图像并将其保存到磁盘和内存缓存中。

如果你只想预加载到磁盘缓存，可以像这样跳过解码和保存到内存缓存：

val request = ImageRequest.Builder(context)
    .data("https://example.com/image.jpg")
    // 禁用写入内存缓存。
    .memoryCachePolicy(CachePolicy.DISABLED)
    // 跳过解码步骤，这样我们就不会浪费时间/内存将图像解码到内存中。
    .decoderFactory(BlackholeDecoder.Factory())
    .build()
imageLoader.enqueue(request)

如何启用日志记录？

在 构造 ImageLoader 时设置 logger(DebugLogger())。

::: Note DebugLogger 应仅在调试构建中使用。

:::

如何以 Java 8 或 Java 11 为目标？

Coil 需要 Java 8 字节码。Android Gradle 插件 4.2.0 及更高版本以及 Kotlin Gradle 插件 1.5.0 及更高版本默认启用此功能。如果你正在使用这些插件的旧版本，请将以下内容添加到你的 Gradle 构建脚本中：

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_1_8
        targetCompatibility = JavaVersion.VERSION_1_8
    }
    kotlinOptions {
        jvmTarget = "1.8"
    }
}

自 Coil 3.2.0 起，coil-compose 和 coil-compose-core 需要 Java 11 字节码：

android {
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_11
        targetCompatibility = JavaVersion.VERSION_11
    }
    kotlinOptions {
        jvmTarget = "11"
    }
}

为什么我会收到 Compose 多平台的 Skiko 版本警告？

如果 Coil 的 Skiko 依赖版本早于 Compose 多平台的版本，Compose 多平台将打印如下警告：

w: Skiko dependencies' versions are incompatible.

此警告通常可以安全忽略，因为 Skiko 版本通常保持二进制兼容性。Coil 的发布版本会跟踪 Compose 多平台的 stable（稳定）版本及其 Skiko 版本，因此如果你遇到此警告，请首先将 Coil 更新到最新版本。

注意：通常情况下，Coil 不会仅为了匹配 Compose 多平台的 alpha 和 beta 版本所使用的 Skiko 版本而发布新版本，除非这些 Skiko 版本与最新 Coil 版本所依赖的版本不兼容。

如果警告仍然存在，你可以通过设置以下 Gradle 属性来忽略它：

org.jetbrains.compose.library.compatibility.check.disable=true

但是，该 Gradle 属性会禁用所有库的所有 Compose 多平台库兼容性检查，而不仅仅是针对 Coil。要仅针对 Coil 及其 Skiko 依赖禁用该警告，请将以下代码段添加到根 build.gradle.kts 文件中：

dependencies {
    components {
        all {
            if (id.group == "io.coil-kt.coil3") {
                allVariants {
                    withDependencies {
                        val hadSkikoDependency = removeAll {
                            it.group == "org.jetbrains.skiko" && it.name == "skiko"
                        }
                        if (hadSkikoDependency) {
                            // 将 `0.150.0` 替换为你的 Compose 多平台版本所使用的 Skiko 版本。
                            add("org.jetbrains.skiko:skiko:0.150.0")
                        }
                    }
                }
            }
        }
    }
}

如何获取开发快照？

将快照仓库添加到你的仓库列表中：

Gradle (.gradle)：

allprojects {
    repositories {
        maven { url 'https://central.sonatype.com/repository/maven-snapshots/' }
    }
}

Gradle Kotlin DSL (.gradle.kts)：

allprojects {
    repositories {
        maven("https://central.sonatype.com/repository/maven-snapshots/")
    }
}

然后依赖具有 最新快照版本 的相同构件。

::: Note 快照会针对通过 CI 的 main 分支上的每个新提交进行部署。它们可能包含破坏性变更或可能不稳定。使用风险自负。

:::

如何在 Coil 中使用 Proguard？

要在 Coil 中使用 Proguard，请将这些 Proguard 规则添加到你的配置中。

你可能还需要为 Ktor、OkHttp 和 Coroutines 添加自定义规则。

::: Note 如果你使用 R8，则不需要为 Coil 添加任何自定义规则，它是 Android 上的默认代码压缩工具。这些规则会自动添加。 :::