FAQ
FAQに記載されていない質問がありますか?その場合は、#coil タグを付けて StackOverflow を確認するか、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 Plugin 4.2.0 以降および Kotlin Gradle Plugin 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 のマイルストーンバージョン間で破壊的変更(breaking changes)が導入される可能性があるため、Skiko はマイルストーンバージョン間のバイナリ互換性を保証していません。この警告は、無視しても安全だとみなすべきではありません。Coil のリリースは Compose Multiplatform の安定版(stable)リリースおよびその Skiko バージョンに追従しているため、この警告が発生した場合は、まず Coil を最新バージョンにアップデートしてください。
注意: Coil は、Compose Multiplatform のアルファ版(alpha)やベータ版(beta)リリースで使用される Skiko バージョンに合わせるためだけの新バージョンリリースは行いません。ただし、Coil 側で新しい Skiko バージョンへの依存が必要となるバイナリ互換性の問題がある場合は、依存関係を更新したアルファ版リリースを公開します。
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/")
}
}その後、最新のスナップショットバージョンを指定して同じアーティファクトに依存させます。
注記
スナップショットは、CI を通過した main ブランチのコミットごとにデプロイされます。破壊的変更が含まれていたり、不安定であったりする可能性があります。自己責任でご使用ください。
Coil で Proguard を使用するにはどうすればよいですか?
Coil で Proguard を使用するには、これらの Proguard ルールを設定に追加してください。
また、Ktor、OkHttp、Coroutines 用のカスタムルールの追加が必要になる場合もあります。
注記
Android のデフォルトのコード縮小ツールである R8 を使用している場合、Coil 用のカスタムルールを追加する必要はありません。ルールは自動的に追加されます。
