Skip to content

변경 로그 (Changelog) ​

[3.6.3] - 2026년 9월 18일 ​

  • Kotlin 모듈 이름 메타데이터의 잘못된 문자로 인해 Android Gradle 플러그인 9.4.0 및 R8을 사용하는 빌드가 실패하던 문제를 수정했습니다.

[3.6.2] - 2026년 9월 4일 ​

  • 대기 중인 요청이 취소될 경우 DeDupeConcurrentRequestStrategy에서 특정 키에 대한 요청이 중단(hang)되던 문제를 수정했습니다. (#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)
  • 신규: Android의 StaticImageDecoder가 불완전한(partial) 이미지를 허용할지 여부를 구성할 수 있는 ImageRequest.Builder.allowPartialImage 및 ImageLoader.Builder.allowPartialImage를 추가했습니다. 기본적으로 활성화되어 있으며, 이는 이전 Coil 릴리스와 동일한 동작입니다. (#3494)
  • AsyncImage가 반전된 제약 조건(inverted constraints)으로 측정될 때 비정상 종료(crash)되던 문제를 수정했습니다. (#3470)
  • GIF를 포함하여 Drawable 기반 이미지에 Compose filterQuality가 적용되지 않던 문제를 수정했습니다. (#3469)
  • JS/WASM 이미지 디코더의 메모리 누수를 수정했습니다. (#3503)
  • R8 9.0+ 최적화 빌드에서 GenericViewTarget을 사용할 때 이미지가 렌더링되지 않던 문제를 수정했습니다. (#3518)
  • JVM에서 사용 가능한 메모리를 512MB로 가정하는 대신 Runtime.maxMemory()를 사용하여 최대 메모리 캐시 크기를 결정하도록 변경했습니다. (#3458)
  • Android가 아닌 JVM 아티팩트에 ProGuard 규칙을 번들로 포함했습니다. (#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)
  • 신규: 전체 Skia 디코드로 폴백되는 것을 방지하기 위해 JS/WASM에서 빠른 WebP 크기 추출 기능을 추가했습니다. (#3341)
  • ImageLoader.Builder.memoryCacheMaxSizePercentWhileInBackground에서 실험적(experimental) 애너테이션을 제거했습니다. (#3439)
  • CacheStrategy 구현체에서 캐시된 실패 응답(예: 만료된 캐시 404 응답)을 갱신할 수 없던 문제를 수정했습니다. (#3401)
  • 코루틴 컨텍스트에서 CoroutineDispatcher 대신 ContinuationInterceptor를 조회하도록 변경했습니다. (#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)
  • 코루틴 컨텍스트에서 CoroutineDispatcher 대신 ContinuationInterceptor를 조회하도록 변경했습니다. (#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)
  • 전체 Skia 디코드로 폴백되는 것을 방지하기 위해 JS/WASM에서 빠른 WebP 크기 추출 기능을 추가했습니다. (#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일 ​

  • 신규: 동일한 키에 대해 진행 중인(in-flight) 네트워크 요청을 병합할 수 있도록 ConcurrentRequestStrategy를 추가했습니다. (#2995, #3326)
    • DeDupeConcurrentRequestStrategy는 이 동작을 활성화하며, 대기자가 진행 중인 네트워크 요청의 결과를 기다릴 수 있도록 합니다.
      • 이 동작은 실험적이며 현재 기본적으로 비활성화되어 있습니다.
      • 현재 요청은 항상 diskCacheKey를 기반으로 결합됩니다.
    • OkHttpNetworkFetcherFactory, KtorNetworkFetcherFactory, NetworkFetcher.Factory에서 이제 concurrentRequestStrategy를 허용합니다.
  • 신규: 브라우저 메인 스레드가 차단되는 것을 방지하기 위해 웹 워커(Web Worker)를 사용하여 JS/WASM에서 이미지를 디코딩합니다. (#3305)
  • 신규: Compose가 아닌 멀티플랫폼 아티팩트에 대해 Linux 네이티브 타깃(linuxX64 및 linuxArm64) 지원을 추가했습니다. (#3054)
  • 신규: 후속 요청 간의 전환(transition)을 개선하기 위한 Compose 전용 API를 추가했습니다. (#3141, #3175)
    • ImageRequest.Builder.useExistingImageAsPlaceholder는 플레이스홀더가 설정되지 않았을 때 이전 이미지로부터 크로스페이드(crossfade)되도록 지원합니다.
    • ImageRequest.Builder.preferEndFirstIntrinsicSize는 CrossfadePainter가 최종(end) 페인터의 고유 크기(intrinsic size)를 우선하도록 합니다.
  • 신규: 애니메이션 이미지의 전역 반복 횟수를 설정할 수 있도록 coil-gif에 ImageLoader.Builder.repeatCount(Int)를 추가했습니다. (#3143)
  • 신규: coil-video에서 임베디드 비디오 썸네일을 우선 사용하는 지원을 추가했습니다. (#3107)
  • 신규: coil-lint를 coil-core와 함께 배포하고, ImageRequest.Builder 블록 내에서 실수로 호출된 kotlin.error()를 감지하는 린트 검사를 추가했습니다. (#3304)
  • Kotlin 언어 버전을 2.1로 설정했습니다. (#3302)
  • 공통(common) 코드에서 BitmapFetcher를 사용할 수 있도록 했습니다. (#3286)
  • Android에서 싱글톤 ImageLoader를 생성할 때 applicationContext를 사용하도록 했습니다. (#3246)
  • 캐시 가능한 2xx 이외의 HTTP 응답(예: 404)을 기본적으로 캐시하고, 캐시 불가능한 응답(예: 500)은 캐시하지 않도록 변경했습니다. (#3137, #3139)
  • OkHttp 응답 본문을 소비할 때 발생할 수 있는 잠재적 경쟁 상태(race condition)를 수정했습니다. (#3186)
  • Android에서 과도한 크기의 비트맵으로 인한 비정상 종료를 방지하기 위해 maxBitmapSize 엣지 케이스를 수정했습니다. (#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일 ​

  • 신규: 앱이 백그라운드 상태일 때 Android에서 MemoryCache.maxSize를 제한하는 새로운 API를 도입했습니다.
    • ImageLoader.Builder.memoryCacheMaxSizePercentWhileInBackground가 설정되어 있으면, 앱이 백그라운드에 있는 동안 ImageLoader의 메모리 캐시가 최대 크기의 일정 비율로 제한됩니다. 이 설정은 현재 기본적으로 비활성화되어 있습니다.
    • 앱이 백그라운드로 전환될 때 제한된 최대 크기에 도달하도록 메모리 캐시에서 이미지가 정리(trim)되지만, 최근 정리된 이미지에 대한 메모리 캐시의 약한 참조(weak reference)는 영향을 받지 않습니다. 즉, 이미지가 현재 다른 곳(예: AsyncImage, ImageView 등)에서 참조되고 있다면 메모리 캐시에 계속 유지됩니다.
    • 이 API는 백그라운드 메모리 사용량을 줄여 앱이 조기에 종료되는 것을 방지하고, 사용자 기기의 메모리 부담을 줄이는 데 유용합니다.
  • 신규: SvgDecoder에 Svg.Parser 인자를 추가했습니다.
    • 기본 SVG 파서가 요구 사항을 충족하지 못하는 경우 커스텀 SVG 파서를 사용할 수 있습니다.
  • 커스텀 밀도 배율(density multiplier) 제공을 지원하기 위해 SvgDecoder에 density 인자를 추가했습니다.
  • Uri의 복사 및 수정을 지원하기 위해 Uri.Builder를 추가했습니다.
  • 테스트에서 Coil의 Dispatchers.main.immediate 사용을 재정의(override)할 수 있도록 ImageLoader.Builder.mainCoroutineContext를 추가했습니다.
  • 애니메이션 종료 시 start 이미지의 참조가 해제될 때 CrossfadePainter.intrinsicSize가 변경되던 문제를 수정했습니다. 이는 CrossfadeDrawable의 동작과 일치합니다.
  • Java에서 ImageLoaders.executeBlocking에 접근할 수 없던 문제를 수정했습니다.
  • coil-network-ktor3에서 kotlinx.io의 Okio 상호 운용(interop) 모듈을 사용하도록 변경했습니다.
  • 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.Loading 대신 AsyncImagePainter.State.Success를 반환하도록 변경했습니다.
  • ConstraintsSizeResolver#size()의 취소 동작을 수정했습니다.
  • R8으로 빌드할 때 누락된 PlatformContext에 대한 경고를 수정했습니다.
  • 기본 FakeImageLoaderEngine 응답이 반환될 때 FakeImageLoaderEngine이 Transition.Factory.NONE을 설정하지 않던 문제를 수정했습니다.
  • ColorImage에서 실험적 애너테이션을 제거했습니다.
  • CacheControlCacheStrategy에서 네트워크 헤더를 지연(lazily) 파싱하도록 변경했습니다.
  • 공통 코드를 공유하도록 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.Loading 대신 AsyncImagePainter.State.Success를 반환하도록 변경했습니다.
  • 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% 향상되었습니다. 할당(allocation) 또한 35%~48% 감소했습니다. 자세한 정보는 여기를 참조하세요.
  • ColorImage를 추가하고 FakeImage를 지원 중단(deprecate)했습니다.
    • ColorImage는 테스트 및 미리보기에서 가짜 값을 반환하는 데 유용합니다. FakeImage와 동일한 사용 사례를 해결하지만, coil-test 대신 coil-core에서 더 쉽게 접근할 수 있습니다.
  • coil-compose-core의 Dispatchers.Main.immediate에 대한 의존성을 제거했습니다.
    • 이를 통해 Paparazzi 및 Roborazzi 스크린샷 테스트에서 AsyncImagePainter가 ImageRequest를 동기적으로 실행하지 못하던 문제도 해결되었습니다.
  • data:[<mediatype>][;base64],<data> 형식의 데이터 URI 지원을 추가했습니다.
  • GIF 메타데이터에 인코딩된 반복 횟수 사용을 지원하기 위해 AnimatedImageDecoder.ENCODED_LOOP_COUNT를 추가했습니다.
  • 커스텀 확장을 지원하기 위해 NetworkRequest에 Extras를 추가했습니다.
  • DiskCache.Builder.cleanupCoroutineContext를 추가하고 DiskCache.Builder.cleanupDispatcher를 지원 중단했습니다.
  • API 29 이상에서 android.graphics.ImageDecoder 사용을 선택적으로 비활성화할 수 있도록 ImageLoader.Builder.imageDecoderEnabled를 추가했습니다.
  • ImageRequest의 데이터 타입에 대해 등록된 Keyer가 없는 경우 경고를 기록하도록 했습니다.
  • CrossfadePainter를 공개(public) API로 전환했습니다.
  • 모든 멀티플랫폼 타깃에서 Transformation을 지원합니다.
  • CacheControlCacheStrategy에서 Expires 헤더 값으로 0을 지원합니다.
  • ContentScale이 None으로/에서 변경될 때 AsyncImage/SubcomposeAsyncImage/rememberAsyncImage가 새 ImageRequest를 시작하지 않던 문제를 수정했습니다.
  • Kotlin을 2.1.10으로 업데이트했습니다.
    • 참고: LLVM 업데이트로 인해 Kotlin Native를 사용하는 경우 본 릴리스는 Kotlin 2.1.0 이상으로 컴파일해야 합니다.
  • Compose를 1.7.3으로 업데이트했습니다.
  • androidx.core를 1.15.0으로 업데이트했습니다.

[3.0.4] - 2024년 11월 25일 ​

  • Android Studio 미리보기에서 벡터 드로어블이 렌더링되지 않던 문제를 수정했습니다.
  • 크기가 maxBitmapSize를 초과하는 요청에 대해 잠재적으로 메모리 캐시 미스가 발생하던 문제를 수정했습니다.
  • Android에서 FakeImage가 렌더링되지 않던 문제를 수정했습니다.
  • AsyncImage/rememberAsyncImagePainter/SubcomposeAsyncImage와 함께 사용할 때 요청의 Transformation이 변경되어도 새 이미지 요청이 시작되지 않던 문제를 수정했습니다.
  • ScaleDrawable 및 CrossfadeDrawable이 틴트(tint) 상태를 준수하지 않던 문제를 수정했습니다.
  • ImageDecoder가 불완전한 이미지 소스를 디코딩할 수 있도록 허용했습니다. 이는 BitmapFactory의 동작과 일치합니다.
  • 디코딩 후 Bitmap.prepareToDraw()가 호출되지 않던 문제를 수정했습니다.
  • SvgDecoder가 래스터화되지 않은 이미지에 대해 isSampled = true를 반환하지 않아야 하던 문제를 수정했습니다.
  • 즉각적인 메인 디스패처를 사용할 수 없는 경우 Compose에서 Dispatchers.Unconfined로 폴백하도록 했습니다. 이는 미리보기/테스트 환경에서만 사용됩니다.
  • Ktor 2를 2.3.13으로 업데이트했습니다.

[3.0.3] - 2024년 11월 14일 ​

  • ImageView의 ScaleType을 기반으로 ImageRequest.scale을 설정하던 동작을 수정했습니다.
  • 파일을 삭제한 후 DiskCache가 항목의 제거를 추적하지 못하던 엣지 케이스를 수정했습니다.
  • 오류를 로깅할 때 Logger에 throwable을 전달하도록 했습니다.
  • 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일 ​

  • 하드웨어 비트맵 기반의 BitmapImage로 Image.toBitmap을 호출할 때 비정상 종료되던 문제를 수정했습니다.
  • AsyncImageModelEqualityDelegate.Default가 ImageRequest가 아닌 모델에 대해 동등성을 잘못 비교하던 문제를 수정했습니다.

[3.0.0] - 2024년 11월 4일 ​

Coil 3.0.0은 Compose Multiplatform을 완벽히 지원하는 Coil의 차세대 메이저 릴리스입니다.

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가 무한 재구성(recomposition)되던 문제를 수정했습니다.
  • 특수 문자가 포함된 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 이후 변경 사항:

  • 주요 변경 사항(BREAKING): addLastModifiedToFileCacheKey를 기본적으로 비활성화하고 요청별로 설정할 수 있도록 변경했습니다. 동일한 플래그로 기존 동작을 다시 활성화할 수 있습니다.
  • 신규: Cache-Control 헤더 지원을 구현하는 새로운 coil-network-cache-control 아티팩트를 도입했습니다.
  • 신규: SvgDecoder.Factory에 scaleToDensity 프로퍼티를 추가했습니다. 이 프로퍼티는 고유 치수를 가진 SVG가 기기 밀도에 곱해지도록 보장합니다(Android에서만 지원).
  • ExifOrientationPolicy를 ExifOrientationStrategy로 이름을 변경했습니다.
  • 공유 불가능한 이미지를 가져올 때 MemoryCache에서 제거하도록 했습니다.
  • ConstraintsSizeResolver를 공개 API로 전환했습니다.
  • setSingletonImageLoaderFactory를 안정화했습니다.
  • coil-network-ktor3에서 최적화된 JVM I/O 함수를 복원했습니다.
  • MIME 타입 목록에 pdf를 추가했습니다.
  • 컴파일 SDK를 35로 업데이트했습니다.
  • Kotlin을 2.0.20으로 업데이트했습니다.
  • Okio를 3.9.1로 업데이트했습니다.

[3.0.0-alpha10] - 2024년 8월 7일 ​

  • 주요 변경 사항(BREAKING): ImageLoader.Builder.networkObserverEnabled를 NetworkFetcher를 위한 ConnectivityChecker 인터페이스로 대체했습니다.
    • 네트워크 관찰자를 비활성화하려면 KtorNetworkFetcherFactory/OkHttpNetworkFetcherFactory의 생성자에 ConnectivityChecker.ONLINE을 전달하세요.
  • 신규: 모든 플랫폼에서 Compose Multiplatform 리소스 로딩을 지원합니다. 리소스를 로드하려면 Res.getUri를 사용하세요:
kotlin
AsyncImage(
    model = Res.getUri("drawable/image.jpg"),
    contentDescription = null,
)
  • ImageLoader 및 ImageRequest에 maxBitmapSize 프로퍼티를 추가했습니다.
    • 이 프로퍼티의 기본값은 4096x4096이며, 할당된 비트맵 크기에 대한 안전한 상한을 제공합니다. 이를 통해 Size.ORIGINAL로 매우 큰 이미지를 실수로 로드하여 메모리 부족(out of memory) 예외가 발생하는 상황을 방지할 수 있습니다.
  • 커스텀 정책을 지원할 수 있도록 ExifOrientationPolicy를 인터페이스로 변환했습니다.
  • Windows 파일 경로에 대한 Uri 처리 문제를 수정했습니다.
  • Image API에서 @ExperimentalCoilApi를 제거했습니다.
  • Kotlin을 2.0.10으로 업데이트했습니다.

[3.0.0-alpha09] - 2024년 7월 23일 ​

  • 주요 변경 사항(BREAKING): io.coil-kt.coil3:coil-network-ktor 아티팩트의 이름을 Ktor 2.x에 의존하는 io.coil-kt.coil3:coil-network-ktor2로 변경했습니다. 또한, Ktor 3.x에 의존하는 io.coil-kt.coil3:coil-network-ktor3를 새로 도입했습니다. wasmJs 지원은 Ktor 3.x에서만 제공됩니다.
  • 신규: 이미지 요청을 수동으로 재시작할 수 있는 AsyncImagePainter.restart()를 추가했습니다.
  • NetworkClient 및 관련 클래스에서 @ExperimentalCoilApi를 제거했습니다.
  • 불필요한 Extras 및 Map 할당을 피하도록 ImageRequest를 최적화했습니다.

[2.7.0] - 2024년 7월 17일 ​

  • ImageLoader.execute, AsyncImage, SubcomposeAsyncImage, rememberAsyncImagePainter의 성능 향상을 위해 내부 코루틴 사용을 소폭 최적화했습니다. (#2205)
  • 청크(chunked) 응답에 대해 중복 네트워크 호출이 발생하던 문제를 수정했습니다. (#2363)
  • Kotlin을 2.0.0으로 업데이트했습니다.
  • Compose UI를 1.6.8로 업데이트했습니다.
  • Okio를 3.9.0으로 업데이트했습니다.

[3.0.0-alpha08] - 2024년 7월 8일 ​

  • 주요 변경 사항(BREAKING): 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일 ​

  • 주요 변경 사항(BREAKING): AsyncImagePainter가 기본적으로 더 이상 onDraw를 기다리지 않고 Size.ORIGINAL을 사용합니다.
    • 이를 통해 Roborazzi/Paparazzi와의 호환성 문제가 해결되고 전반적인 테스트 안정성이 향상됩니다.
    • onDraw를 기다리는 기존 방식으로 되돌리려면 DrawScopeSizeResolver를 ImageRequest.sizeResolver로 설정하세요.
  • 주요 변경 사항(BREAKING): 멀티플랫폼 Image API를 리팩터링했습니다. 특히 asCoilImage가 asImage로 이름이 변경되었습니다.
  • 주요 변경 사항(BREAKING): AsyncImagePainter.state가 StateFlow<AsyncImagePainter.State>로 변경되었습니다. 값을 관찰하려면 collectAsState를 사용하세요. 이를 통해 성능이 향상됩니다.
  • 주요 변경 사항(BREAKING): AsyncImagePainter.imageLoader 및 AsyncImagePainter.request가 StateFlow<AsyncImagePainter.Inputs>로 통합되었습니다. 값을 관찰하려면 collectAsState를 사용하세요. 이를 통해 성능이 향상됩니다.
  • 주요 변경 사항(BREAKING): 리소스 축소(shrinking) 최적화를 방해하므로 android.resource://example.package.name/drawable/image 형식의 URI 지원을 제거했습니다.
  • 신규: AsyncImagePainter의 미리보기 렌더링 동작 제어를 지원하는 AsyncImagePreviewHandler를 도입했습니다.
    • 미리보기 동작을 재정의하려면 LocalAsyncImagePreviewHandler를 사용하세요.
    • 이 변경 사항 및 기타 coil-compose 개선의 일환으로, AsyncImagePainter는 이제 기본적으로 ImageRequest.placeholder를 표시하는 대신 ImageRequest 실행을 시도합니다. 미리보기 환경에서 네트워크나 파일을 사용하는 요청은 실패할 것으로 예상되지만 Android 리소스는 정상 작동해야 합니다.
  • 신규: 프레임 인덱스로 비디오 이미지를 추출하는 기능을 지원합니다. (#2183)
  • 신규: 모든 CoroutineDispatcher 메서드에 CoroutineContext 전달을 지원합니다. (#2241)
  • 신규: JS 및 WASM JS에서 약한 참조 메모리 캐시를 지원합니다.
  • Compose에서 Dispatchers.Main.immediate로 디스패치하지 않도록 했습니다. 이에 따라 JVM에서 kotlinx-coroutines-swing을 더 이상 가져올 필요가 없습니다.
  • 성능 향상을 위해 Compose에서 async를 호출하고 disposable을 생성하지 않도록 변경했습니다(@mlykotom님께 감사드립니다!). (#2205)
  • 전역 ImageLoader 엑스트라(extras)를 Options로 전달하던 문제를 수정했습니다. (#2223)
  • Android가 아닌 타깃에서 crossfade(false)가 작동하지 않던 문제를 수정했습니다.
  • VP8X 기능 플래그 바이트 오프셋을 수정했습니다 (#2199).
  • 드로우 시점에 이미지를 렌더링하는 대신 비트맵으로 렌더링하도록 Android가 아닌 타깃의 SvgDecoder를 변환했습니다. 이를 통해 성능이 향상됩니다.
    • 이 동작은 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일 ​

[3.0.0-alpha05] - 2024년 2월 28일 ​

  • 신규: wasmJs 타깃을 지원합니다.
  • Android가 아닌 플랫폼에서 Bitmap 기반이 아닌 Image 그리기를 지원하기 위해 DrawablePainter 및 DrawableImage를 만들었습니다.
    • Image API는 실험적이며 알파 릴리스 간에 변경될 수 있습니다.
  • ContentPainterModifier가 Modifier.Node를 구현하도록 업데이트했습니다.
  • 수정: 컴포넌트 콜백 및 네트워크 관찰자를 백그라운드 스레드에서 지연 등록하도록 했습니다. 이를 통해 일반적으로 메인 스레드에서 발생하던 느린 초기화 문제를 수정했습니다.
  • 수정: ImageLoader.Builder.placeholder/error/fallback이 ImageRequest에서 사용되지 않던 문제를 수정했습니다.
  • 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를 재시작 가능하고 건너뛸 수 있도록(restartable and skippable) 만들었습니다. 이를 통해 컴포저블의 인자 중 하나가 변경되지 않는 한 재구성을 방지하여 성능을 향상시킵니다.
    • model이 재구성을 트리거할지 여부를 제어하기 위해 선택적 modelEqualityDelegate 인자를 rememberAsyncImagePainter, AsyncImage, SubcomposeAsyncImage에 추가했습니다.
  • ContentPainterModifier가 Modifier.Node를 구현하도록 업데이트했습니다.
  • 수정: 컴포넌트 콜백 및 네트워크 관찰자를 백그라운드 스레드에서 지연 등록하도록 했습니다. 이를 통해 일반적으로 메인 스레드에서 발생하던 느린 초기화 문제를 수정했습니다.
  • 수정: ImageRequest.listener 또는 ImageRequest.target이 변경되더라도 rememberAsyncImagePainter, AsyncImage, SubcomposeAsyncImage에서 새 이미지 요청이 재시작되지 않도록 방지했습니다.
  • 수정: 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일 ​

  • 주요 변경 사항(BREAKING): OkHttpNetworkFetcherFactory 및 KtorNetworkFetcherFactory의 공개 API에서 Lazy를 제거했습니다.
  • OkHttpNetworkFetcherFactory에서 OkHttpClient 대신 Call.Factory를 노출하도록 변경했습니다.
  • ByteString을 감싸도록 NetworkResponseBody를 변환했습니다.
  • Compose를 1.5.12로 다운그레이드했습니다.
  • 모든 중요 변경 사항 목록은 업그레이드 가이드를 확인하세요.

[3.0.0-alpha03] - 2024년 1월 20일 ​

  • 주요 변경 사항(BREAKING): 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일 ​

  • 주요 변경 사항(BREAKING): 다른 아티팩트와의 클래스 이름 충돌을 방지하기 위해 coil-gif, coil-network, coil-svg, coil-video의 패키지가 업데이트되어 모든 클래스가 각각 coil.gif, coil.network, coil.svg, coil.video에 속하게 되었습니다.
  • 주요 변경 사항(BREAKING): ImageDecoderDecoder의 이름이 AnimatedImageDecoder로 변경되었습니다.
  • 신규: 이제 coil-gif, coil-network, coil-svg, coil-video의 컴포넌트가 각 ImageLoader의 ComponentRegistry에 자동으로 추가됩니다.
    • 명확히 하자면, 3.0.0-alpha01과 달리 ComponentRegistry에 NetworkFetcher.Factory()를 수동으로 추가할 필요가 없습니다. 단순히 io.coil-kt.coil3:coil-network:[version]과 Ktor 엔진을 가져오는 것만으로 네트워크 이미지를 로드하기에 충분합니다.
    • 이러한 컴포넌트를 ComponentRegistry에 수동으로 추가해도 안전합니다. 수동으로 추가된 컴포넌트가 자동으로 추가된 컴포넌트보다 우선 적용됩니다.
    • 원하는 경우 ImageLoader.Builder.serviceLoaderEnabled(false)를 사용하여 이 동작을 비활성화할 수 있습니다.
  • 신규: 모든 플랫폼에서 coil-svg를 지원합니다. Android에서는 AndroidSVG를 기반으로 하며, Android 이외의 플랫폼에서는 SVGDOM을 기반으로 동작합니다.
  • Coil은 이제 내부적으로 Android의 ImageDecoder API를 사용하므로 파일, 리소스 또는 콘텐츠 URI에서 직접 디코딩할 때 성능상의 이점이 있습니다.
  • 수정: 여러 coil3.Uri 파싱 문제를 수정했습니다.
  • 모든 중요 변경 사항 목록은 업그레이드 가이드를 확인하세요.

[3.0.0-alpha01] - 2023년 12월 30일 ​

  • 신규: Compose Multiplatform 지원. Coil은 이제 Android, JVM, iOS, macOS 및 Javascript를 지원하는 Kotlin Multiplatform 라이브러리입니다.
  • Coil의 Maven 좌표가 io.coil-kt.coil3으로 업데이트되었으며 import 경로가 coil3으로 업데이트되었습니다. 이를 통해 바이너리 호환성 문제 없이 Coil 3과 Coil 2를 함께 실행할 수 있습니다. 예를 들어 io.coil-kt:coil:[version]은 이제 io.coil-kt.coil3:coil:[version]입니다.
  • Coroutines, Ktor 및 AndroidX에서 사용하는 명명 규칙에 맞추기 위해 coil-base 및 coil-compose-base 아티팩트의 이름이 각각 coil-core 및 coil-compose-core로 변경되었습니다.
  • 모든 중요 변경 사항 목록은 업그레이드 가이드를 확인하세요.

[2.5.0] - 2023년 10월 30일 ​

  • 신규: coil-video에서 MediaDataSource 구현체의 디코딩을 지원하기 위해 MediaDataSourceFetcher.Factory를 추가했습니다. (#1795)
  • 하드웨어 비트맵 차단 목록에 SHIFT6m 기기를 추가했습니다. (#1812)
  • 수정: 한쪽 치수가 바운딩되지 않은(unbounded) 크기를 반환하는 페인터에 대한 방어 코드를 추가했습니다. (#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로 자동 변환하지 않도록 변경했습니다.
  • 단순 AsyncImage 오버로드에 @NonRestartableComposable 애너테이션을 추가했습니다.
  • 수정: ImageSource에서 Context.cacheDir을 지연 호출하도록 변경했습니다.
  • 수정: coil-bom 배포 문제를 수정했습니다.
  • 수정: 하드웨어 비트맵이 비활성화된 경우 비트맵 구성을 항상 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일 ​

  • 신규: FakeImageLoaderEngine이 포함된 새로운 coil-test 아티팩트를 도입했습니다. 이 클래스는 테스트에서 일관되고 동기적인(메인 스레드로부터) 응답을 보장하기 위해 이미지 로더 응답을 하드코딩하는 데 유용합니다. 자세한 내용은 여기를 참조하세요.
  • 신규: coil-base(coil의 자식 모듈) 및 coil-compose-base(coil-compose의 자식 모듈)에 기준 프로필(Baseline Profiles)을 추가했습니다.
    • 이를 통해 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
  • 밴딩 현상(banding)을 방지하기 위해 API 30+의 VideoFrameDecoder에서 선호하는 비트맵 구성을 설정했습니다. #1487
  • FileUriMapper에서 #이 포함된 경로 파싱 문제를 수정했습니다. #1466
  • 디스크 캐시에서 비 ASCII 헤더가 포함된 응답을 읽을 때 발생하던 문제를 수정했습니다. #1468
  • asset 하위 폴더 내의 비디오를 디코딩할 때 발생하던 문제를 수정했습니다. #1489
  • androidx.annotation을 1.5.0으로 업데이트했습니다.

[2.2.1] - 2022년 9월 8일 ​

  • 수정: RoundedCornersTransformation이 이제 input 비트맵의 배율을 올바르게 조정합니다.
  • kotlin-parcelize 플러그인에 대한 의존성을 제거했습니다.
  • 컴파일 SDK를 33으로 업데이트했습니다.
  • #1423 문제의 임시 해결책으로 androidx.appcompat:appcompat-resources를 1.4.2로 다운그레이드했습니다.

[2.2.0] - 2022년 8월 16일 ​

  • 신규: 비디오 재생 시간의 백분율로 비디오 프레임을 지정할 수 있도록 coil-video에 ImageRequest.videoFramePercent를 추가했습니다.
  • 신규: BitmapFactoryDecoder가 EXIF 방향 데이터를 처리하는 방식을 구성할 수 있도록 ExifOrientationPolicy를 추가했습니다.
  • 수정: 크기에 정의되지 않은 치수가 전달된 경우 RoundedCornersTransformation에서 예외를 던지지 않도록 수정했습니다.
  • 수정: GIF의 프레임 딜레이를 부호 있는 1바이트 대신 부호 없는 2바이트로 읽도록 수정했습니다.
  • 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의 private 메서드를 protected로 변경했습니다. (#1273)
  • 컴파일 SDK를 32로 업데이트했습니다. (#1268)

[2.0.0] - 2022년 5월 10일 ​

Coil 2.0.0은 라이브러리의 주요 버전 개편 릴리스이며 호환성이 깨지는 변경 사항(breaking changes)을 포함합니다. 업그레이드 방법은 업그레이드 가이드를 확인하세요.

  • 신규: coil-compose에 AsyncImage를 도입했습니다. 자세한 정보는 공식 문서를 확인하세요.
kotlin
// 네트워크에서 이미지 표시
AsyncImage(
    model = "https://example.com/image.jpg",
    contentDescription = null,
)

// 플레이스홀더, 원형 자르기(circle crop), 크로스페이드 애니메이션과 함께 네트워크에서 이미지 표시
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)
)
  • 신규: 공개 DiskCache API를 도입했습니다.
    • 디스크 캐시를 구성하려면 ImageLoader.Builder.diskCache 및 DiskCache.Builder를 사용하세요.
    • Coil 2.0에서는 OkHttp의 Cache를 사용하지 않아야 합니다. 자세한 정보는 여기를 확인하세요.
    • Cache-Control 및 기타 캐시 헤더는 여전히 지원됩니다. 단, 캐시는 URL 일치 여부만 확인하므로 Vary 헤더는 제외됩니다. 또한 응답 코드가 [200..300) 범위에 있는 응답만 캐시됩니다.
    • 2.0으로 업그레이드할 때 기존 디스크 캐시는 삭제됩니다.
  • 최소 지원 API 버전이 이제 21입니다.
  • ImageRequest의 기본 Scale이 이제 Scale.FIT입니다.
    • 기본 Scale을 갖는 다른 클래스들과 일관성을 맞추기 위해 ImageRequest.scale이 변경되었습니다.
    • ImageViewTarget을 사용하는 요청은 여전히 Scale이 자동으로 감지됩니다.
  • 이미지 파이프라인 클래스 개편:
    • 유연성을 높이기 위해 Mapper, Fetcher, Decoder가 리팩터링되었습니다.
    • Fetcher.key가 새로운 Keyer 인터페이스로 대체되었습니다. Keyer는 입력 데이터로부터 캐시 키를 생성합니다.
    • Decoder가 Okio의 파일 시스템 API를 사용하여 직접 File을 읽을 수 있도록 지원하는 ImageSource를 추가했습니다.
  • Jetpack Compose 통합 개편:
    • rememberImagePainter 및 ImagePainter의 이름이 각각 rememberAsyncImagePainter 및 AsyncImagePainter로 변경되었습니다.
    • LocalImageLoader를 지원 중단했습니다. 자세한 정보는 지원 중단 메시지를 확인하세요.
  • 런타임 not-null 단언문 생성을 비활성화했습니다.
    • Java를 사용하는 경우 not-null로 애너테이션된 인자에 null을 전달해도 더 이상 즉시 NullPointerException이 발생하지 않습니다. Kotlin의 컴파일 타임 널 안전성이 이러한 상황을 방지합니다.
    • 이 변경을 통해 라이브러리 크기를 줄일 수 있습니다.
  • Size가 이제 너비와 높이를 나타내는 두 개의 Dimension 값으로 구성됩니다. Dimension은 양수의 픽셀 값이거나 Dimension.Undefined일 수 있습니다. 자세한 내용은 여기를 참조하세요.
  • BitmapPool 및 PoolableViewTarget이 라이브러리에서 제거되었습니다.
  • VideoFrameFileFetcher 및 VideoFrameUriFetcher가 라이브러리에서 제거되었습니다. 대신 모든 데이터 소스를 지원하는 VideoFrameDecoder를 사용하세요.
  • BlurTransformation 및 GrayscaleTransformation이 라이브러리에서 제거되었습니다. 이를 사용하는 경우 해당 코드를 프로젝트로 복사하여 사용할 수 있습니다.
  • 전환이 완료될 때까지 지연시킬 필요가 없어짐에 따라 Transition.transition을 non-suspending 함수로 변경했습니다.
  • 진행 중인 BitmapFactory 작업의 최대 수를 제한하는 bitmapFactoryMaxParallelism 지원을 추가했습니다. 이 값은 기본적으로 4이며 UI 성능을 향상시킵니다.
  • interceptorDispatcher, fetcherDispatcher, decoderDispatcher, transformationDispatcher 지원을 추가했습니다.
  • 공통 ViewTarget 로직을 처리하는 GenericViewTarget을 추가했습니다.
  • 기본 지원 데이터 타입에 ByteBuffer를 추가했습니다.
  • Disposable이 리팩터링되었으며 내부 ImageRequest의 잡(Job)을 노출합니다.
  • MemoryCache API를 개편했습니다.
  • 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 빌더 인자가 마지막이 아닌 처음에 적용되던 문제를 수정했습니다.
  • 응답이 수정되지 않은(not modified) 경우 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 함수들을 제거했습니다.

[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 및 기타 캐시 헤더는 여전히 지원됩니다. 단, 캐시는 URL 일치 여부만 확인하므로 Vary 헤더는 제외됩니다. 또한 응답 코드가 [200..300) 범위에 있는 응답만 캐시됩니다.
    • 2.0으로 업그레이드할 때 기존 디스크 캐시는 삭제됩니다.
  • ImageRequest의 기본 Scale이 이제 Scale.FIT입니다.
    • 기본 Scale을 갖는 다른 클래스들과 일관성을 맞추기 위해 ImageRequest.scale이 변경되었습니다.
    • ImageViewTarget을 사용하는 요청은 여전히 Scale이 자동으로 감지됩니다.
  • ImageRequest의 기본 크기가 이제 Size.ORIGINAL입니다.
  • 이미지 파이프라인 클래스 개편:
    • 유연성을 높이기 위해 Mapper, Fetcher, Decoder가 리팩터링되었습니다.
    • Fetcher.key가 새로운 Keyer 인터페이스로 대체되었습니다. Keyer는 입력 데이터로부터 캐시 키를 생성합니다.
    • Decoder가 Okio의 파일 시스템 API를 사용하여 직접 File을 읽을 수 있도록 지원하는 ImageSource를 추가했습니다.
  • 런타임 not-null 단언문 생성을 비활성화했습니다.
    • Java를 사용하는 경우 not-null로 애너테이션된 매개변수에 null을 전달해도 더 이상 즉시 NullPointerException이 발생하지 않습니다. Kotlin의 컴파일 타임 널 안전성이 이러한 상황을 방지합니다.
    • 이 변경을 통해 라이브러리 크기를 줄일 수 있습니다.
  • Size가 이제 너비와 높이를 나타내는 두 개의 Dimension 값으로 구성됩니다. Dimension은 양수의 픽셀 값이거나 Dimension.Original일 수 있습니다.
  • BitmapPool 및 PoolableViewTarget이 라이브러리에서 제거되었습니다.
  • VideoFrameFileFetcher 및 VideoFrameUriFetcher가 라이브러리에서 제거되었습니다. 대신 모든 데이터 소스를 지원하는 VideoFrameDecoder를 사용하세요.
  • BlurTransformation 및 GrayscaleTransformation이 라이브러리에서 제거되었습니다. 이를 사용하는 경우 해당 코드를 프로젝트로 복사하여 사용할 수 있습니다.
  • 전환이 완료될 때까지 지연시킬 필요가 없어짐에 따라 Transition.transition을 non-suspending 함수로 변경했습니다.
  • 진행 중인 BitmapFactory 작업의 최대 수를 제한하는 bitmapFactoryMaxParallelism 지원을 추가했습니다. 이 값은 기본적으로 4이며 UI 성능을 향상시킵니다.
  • interceptorDispatcher, fetcherDispatcher, decoderDispatcher, transformationDispatcher 지원을 추가했습니다.
  • 공통 ViewTarget 로직을 처리하는 GenericViewTarget을 추가했습니다.
  • 기본 지원 데이터 타입에 ByteBuffer를 추가했습니다.
  • Disposable이 리팩터링되었으며 내부 ImageRequest의 잡을 노출합니다.
  • MemoryCache API를 개편했습니다.
  • 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에 설정된 값과 동일하게 설정해야 합니다.
  • ImageRequest의 Scale을 지연 계산할 수 있도록 지원하는 ScaleResolver를 추가했습니다. (#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일 ​

  • Okio의 FileSystem API를 사용하도록 DiskCache 및 ImageSource를 업데이트했습니다. (#1115)

[2.0.0-alpha07] - 2022년 1월 30일 ​

  • AsyncImage 성능을 대폭 개선하고 AsyncImage를 AsyncImage와 SubcomposeAsyncImage로 분리했습니다. (#1048)
    • SubcomposeAsyncImage는 loading/success/error/content 슬롯 API를 제공하며, 성능이 상대적으로 떨어지는 subcomposition을 사용합니다.
    • AsyncImage는 로딩 중이거나 요청이 실패했을 때 그려지는 Painter를 덮어쓸 수 있는 placeholder/error/fallback 인자를 제공합니다. AsyncImage는 subcomposition을 사용하지 않으므로 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로 이동했습니다. coil-svg에 isSvg를 추가했습니다. (#1117)
  • FetchResult 및 DecodeResult를 일반(non-data) 클래스로 변환했습니다. (#1114)
  • 사용되지 않는 DiskCache.Builder 컨텍스트 인자를 제거했습니다. (#1099)
  • 원본 크기를 갖는 비트맵 리소스의 배율 조정을 수정했습니다. (#1072)
  • ImageDecoderDecoder에서 ImageDecoder를 닫지 못하던 문제를 수정했습니다. (#1109)
  • 드로어블을 비트맵으로 변환할 때 잘못된 배율이 적용되던 문제를 수정했습니다. (#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일 ​

  • 버퍼링이나 임시 파일 없이 에셋, 리소스 및 콘텐츠 URI로부터 디코딩을 지원하도록 ImageSource.Metadata를 추가했습니다. (#1060)
  • AsyncImage가 양수의 제약 조건을 가질 때까지 이미지 요청 실행을 지연하도록 변경했습니다. (#1028)
  • loading, success, error가 모두 설정된 경우 AsyncImage에 DefaultContent를 사용하던 문제를 수정했습니다. (#1026)
  • 플랫폼 LruCache 대신 androidx 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일 수 있습니다.
    • 이 변경은 한쪽 치수가 고정 픽셀 값일 때 무제한(unbounded) 너비/높이 값(예: wrap_content, Constraints.Infinity)을 더 잘 지원하기 위해 이루어졌습니다.
  • 수정: AsyncImage에 대한 인스펙션 모드(미리보기)를 지원합니다.
  • 수정: imageLoader.memoryCache가 null인 경우 SuccessResult.memoryCacheKey는 항상 null이어야 하도록 수정했습니다.
  • 생성자 스타일의 ImageLoader, SizeResolver, ViewSizeResolver의 invoke 함수를 최상위(top-level) 함수로 변환했습니다.
  • CrossfadeDrawable의 시작 및 종료 드로어블을 공개 API로 전환했습니다.
  • ImageLoader의 placeholder/error/fallback 드로어블을 mutate(독립 복제)하도록 변경했습니다.
  • SuccessResult 생성자에 기본 인자를 추가했습니다.
  • androidx.collection-ktx 대신 androidx.collection에 의존하도록 변경했습니다.
  • 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 미리보기를 수정했습니다.
  • 더 효율적인 코드를 생성하도록 LocalImageLoader.current에 @ReadOnlyComposable을 마킹했습니다.
  • Compose를 1.1.0-beta03으로 업데이트하고 compose.ui 대신 compose.foundation에 의존하도록 변경했습니다.
  • 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에 병합됨에 따라 lifecycle-common-java8에 대한 의존성을 제거했습니다.

[2.0.0-alpha02] - 2021년 10월 24일 ​

  • BOM(Bill of Materials)을 포함하는 새로운 coil-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의 안정화 버전이 출시될 때까지 향후 알파 릴리스와 바이너리/소스 호환성이 유지되지 않을 수 있습니다.

  • 중요: 최소 지원 API 버전이 이제 21입니다.
  • 중요: -Xjvm-default=all을 활성화했습니다.
    • 이를 통해 Kotlin의 기본 인터페이스 메서드 지원 대신 Java 8 디폴트 메서드가 생성됩니다. 자세한 내용은 해당 블로그 포스트를 확인하세요.
    • 빌드 파일에도 -Xjvm-default=all 또는 -Xjvm-default=all-compatibility를 추가해야 합니다. 설정 방법은 여기를 참조하세요.
  • 중요: Coil은 이제 자체 디스크 캐시 구현체를 가지며 디스크 캐싱을 위해 OkHttp에 의존하지 않습니다.
    • 이 변경은 다음을 위해 이루어졌습니다:
      • 이미지 디코딩 중 스레드 인터럽트를 더 잘 지원합니다. 이를 통해 이미지 요청이 빠르게 연속해서 시작되고 중지될 때 성능이 향상됩니다.
      • File 기반의 ImageSource 노출을 지원합니다. Android API가 디코딩을 위해 File을 요구할 때(예: MediaMetadataRetriever) 불필요한 복사를 방지할 수 있습니다.
      • 디스크 캐시 파일에서 직접 읽기/쓰기를 지원합니다.
    • 디스크 캐시를 구성하려면 ImageLoader.Builder.diskCache 및 DiskCache.Builder를 사용하세요.
    • 디스크에 쓰는 도중 인터럽트가 발생하면 캐시가 손상될 수 있으므로 Coil 2.0에서는 OkHttp의 Cache를 사용하지 않아야 합니다.
    • Cache-Control 및 기타 캐시 헤더는 여전히 지원됩니다. 단, 캐시는 URL 일치 여부만 확인하므로 Vary 헤더는 제외됩니다. 또한 응답 코드가 [200..300) 범위에 있는 응답만 캐시됩니다.
    • 캐시 헤더 지원은 ImageLoader.Builder.respectCacheHeaders를 사용하여 활성화하거나 비활성화할 수 있습니다.
    • 2.0으로 업그레이드할 때 기존 디스크 캐시는 지워지고 다시 빌드됩니다.
  • 중요: ImageRequest의 기본 Scale이 이제 Scale.FIT입니다.
    • 기본 Scale을 갖는 다른 클래스들과 일관성을 유지하도록 ImageRequest.scale이 변경되었습니다.
    • ImageViewTarget을 사용하는 요청은 여전히 배율이 자동으로 감지됩니다.
  • 이미지 파이프라인 클래스에 대한 대대적 변경:
    • 유연성을 높이기 위해 Mapper, Fetcher, Decoder가 리팩터링되었습니다.
    • Fetcher.key가 새로운 Keyer 인터페이스로 대체되었습니다. Keyer는 입력 데이터로부터 캐시 키를 생성합니다.
    • Decoder가 직접 File을 디코딩할 수 있도록 지원하는 ImageSource를 추가했습니다.
  • BitmapPool 및 PoolableViewTarget이 라이브러리에서 제거되었습니다. 비트맵 풀링이 제거된 이유는 다음과 같습니다:
    • API 23 이하에서 가장 효과적이었으며, 최신 Android 릴리스에서는 그 효과가 점차 줄어들었습니다.
    • 비트맵 풀링을 제거함으로써 성능상 이점이 있는 불변(immutable) 비트맵을 Coil에서 사용할 수 있게 됩니다.
    • 비트맵 풀을 관리하는 데 따른 런타임 오버헤드가 존재합니다.
    • 비트맵 풀링은 비트맵이 풀링에 적합한지 여부를 추적해야 하므로 Coil의 API에 설계상의 제약을 만들었습니다. 비트맵 풀링을 제거하면 Coil이 더 많은 곳(예: Listener, Disposable)에서 결과 Drawable을 노출할 수 있습니다. 또한 Coil이 ImageView를 지울 필요가 없어지므로 여러 문제를 방지할 수 있습니다.
    • 비트맵 풀링은 오류가 발생하기 쉽습니다. 새 비트맵을 할당하는 것이 여전히 사용 중일 수 있는 비트맵을 재사용하려고 시도하는 것보다 훨씬 안전합니다.
  • 유연성을 높이기 위해 MemoryCache를 리팩터링했습니다.
  • 런타임 not-null 단언문 생성을 비활성화했습니다.
    • Java를 사용하는 경우 not-null로 애너테이션된 매개변수에 null을 전달해도 더 이상 즉시 NullPointerException이 발생하지 않습니다. Kotlin을 사용하는 경우에는 실질적인 변화가 없습니다.
    • 이 변경을 통해 라이브러리 크기를 줄일 수 있습니다.
  • VideoFrameFileFetcher 및 VideoFrameUriFetcher가 라이브러리에서 제거되었습니다. 대신 모든 데이터 소스를 지원하는 VideoFrameDecoder를 사용하세요.
  • 진행 중인 BitmapFactory 작업의 최대 수를 제한하는 bitmapFactoryMaxParallelism 지원을 추가했습니다. 이 값은 기본적으로 4이며 UI 성능을 향상시킵니다.
  • interceptorDispatcher, fetcherDispatcher, decoderDispatcher, transformationDispatcher 지원을 추가했습니다.
  • Disposable이 리팩터링되었으며 내부 ImageRequest의 잡을 노출합니다.
  • 전환이 완료될 때까지 지연시킬 필요가 없어짐에 따라 Transition.transition을 non-suspending 함수로 변경했습니다.
  • 공통 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 메서드를 공개 API로 전환했습니다. (#925)
  • accompanist-drawablepainter에 의존하도록 하고 Coil의 커스텀 DrawablePainter 구현을 제거했습니다. (#845)
  • 디슈가링(desugaring) 문제를 방지하기 위해 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.foundation 대신 compose.ui에 의존합니다.
    • 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 연동을 기반으로 하지만 몇 가지 변경 사항이 있습니다. 자세한 내용은 문서를 참조하세요.
  • Transformation에 대한 자동 비트맵 변환을 활성화/비활성화할 수 있도록 allowConversionToBitmap을 추가했습니다. (#775)
  • GIF의 프레임 딜레이가 임계값 미만인 경우 이를 다시 작성할 수 있도록 ImageDecoderDecoder 및 GifDecoder에 enforceMinimumFrameDelay를 추가했습니다. (#783)
    • 이는 기본적으로 비활성화되어 있지만 향후 릴리스에서는 기본적으로 활성화될 예정입니다.
  • ImageLoader 내부 네트워크 관찰자의 활성화/비활성화 지원을 추가했습니다. (#741)
  • BitmapFactoryDecoder에 의해 디코딩된 비트맵의 밀도를 수정했습니다. (#776)
  • Licensee가 Coil의 라이선스 URL을 찾지 못하던 문제를 수정했습니다. (#774)
  • androidx.core:core-ktx를 1.6.0으로 업데이트했습니다.

[1.2.2] - 2021년 6월 4일 ​

  • 공유 상태를 가진 드로어블을 비트맵으로 변환할 때 발생하던 경쟁 상태를 수정했습니다. (#771)
  • ImageLoader.Builder.fallback이 fallback 드로어블 대신 error 드로어블을 설정하던 문제를 수정했습니다.
  • ResourceUriFetcher가 잘못된 데이터 소스를 반환하던 문제를 수정했습니다. (#770)
  • API 26 및 27에서 사용 가능한 파일 디스크립터가 없는지 확인하는 로그 검사를 수정했습니다.
  • 플랫폼 벡터 드로어블 지원에 대한 잘못된 버전 검사를 수정했습니다. (#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에서 종횡비(aspect ratio)를 계산할 때 SVG의 뷰 바운드(view bounds)를 사용하도록 변경했습니다. (#688)
    • 이전에는 SvgDecoder가 종횡비를 결정하기 위해 SVG의 width/height 요소를 사용했으나, 이는 SVG 사양을 올바르게 따르지 않는 방식이었습니다.
    • 이전 동작으로 되돌리려면 SvgDecoder를 생성할 때 useViewBoundsAsIntrinsicSize = false를 설정하세요.
  • 신규: 모든 소스에서 비디오 프레임 디코딩을 지원하는 VideoFrameDecoder를 추가했습니다. (#689)
  • 신규: MIME 타입뿐만 아니라 소스의 내용을 기반으로 하는 자동 SVG 감지를 지원합니다. (#654)
  • 신규: ImageLoader.newBuilder()를 사용한 리소스 공유를 지원합니다. (#653)
    • 특히, 이를 통해 ImageLoader 인스턴스 간에 메모리 캐시를 공유할 수 있습니다.
  • 신규: AnimatedTransformation을 사용한 애니메이션 이미지 변환 지원을 추가했습니다. (#659)
  • 신규: 애니메이션 드로어블에 대한 시작/종료 콜백 지원을 추가했습니다. (#676)

  • HEIF/HEIC 파일의 EXIF 데이터 파싱을 수정했습니다. (#664)
  • 비트맵 풀링이 비활성화된 경우 EmptyBitmapPool 구현체를 사용하지 않던 문제를 수정했습니다. (#638)
    • 이 수정 전에도 비트맵 풀링은 정상적으로 비활성화되었으나 더 무거운 BitmapPool 구현체를 사용하고 있었습니다.
  • MovieDrawable.getOpacity가 잘못 투명(transparent)을 반환하던 문제를 수정했습니다. (#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가 무한정 차단(block)되던 문제를 수정했습니다.
    • ImageRequest.dispatcher(Dispatchers.Main.immediate)를 사용하여 메인 스레드에서 강제로 실행되는 요청은 ImageRequest.networkCachePolicy가 CachePolicy.DISABLED 또는 CachePolicy.WRITE_ONLY로 설정되지 않은 한 NetworkOnMainThreadException으로 실패합니다.
  • 비디오에 회전 메타데이터가 있는 경우 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일 ​

  • 중요: ImageView의 CENTER 및 MATRIX 스케일 타입이 OriginalSize로 결정되도록 변경했습니다. (#587)
    • 이 변경은 요청 크기가 명시적으로 지정되지 않았을 때의 암시적 크기 결정 알고리즘에만 영향을 미칩니다.
    • 이미지 요청의 시각적 결과가 ImageView.setImageResource/ImageView.setImageURI와 일관되도록 하기 위해 이 변경이 이루어졌습니다. 이전 동작으로 되돌리려면 요청 구성 시 ViewSizeResolver를 설정하세요.
  • 중요: 뷰의 레이아웃 매개변수가 WRAP_CONTENT인 경우 ViewSizeResolver에서 디스플레이 크기를 반환하도록 변경했습니다. (#562)
    • 이전에는 뷰가 완전히 배치(layout)된 경우에만 디스플레이 크기를 반환했습니다. 이 변경을 통해 일반적인 동작이 보다 일관되고 직관적으로 변경되었습니다.
  • 알파 프리멀티플리케이션(pre-multiplication) 제어 기능을 추가했습니다. (#569)
  • CrossfadeDrawable에서 정확한 고유 크기 선호 설정을 지원합니다. (#585)
  • 버전을 포함한 완전한 GIF 헤더를 확인하도록 변경했습니다. (#564)
  • 빈(empty) 비트맵 풀 구현체를 추가했습니다. (#561)
  • EventListener.Factory를 함수형 인터페이스(functional interface)로 만들었습니다. (#575)
  • EventListener를 안정화했습니다. (#574)
  • ImageRequest.Builder.placeholderMemoryCacheKey에 대한 String 오버로드를 추가했습니다.
  • ViewSizeResolver 생성자에 @JvmOverloads를 추가했습니다.
  • 수정: CrossfadeDrawable에서 시작/종료 드로어블을 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)
  • 싱글톤 이미지 로더가 교체되더라도 이전 이미지 로더를 종료(shutdown)하지 않도록 변경했습니다. (#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 컴파일러 플래그 사용을 되돌렸습니다.
    • 이는 이전 릴리스 후보(RC) 버전 대비 소스 호환성은 유지되지만 바이너리 호환성은 깨지는 변경 사항입니다.
  • 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에 포함된 모든 변경 사항이 적용되었습니다.
  • stdlib-jdk8 대신 기본 Kotlin stdlib에 의존하도록 변경했습니다.

[0.13.0] - 2020년 9월 3일 ​

  • 중요: 기본적으로 인터셉터 체인을 메인 스레드에서 시작하도록 변경했습니다. (#513)
    • 이를 통해 메모리 캐시를 메인 스레드에서 동기적으로 확인하던 0.11.0 이하의 동작이 대폭 복원됩니다.
    • ImageRequest.dispatcher에서 메모리 캐시를 확인하던 0.12.0과 동일한 동작으로 되돌리려면 ImageLoader.Builder.launchInterceptorChainOnMainThread(false)를 설정하세요.
    • 자세한 정보는 launchInterceptorChainOnMainThread를 확인하세요.

  • 수정: 분리된(detached) 프래그먼트의 ViewTarget에서 요청이 시작될 때 발생할 수 있던 잠재적 메모리 누수를 수정했습니다. (#518)
  • 수정: 리소스 URI 로드 시 ImageRequest.context를 사용하도록 수정했습니다. (#517)
  • 수정: 후속 요청이 디스크 캐시에 저장되지 않던 경쟁 상태를 수정했습니다. (#510)
  • 수정: API 18에서 blockCountLong 및 blockSizeLong을 사용하도록 수정했습니다.

  • ImageLoaderFactory를 fun 인터페이스로 변경했습니다.
  • File에서 로드된 이미지의 메모리 캐시 키에 최종 수정 타임스탬프를 추가할지 여부를 설정할 수 있는 ImageLoader.Builder.addLastModifiedToFileCacheKey를 추가했습니다.

  • 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일 ​

  • 주요 변경 사항(Breaking): LoadRequest 및 GetRequest가 ImageRequest로 대체되었습니다:
    • ImageLoader.execute(LoadRequest) -> ImageLoader.enqueue(ImageRequest)
    • ImageLoader.execute(GetRequest) -> ImageLoader.execute(ImageRequest)
    • ImageRequest는 equals/hashCode를 구현합니다.
  • 주요 변경 사항(Breaking): 여러 클래스의 이름이 변경되거나 패키지가 변경되었습니다:
    • coil.request.RequestResult -> coil.request.ImageResult
    • coil.request.RequestDisposable -> coil.request.Disposable
    • coil.bitmappool.BitmapPool -> coil.bitmap.BitmapPool
    • coil.DefaultRequestOptions -> coil.request.DefaultRequestOptions
  • 주요 변경 사항(Breaking): 공개 API에서 SparseIntArraySet이 제거되었습니다.
  • 주요 변경 사항(Breaking): TransitionTarget이 더 이상 ViewTarget을 구현하지 않습니다.
  • 주요 변경 사항(Breaking): ImageRequest.Listener.onSuccess의 시그니처가 단순 DataSource 대신 ImageResult.Metadata를 반환하도록 변경되었습니다.
  • 주요 변경 사항(Breaking): LoadRequest.aliasKeys 지원을 제거했습니다. 이 API는 메모리 캐시에 대한 직접 읽기/쓰기 접근을 통해 더 잘 처리할 수 있습니다.

  • 중요: 메모리 캐시의 값이 더 이상 동기적으로 확인되지 않습니다(메인 스레드에서 호출된 경우).
    • 이 변경은 백그라운드 디스패처에서 Interceptor를 실행할 수 있도록 지원하기 위해 필요했습니다.
    • 또한 이 변경을 통해 메인 스레드 외부로 더 많은 작업을 이동시켜 성능을 향상시킵니다.
  • 중요: Mapper가 이제 백그라운드 디스패처에서 실행됩니다. 부수 효과로 자동 비트맵 샘플링이 더 이상 자동으로 지원되지 않습니다. 동일한 효과를 얻으려면 이전 요청의 MemoryCache.Key를 후속 요청의 placeholderMemoryCacheKey로 사용하세요. 예시는 여기를 참조하세요.
    • placeholderMemoryCacheKey API는 서로 다른 데이터를 가진 두 이미지 요청(예: 작음/큼 이미지에 대한 서로 다른 URL)을 "연결"할 수 있어 더 많은 자유도를 제공합니다.
  • 중요: Coil의 ImageView 확장 함수가 coil.api 패키지에서 coil 패키지로 이동되었습니다.
    • 찾기 및 바꾸기를 사용하여 import coil.api.load -> import coil.load로 리팩터링하세요. 아쉽게도 import 문을 대체하기 위해 Kotlin의 ReplaceWith 기능을 사용할 수는 없습니다.
  • 중요: 드로어블이 동일한 이미지가 아닌 경우 표준 크로스페이드를 사용하도록 변경했습니다.
  • 중요: API 24 이상에서는 불변 비트맵을 선호하도록 변경했습니다.
  • 중요: 새로운 Interceptor 인터페이스를 선호하여 MeasuredMapper를 지원 중단했습니다. MeasuredMapper를 Interceptor로 변환하는 방법의 예는 여기를 참조하세요.
    • Interceptor는 훨씬 덜 제한적인 API로, 더 다양한 커스텀 로직을 허용합니다.
  • 중요: ImageRequest.data가 이제 non-null입니다. 데이터를 설정하지 않고 ImageRequest를 생성하면 데이터로 NullRequestData를 반환합니다.

  • 신규: ImageLoader의 MemoryCache에 대한 직접 읽기/쓰기 접근 지원을 추가했습니다. 자세한 정보는 공식 문서를 확인하세요.
  • 신규: Interceptor 지원을 추가했습니다. 자세한 정보는 공식 문서를 확인하세요. Coil의 Interceptor 디자인은 OkHttp에서 많은 영감을 받았습니다!
  • 신규: ImageLoader.Builder.bitmapPoolingEnabled를 사용하여 비트맵 풀링을 활성화/비활성화하는 기능을 추가했습니다.
    • 비트맵 풀링은 API 23 이하에서 가장 효과적이지만, API 24 이상에서도 (Bitmap.recycle을 적극적으로 호출함으로써) 여전히 유용할 수 있습니다.
  • 신규: 디코딩 중 스레드 인터럽트를 지원합니다.

  • content-type 헤더의 다중 세그먼트 파싱을 수정했습니다.
  • 비트맵 참조 카운팅이 보다 견고해지도록 개편했습니다.
  • 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.0
    • androidx.core:core-ktx -> 1.3.1

[0.11.0] - 2020년 5월 14일 ​

  • 주요 변경 사항(Breaking): 이 버전에서는 기존의 모든 지원 중단 함수를 제거했습니다.
    • 이를 통해 앱 시작 시 아무런 코드도 실행하지 않도록 Coil의 ContentProvider를 제거할 수 있게 되었습니다.
  • 주요 변경 사항(Breaking): SparseIntArraySet.size를 val로 변경했습니다. (#380)
  • 주요 변경 사항(Breaking): Parameters.count()를 확장 함수로 이동했습니다. (#403)
  • 주요 변경 사항(Breaking): BitmapPool.maxSize를 Int로 변경했습니다. (#404)

  • 중요: ImageLoader.shutdown()을 선택적(optional)으로 변경했습니다(OkHttpClient와 유사). (#385)

  • 수정: AGP 4.1 호환성을 수정했습니다. (#386)
  • 수정: GONE 상태인 뷰의 측정을 수정했습니다. (#397)

  • 기본 메모리 캐시 크기를 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를 추가했습니다.

  • 싱글톤 초기화를 단순화하기 위해 Application에서 구현할 수 있는 ImageLoaderFactory를 추가했습니다.


전체 릴리스 노트 ​

  • 중요: 빌더 구문을 선호하여 DSL 구문을 지원 중단했습니다. (#267)
  • 중요: Coil 및 ImageLoader 확장 함수를 지원 중단했습니다. (#322)
  • 주요 변경 사항(Breaking): ImageLoader.execute(GetRequest)에서 봉인된(sealed) RequestResult 타입을 반환하도록 변경했습니다. (#349)
  • 주요 변경 사항(Breaking): ExperimentalCoil의 이름을 ExperimentalCoilApi로 변경했습니다. @Experimental에서 @RequiresOptIn으로 마이그레이션했습니다. (#306)
  • 주요 변경 사항(Breaking): CoilLogger를 Logger 인터페이스로 대체했습니다. (#316)
  • 주요 변경 사항(Breaking): destWidth/destHeight의 이름을 dstWidth/dstHeight로 변경했습니다. (#275)
  • 주요 변경 사항(Breaking): MovieDrawable의 생성자 매개변수를 재정렬했습니다. (#272)
  • 주요 변경 사항(Breaking): Request.Listener의 메서드가 이제 데이터뿐만 아니라 전체 Request 객체를 받습니다.
  • 주요 변경 사항(Breaking): GetRequestBuilder의 생성자에 이제 Context가 필요합니다.
  • 주요 변경 사항(Breaking): Request의 여러 프로퍼티가 nullable로 변경되었습니다.
  • 동작 변경: 매개변수 값을 캐시 키에 기본적으로 포함하도록 변경했습니다. (#319)
  • 동작 변경: Target.onStart() 직후에 호출되도록 Request.Listener.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 및 fallback 드로어블을 지원합니다.

  • 수정: Transformation이 입력 비트맵의 크기를 줄일 때 메모리 캐시 미스가 발생하던 문제를 수정했습니다. (#357)
  • 수정: BlurTransformation에서 반지름이 RenderScript 최댓값 미만인지 확인하도록 보장했습니다. (#291)
  • 수정: 높은 색 심도(high colour depth) 이미지 디코딩을 수정했습니다. (#358)
  • 수정: Android 11 이상에서 ImageDecoderDecoder 충돌 방지 임시 코드를 비활성화했습니다. (#298)
  • 수정: API 23 미만에서 EXIF 데이터를 읽지 못하던 문제를 수정했습니다. (#331)
  • 수정: Android R SDK와의 비호환성을 수정했습니다. (#337)
  • 수정: ImageView에 일치하는 SizeResolver가 있는 경우에만 부정확한 크기(inexact size)를 활성화하도록 수정했습니다. (#344)
  • 수정: 캐시된 이미지가 요청된 크기에서 최대 1픽셀까지 차이나는 것을 허용하도록 수정했습니다. (#360)
  • 수정: 뷰가 보이지 않는 경우 크로스페이드 전환을 건너뛰도록 수정했습니다. (#361)

  • CoilContentProvider를 지원 중단했습니다. (#293)
  • 여러 ImageLoader 메서드에 @MainThread 애너테이션을 추가했습니다.
  • 수명 주기가 현재 시작된 상태인 경우 LifecycleCoroutineDispatcher를 생성하지 않도록 방지했습니다. (#356)
  • OriginalSize.toString()에 전체 패키지 이름을 사용하도록 했습니다.
  • 소프트웨어 비트맵을 디코딩할 때 사전 할당(preallocate)하도록 변경했습니다. (#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일 ​

  • 수정: 하드웨어 가속 여부를 확인하기 전에 뷰가 연결(attached)되어 있는지 확인하도록 보장했습니다. 이를 통해 하드웨어 비트맵을 요청할 때 메모리 캐시 미스가 발생할 수 있던 케이스를 수정했습니다.

  • AndroidX 의존성을 업데이트했습니다:
    • androidx.core:core-ktx -> 1.2.0

[0.9.4] - 2020년 2월 3일 ​

  • 수정: ImageDecoderDecoder에서 다운샘플링할 때 종횡비를 준수하도록 수정했습니다. @zhanghai님께 감사드립니다.

  • 이전에는 캐시된 비트맵의 구성이 요청에 지정된 구성보다 크거나 같기만 하면 메모리 캐시에서 비트맵이 반환되었습니다. 예를 들어 ARGB_8888 비트맵을 요청한 경우 메모리 캐시에서 RGBA_F16 비트맵이 반환될 수 있었습니다. 이제는 캐시된 구성과 요청된 구성이 동일해야 합니다.
  • CrossfadeDrawable 및 CrossfadeTransition에서 scale 및 durationMillis를 공개로 변경했습니다.

[0.9.3] - 2020년 2월 1일 ​

  • 수정: 중앙에 위치하도록 ScaleDrawable 내부의 자식 드로어블을 평행 이동(translate)했습니다.
  • 수정: GIF 및 SVG가 경계를 완전히 채우지 못하던 케이스를 수정했습니다.

  • HttpUrl.get() 호출을 백그라운드 스레드로 지연시켰습니다.
  • BitmapFactory의 null 비트맵 오류 메시지를 개선했습니다.
  • 하드웨어 비트맵 블랙리스트에 기기 3개를 추가했습니다. (#264)

  • AndroidX 의존성을 업데이트했습니다:
    • androidx.lifecycle:lifecycle-common-java8 -> 2.2.0

[0.9.2] - 2020년 1월 19일 ​

  • 수정: API 19 미만에서 GIF 디코딩 문제를 수정했습니다. @mario님께 감사드립니다.
  • 수정: 래스터화된 벡터 드로어블이 샘플링된 것으로 표시되지 않던 문제를 수정했습니다.
  • 수정: Movie 치수가 0 이하인 경우 예외를 발생시키도록 수정했습니다.
  • 수정: 메모리 캐시 이벤트에 대해 CrossfadeTransition이 재개되지 않던 문제를 수정했습니다.
  • 수정: 허용되지 않은 경우 모든 타깃 메서드에 하드웨어 비트맵이 반환되지 않도록 방지했습니다.
  • 수정: MovieDrawable이 경계의 중앙에 위치하지 않던 문제를 수정했습니다.

  • CrossfadeDrawable에서 자동 배율 조정을 제거했습니다.
  • BitmapPool.trimMemory를 공개로 변경했습니다.
  • AnimatedImageDrawable이 경계를 채우도록 ScaleDrawable로 감쌌습니다.
  • RequestBuilder.setParameter에 @JvmOverloads를 추가했습니다.
  • SVG의 view box가 설정되어 있지 않은 경우 view box를 해당 크기로 설정했습니다.
  • CrossfadeDrawable 자식들에게 상태 및 레벨 변경 사항을 전달하도록 했습니다.

  • OkHttp를 3.12.8로 업데이트했습니다.

[0.9.1] - 2019년 12월 30일 ​

  • 수정: LoadRequestBuilder.crossfade(false)를 호출할 때 비정상 종료되던 문제를 수정했습니다.

[0.9.0] - 2019년 12월 30일 ​

  • 주요 변경 사항(Breaking): Transformation.transform에 이제 Size 매개변수가 포함됩니다. 이는 Target의 크기에 따라 출력 Bitmap의 크기를 변경하는 transformation을 지원하기 위함입니다. Transformation이 있는 요청은 이제 이미지 샘플링에서도 제외됩니다.
  • 주요 변경 사항(Breaking): Transformation이 이제 모든 타입의 Drawable에 적용됩니다. 이전에는 입력 Drawable이 BitmapDrawable이 아닌 경우 Transformation을 건너뛰었습니다. 이제는 Transformation을 적용하기 전에 Drawable을 Bitmap으로 렌더링합니다.
  • 주요 변경 사항(Breaking): ImageLoader.load에 null 데이터를 전달하는 것은 이제 오류로 처리되며 NullRequestDataException과 함께 Target.onError 및 Request.Listener.onError를 호출합니다. 이 변경은 데이터가 null인 경우 fallback 드로어블 설정을 지원하기 위해 도입되었습니다. 이전에는 요청이 조용히 무시되었습니다.
  • 주요 변경 사항(Breaking): RequestDisposable.isDisposed가 이제 val입니다.

  • 신규: 커스텀 전환 지원. 자세한 내용은 여기를 참조하세요. API가 인큐베이팅 단계이므로 전환은 실험적으로 마킹되어 있습니다.
  • 신규: LoadRequest가 진행되는 동안 일시 중단(suspending)할 수 있도록 RequestDisposable.await를 추가했습니다.
  • 신규: 요청 데이터가 null일 때 fallback 드로어블 설정을 지원합니다.
  • 신규: Precision 추가. 배율 조정을 지원하는 타깃(예: ImageViewTarget)에 대해 배율 최적화를 활성화하면서 출력 Drawable의 크기를 정확하게 만듭니다. 자세한 정보는 공식 문서를 확인하세요.
  • 신규: 여러 캐시 키 매칭을 지원하는 RequestBuilder.aliasKeys를 추가했습니다.

  • 수정: RequestDisposable을 스레드 안전하게 만들었습니다.
  • 수정: RoundedCornersTransformation이 이제 타깃의 크기로 자른 다음 모서리를 둥글게 처리합니다.
  • 수정: CircleCropTransformation이 이제 중앙에서부터 자릅니다.
  • 수정: 하드웨어 비트맵 블랙리스트에 여러 기기를 추가했습니다.
  • 수정: Drawable을 Bitmap으로 변환할 때 종횡비를 유지하도록 수정했습니다.
  • 수정: Scale.FIT에서 발생할 수 있던 메모리 캐시 미스 문제를 수정했습니다.
  • 수정: Parameters의 반복 순서가 결정론적(deterministic)이 되도록 보장했습니다.
  • 수정: Parameters 및 ComponentRegistry를 생성할 때 방어적 복사(defensive copy)를 수행하도록 했습니다.
  • 수정: RealBitmapPool의 maxSize가 0 이상이 되도록 보장했습니다.
  • 수정: CrossfadeDrawable이 애니메이션 중이 아니거나 완료된 경우 시작 드로어블을 표시하도록 수정했습니다.
  • 수정: 고유 크기가 정의되지 않은 자식을 고려하여 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일 ​

  • 주요 변경 사항(Breaking): SvgDrawable이 제거되었습니다. 대신 SVGs는 이제 SvgDecoder에 의해 BitmapDrawable로 사전 렌더링됩니다. 이를 통해 SVGs가 메인 스레드에서 렌더링되는 비용이 크게 감소합니다. 또한 SvgDecoder는 생성자에 Context를 필요로 합니다.
  • 주요 변경 사항(Breaking): SparseIntArraySet 확장 함수가 coil.extension 패키지로 이동했습니다.

  • 신규: 요청별 네트워크 헤더 설정을 지원합니다. 자세한 내용은 여기를 확인하세요.
  • 신규: 이미지 파이프라인을 통해 커스텀 데이터를 전달할 수 있도록 새로운 Parameters API를 추가했습니다.
  • 신규: RoundedCornersTransformation에서 개별 모서리 반지름 지원을 추가했습니다. @khatv911님께 감사드립니다.
  • 신규: 리소스를 사전에 확보할 수 있도록 ImageView.clear()를 추가했습니다.
  • 신규: 다른 패키지로부터의 리소스 로딩을 지원합니다.
  • 신규: 측정 시 뷰의 패딩을 제외할지 여부를 설정할 수 있도록 ViewSizeResolver에 subtractPadding 속성을 추가했습니다.
  • 신규: HttpUrlFetcher의 MIME 타입 감지를 개선했습니다.
  • 신규: MovieDrawable 및 CrossfadeDrawable에 Animatable2Compat 지원을 추가했습니다.
  • 신규: GIF의 반복 횟수를 설정하는 RequestBuilder<*>.repeatCount를 추가했습니다.
  • 신규: 공개 API에 BitmapPool 생성을 추가했습니다.
  • 신규: Request.Listener 메서드에 @MainThread 애너테이션을 추가했습니다.

  • 수정: 테스트를 위해 CoilContentProvider를 표시 가능하도록 변경했습니다.
  • 수정: 리소스 캐시 키에 야간 모드를 포함하도록 수정했습니다.
  • 수정: 소스를 임시로 디스크에 기록하여 ImageDecoder 네이티브 충돌을 우회했습니다.
  • 수정: 연락처 표시 사진 URI를 올바르게 처리하도록 수정했습니다.
  • 수정: CrossfadeDrawable의 자식들에게 틴트를 전달하도록 했습니다.
  • 수정: 소스를 닫지 않던 여러 인스턴스를 수정했습니다.
  • 수정: 하드웨어 비트맵 구현이 깨져 있거나 불완전한 기기들의 블랙리스트를 추가했습니다.

  • 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일 ​

  • 주요 변경 사항(Breaking): ImageLoaderBuilder.okHttpClient(OkHttpClient.Builder.() -> Unit)가 ImageLoaderBuilder.okHttpClient(() -> OkHttpClient)로 변경되었습니다. 초기화는 이제 백그라운드 스레드에서 지연 호출됩니다. 커스텀 OkHttpClient를 설정하는 경우 디스크 캐싱을 활성화하려면 반드시 OkHttpClient.cache를 설정해야 합니다. 커스텀 OkHttpClient를 설정하지 않으면 Coil은 디스크 캐싱이 활성화된 기본 OkHttpClient를 생성합니다. 기본 Coil 캐시는 CoilUtils.createDefaultCache(context)를 사용하여 생성할 수 있습니다. 예:
kotlin
val imageLoader = ImageLoader(context) {
    okHttpClient {
        OkHttpClient.Builder()
            .cache(CoilUtils.createDefaultCache(context))
            .build()
    }
}
  • 주요 변경 사항(Breaking): Fetcher.key에 더 이상 기본 구현이 제공되지 않습니다.
  • 주요 변경 사항(Breaking): 이전에는 적용 가능한 첫 번째 Mapper만 호출되었습니다. 이제는 적용 가능한 모든 Mapper가 호출됩니다. API 변경 사항은 없습니다.
  • 주요 변경 사항(Breaking): 사소한 명명된 매개변수 이름 변경: url -> uri, factory -> initializer.

  • 신규: SVG 자동 디코딩을 지원하는 SvgDecoder가 포함된 coil-svg 아티팩트. AndroidSVG 기반으로 구동됩니다. @rharter님께 감사드립니다.
  • 신규: load(String) 및 get(String)이 지원되는 모든 Uri 스킴을 허용합니다. 예: 이제 imageView.load("file:///path/to/file.jpg")를 수행할 수 있습니다.
  • 신규: OkHttpClient 대신 Call.Factory를 사용하도록 ImageLoader를 리팩터링했습니다. 이를 통해 ImageLoaderBuilder.okHttpClient { OkHttpClient() }를 사용하여 네트워킹 리소스를 지연 초기화할 수 있습니다. @ZacSweers님께 감사드립니다.
  • 신규: 요청에 대한 디코더를 명시적으로 설정할 수 있는 RequestBuilder.decoder.
  • 신규: ImageLoader에 대해 하드웨어 비트맵을 기본적으로 활성화/비활성화하는 ImageLoaderBuilder.allowHardware.
  • 신규: ImageDecoderDecoder에서 소프트웨어 렌더링을 지원합니다.

  • 수정: 벡터 드로어블 로드와 관련된 여러 버그를 수정했습니다.
  • 수정: WRAP_CONTENT View 치수를 지원합니다.
  • 수정: 8192바이트보다 긴 EXIF 데이터 파싱을 지원합니다.
  • 수정: 크로스페이드 시 서로 다른 종횡비를 가진 드로어블이 늘어나지 않도록 수정했습니다.
  • 수정: 예외로 인해 네트워크 관찰자가 등록에 실패하는 경우에 대한 방어 코드를 추가했습니다.
  • 수정: MovieDrawable의 0으로 나누기 오류를 수정했습니다. @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.0
    • androidx.core:core-ktx -> 1.1.0
    • androidx.lifecycle:lifecycle-common-java8 -> 2.1.0
  • 선택적 compileOnly 의존성인 appcompat을 appcompat-resources로 대체했습니다. appcompat-resources는 훨씬 더 작은 아티팩트입니다.

[0.6.1] - 2019년 8월 16일 ​

  • 신규: RequestBuilder에 transformations(List<Transformation>)를 추가했습니다.
  • 수정: 파일 uri의 캐시 키에 최종 수정 날짜를 추가했습니다.
  • 수정: View 치수가 최소 1px 이상으로 평가되도록 보장했습니다.
  • 수정: 프레임 간에 MovieDrawable의 캔버스를 지우도록 수정했습니다.
  • 수정: 에셋을 올바르게 열도록 수정했습니다.

[0.6.0] - 2019년 8월 12일 ​

  • 최초 릴리스입니다.