常见问题解答
遇到常见问题解答中未包含的问题?请在 StackOverflow 上查看带有 #coil 标签的内容,或搜索 Github discussions。
Coil 可以用于 Java 项目或 Kotlin/Java 混合项目吗?
可以!点击此处阅读。
如何预加载图片?
发起一个不指定 target 的图片请求:
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())。
注意
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 字节码:
import org.jetbrains.kotlin.gradle.dsl.JvmTarget
android {
compileOptions {
sourceCompatibility = JavaVersion.VERSION_11
targetCompatibility = JavaVersion.VERSION_11
}
}
kotlin {
compilerOptions {
jvmTarget = JvmTarget.JVM_11
}
}为什么我在使用 Compose Multiplatform 时会收到 Skiko 版本警告?
如果 Coil 的 Skiko 依赖项版本低于 Compose Multiplatform 的依赖项,Compose Multiplatform 将输出类似于如下内容的警告:
w: Skiko dependencies' versions are incompatible.Skiko 无法保证里程碑版本之间的二进制兼容性,因为它包装了 Skia,而 Skia 的里程碑版本可能会引入破坏性变更。切勿假定此警告可以安全忽略。Coil 的发布版本跟踪 Compose Multiplatform 的稳定(stable)版本及其对应的 Skiko 版本,因此如果您遇到此警告,请先将 Coil 更新到最新版本。
注意:Coil 不会仅仅为了匹配 Compose Multiplatform 的 alpha 和 beta 版本所使用的 Skiko 版本而发布新版本。但是,如果存在需要 Coil 依赖较新 Skiko 版本的二进制兼容性问题,Coil 会发布包含更新依赖项的 alpha 版本。
如果您已将 Coil 更新至最新版本,但警告仍然存在,可以按如下方式抑制该警告:
Compose Multiplatform >= 1.13.0
将以下内容添加到应用了 Compose Multiplatform 插件的每个模块的 build.gradle.kts 文件中:
compose {
dependencyCompatibility {
exclude("io.coil-kt.coil3")
}
}这将仅针对 Coil 禁用兼容性检查。
较早的 Compose Multiplatform 版本:
将以下内容添加到您的 gradle.properties 文件中:
org.jetbrains.compose.library.compatibility.check.disable=true这将禁用所有库(包括 Coil)的所有 Compose Multiplatform 库兼容性检查。
如何获取开发快照?
将快照仓库添加到您的仓库列表中:
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/")
}
}然后使用最新的快照版本引入相同的构件依赖。
注意
在 main 分支上通过 CI 的每次新提交都会部署快照。它们可能包含破坏性变更或可能不稳定。使用风险自负。
如何在 Coil 中使用 Proguard?
要在 Coil 中使用 Proguard,请将这些 Proguard 规则添加到您的配置中。
您可能还需要为 Ktor、OkHttp 和 Coroutines 添加自定义规则。
注意
如果您使用的是 R8,则无需为 Coil 添加任何自定义规则,R8 是 Android 上的默认代码压缩工具。这些规则会自动添加。
