변경 로그

[3.5.0-beta01] - 2026년 5월 4일

iosX64 및 macosX64 타겟을 제거했습니다. (#3386)
Android 최소 SDK 버전을 23으로 상향했습니다. (#3283)
전체 Skia 디코딩으로 폴백(fallback)하는 것을 방지하기 위해 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-core와 함께 coil-lint를 배포하고, ImageRequest.Builder 블록에서 실수로 kotlin.error()를 호출하는 것을 방지하기 위한 린트 체크를 추가했습니다. (#3304)
Kotlin 언어 버전을 2.1로 설정했습니다. (#3302)
BitmapFetcher를 공통 코드(common code)에서 사용할 수 있게 했습니다. (#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 파서를 사용할 수 있습니다.
SvgDecoder에 커스텀 밀도 배율을 제공할 수 있도록 density 인자를 추가했습니다.
Uri를 복사하고 수정할 수 있도록 Uri.Builder를 추가했습니다.
테스트에서 Coil의 Dispatchers.main.immediate 사용을 재정의할 수 있도록 ImageLoader.Builder.mainCoroutineContext를 추가했습니다.
애니메이션 종료 시 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.Loading 대신 AsyncImagePainter.State.Success를 반환하도록 변경했습니다.
ConstraintsSizeResolver#size()에서의 취소 처리를 수정했습니다.
R8으로 빌드할 때 PlatformContext 누락에 대한 경고를 수정했습니다.
기본 FakeImageLoaderEngine 응답이 반환될 때 FakeImageLoaderEngine이 Transition.Factory.NONE을 설정하지 않던 문제를 수정했습니다.
ColorImage에서 실험적(experimental) 어노테이션을 제거했습니다.
CacheControlCacheStrategy에서 네트워크 헤더를 지연 분석(lazy parse)하도록 변경했습니다.
공통 코드를 공유하도록 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> 형식의 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으로 전환했습니다.
모든 멀티플랫폼 타겟에서 Transformation을 지원합니다.
CacheControlCacheStrategy에서 Expires 헤더 값으로 0을 지원합니다.
ContentScale이 None으로 또는 None으로부터 변경될 때 AsyncImage/SubcomposeAsyncImage/rememberAsyncImage가 새로운 ImageRequest를 시작하지 않던 문제를 수정했습니다.
Kotlin을 2.1.10으로 업데이트했습니다.
- 주의: Kotlin 네이티브를 사용하는 경우 LLVM 업데이트(11.1.0에서 16.0.0으로)로 인해 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가 캐시 엔트리의 수명(age)을 잘못 계산하던 문제를 수정했습니다.
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을 완벽하게 지원하는 다음 메이저 릴리스입니다.

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가 가용 제약 조건(constraints)을 가득 채우던 문제를 수정했습니다.
EqualityDelegate가 무시되어 상태가 관찰될 때 rememberAsyncImagePainter가 무한히 재구성(recompose)되던 문제를 수정했습니다.
특수 문자가 포함된 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를 기본적으로 비활성화하고 요청별로 설정할 수 있게 변경했습니다. 이전 동작은 동일한 플래그로 다시 활성화할 수 있습니다.
신규: Cache-Control 헤더 지원을 구현하는 새로운 coil-network-cache-control 아티팩트를 도입했습니다.
신규: SvgDecoder.Factory에 scaleToDensity 속성을 추가했습니다. 이 속성은 고유 치수를 가진 SVG가 기기 밀도에 곱해지도록 보장합니다(Android에서만 지원).
ExifOrientationPolicy를 ExifOrientationStrategy로 이름을 변경했습니다.
MemoryCache에서 가져올(get) 때 공유할 수 없는 이미지를 제거합니다.
ConstraintsSizeResolver를 public으로 전환했습니다.
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일

파괴적 변경: 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로 매우 큰 이미지를 로드하여 메모리 캐시 부족 예외(OOM)가 발생하는 것을 방지하는 데 도움이 됩니다.
커스텀 정책 지원을 위해 ExifOrientationPolicy를 인터페이스로 변환했습니다.
Windows 파일 경로의 Uri 처리를 수정했습니다.
Image API에서 @ExperimentalCoilApi를 제거했습니다.
Kotlin을 2.0.10으로 업데이트했습니다.

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

파괴적 변경: Ktor 2.x에 의존하는 io.coil-kt.coil3:coil-network-ktor 아티팩트의 이름을 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일

파괴적 변경: 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로 설정하세요.
파괴적 변경: 멀티플랫폼 Image API를 리팩토링했습니다. 특히 asCoilImage가 asImage로 이름이 변경되었습니다.
파괴적 변경: AsyncImagePainter.state가 StateFlow<AsyncImagePainter.State>로 변경되었습니다. 값을 관찰하려면 collectAsState를 사용하세요. 이는 성능을 향상시킵니다.
파괴적 변경: AsyncImagePainter.imageLoader 및 AsyncImagePainter.request가 StateFlow<AsyncImagePainter.Inputs>로 결합되었습니다. 값을 관찰하려면 collectAsState를 사용하세요. 이는 성능을 향상시킵니다.
파괴적 변경: 리소스 축소(shrinking) 최적화를 방해하므로 android.resource://example.package.name/drawable/image 형식의 URI 지원을 제거했습니다.
- 이 기능이 여전히 필요한 경우 컴포넌트 레지스트리에 ResourceUriMapper를 수동으로 포함할 수 있습니다.
신규: 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을 생성하지 않습니다 (thanks @mlykotom!). (#2205)
전역 ImageLoader extras를 Options에 전달하도록 수정했습니다. (#2223)
Android 이외의 타겟에서 crossfade(false)가 작동하지 않던 문제를 수정했습니다.
VP8X 피처 플래그 바이트 오프셋을 수정했습니다 (#2199).
Android 이외의 타겟에서 SvgDecoder가 드로우(draw) 타임에 이미지를 렌더링하는 대신 비트맵으로 렌더링하도록 변환했습니다. 이는 성능을 향상시킵니다.
- 이 동작은 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 타겟을 지원합니다.
Android 이외의 플랫폼에서 비트맵 기반이 아닌 Image를 그릴 수 있도록 DrawablePainter 및 DrawableImage를 생성했습니다.
- Image API는 실험적이며 알파 릴리스 사이에서 변경될 수 있습니다.
Modifier.Node를 구현하도록 ContentPainterModifier를 업데이트했습니다.
수정: 컴포넌트 콜백 및 네트워크 옵저버를 백그라운드 스레드에서 지연 등록합니다. 이는 일반적으로 메인 스레드에서 발생하던 느린 초기화 문제를 해결합니다.
수정: ImageLoader.Builder.placeholder/error/fallback이 사용되지 않던 문제를 수정했습니다.
업데이트 Compose to 1.6.0.
업데이트 Coroutines to 1.8.0.
업데이트 Okio to 3.8.0.
업데이트 Skiko to 0.7.94.
3.x의 중요 변경 사항 전체 목록은 업그레이드 가이드를 확인하세요.

[2.6.0] - 2024년 2월 23일

rememberAsyncImagePainter, AsyncImage, SubcomposeAsyncImage를 재시작 가능(restartable) 및 건너뛰기 가능(skippable)하도록 만들었습니다. 이는 컴포저블의 인자 중 하나가 변경되지 않는 한 재구성을 피함으로써 성능을 향상시킵니다.
- model이 재구성을 트리거할지 여부를 제어하기 위해 rememberAsyncImagePainter, AsyncImage, SubcomposeAsyncImage에 선택적 modelEqualityDelegate 인자를 추가했습니다.
Modifier.Node를 구현하도록 ContentPainterModifier를 업데이트했습니다.
수정: 컴포넌트 콜백 및 네트워크 옵저버를 백그라운드 스레드에서 지연 등록합니다. 이는 일반적으로 메인 스레드에서 발생하던 느린 초기화 문제를 해결합니다.
수정: 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일

파괴적 변경: OkHttpNetworkFetcherFactory 및 KtorNetworkFetcherFactory의 공개 API에서 Lazy를 제거했습니다.
OkHttpNetworkFetcherFactory에서 OkHttpClient 대신 Call.Factory를 노출합니다.
ByteString을 래핑하도록 NetworkResponseBody를 변환했습니다.
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과 달리 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로 업데이트되었으며 임포트 경로가 coil3로 업데이트되었습니다. 이를 통해 Coil 3은 바이너리 호환성 문제 없이 Coil 2와 공존할 수 있습니다. 예를 들어, io.coil-kt:coil:[version]은 이제 io.coil-kt.coil3:coil:[version]이 됩니다.
coil-base 및 coil-compose-base 아티팩트가 Coroutines, Ktor, AndroidX에서 사용하는 명명 규칙에 맞춰 각각 coil-core 및 coil-compose-core로 이름이 변경되었습니다.
중요 변경 사항 전체 목록은 업그레이드 가이드를 확인하세요.

[2.5.0] - 2023년 10월 30일

신규: coil-video에서 MediaDataSource 구현체의 디코딩을 지원하기 위해 MediaDataSourceFetcher.Factory를 추가했습니다. (#1795)
하드웨어 비트맵 차단 목록에 SHIFT6m 기기를 추가했습니다. (#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로 자동으로 변환하지 않도록 변경했습니다.
단순한 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 기본 메서드(default method) 생성을 활성화했습니다. #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
에셋 하위 폴더 내의 비디오 디코딩 문제를 수정했습니다. #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은 라이브러리의 주요 이터레이션이며 파괴적 변경사항을 포함하고 있습니다. 업그레이드 방법은 업그레이드 가이드를 확인하세요.

신규: 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)
)

신규: 공개 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입니다.
- 이는 ImageRequest.scale을 기본 Scale을 갖는 다른 클래스들과 일관되게 맞추기 위한 변경입니다.
- ImageViewTarget을 사용하는 요청은 여전히 Scale이 자동 감지됩니다.
이미지 파이프라인 클래스 리팩토링:
- Mapper, Fetcher, Decoder가 더 유연하게 리팩토링되었습니다.
- Fetcher.key가 새로운 Keyer 인터페이스로 교체되었습니다. Keyer는 입력 데이터로부터 캐시 키를 생성합니다.
- Decoder가 Okio의 파일 시스템 API를 사용하여 File을 직접 읽을 수 있게 해주는 ImageSource를 추가했습니다.
Jetpack Compose 통합 리팩토링:
- rememberImagePainter 및 ImagePainter가 각각 rememberAsyncImagePainter 및 AsyncImagePainter로 이름이 변경되었습니다.
- LocalImageLoader를 지원 중단했습니다. 자세한 내용은 지원 중단 메시지를 확인하세요.
런타임 Not-null 단언(assertion) 생성을 비활성화했습니다.
- Java를 사용하는 경우, Not-null 어노테이션이 달린 인자에 null을 전달해도 더 이상 NullPointerException이 즉시 발생하지 않습니다. Kotlin의 컴파일 타임 null 안정성이 이를 방지합니다.
- 이 변경을 통해 라이브러리 크기를 줄일 수 있습니다.
Size가 이제 너비와 높이를 위한 두 개의 Dimension 값으로 구성됩니다. Dimension은 양수 픽셀 값 또는 Dimension.Undefined가 될 수 있습니다. 자세한 내용은 여기를 참조하세요.
BitmapPool 및 PoolableViewTarget이 라이브러리에서 제거되었습니다.
VideoFrameFileFetcher 및 VideoFrameUriFetcher가 라이브러리에서 제거되었습니다. 대신 모든 데이터 소스를 지원하는 VideoFrameDecoder를 사용하세요.
BlurTransformation 및 GrayscaleTransformation이 라이브러리에서 제거되었습니다. 사용 중이라면 해당 코드를 프로젝트로 복사하여 사용할 수 있습니다.
트랜지션이 완료될 때까지 일시 중단(suspend)할 필요가 없어짐에 따라 Transition.transition을 비일시 중단 함수로 변경했습니다.
진행 중인 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 빌더 인자를 마지막이 아닌 처음에 적용하도록 수정했습니다.
응답이 수정되지 않은 경우 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가 실험적(experimental)으로 표시되던 문제를 수정했습니다. 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 및 기타 캐시 헤더는 여전히 지원됩니다 - 단, 캐시는 URL 일치 여부만 확인하므로 Vary 헤더는 제외됩니다. 또한 응답 코드가 [200..300) 범위에 있는 응답만 캐시됩니다.
- 2.0으로 업그레이드할 때 기존 디스크 캐시는 삭제됩니다.
ImageRequest의 기본 Scale이 이제 Scale.FIT입니다.
- 이는 ImageRequest.scale을 기본 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의 컴파일 타임 null 안정성이 이를 방지합니다.
- 이 변경을 통해 라이브러리 크기를 줄일 수 있습니다.
Size가 이제 너비와 높이를 위한 두 개의 Dimension 값으로 구성됩니다. Dimension은 양수 픽셀 값 또는 Dimension.Original이 될 수 있습니다.
BitmapPool 및 PoolableViewTarget이 라이브러리에서 제거되었습니다.
VideoFrameFileFetcher 및 VideoFrameUriFetcher가 라이브러리에서 제거되었습니다. 대신 모든 데이터 소스를 지원하는 VideoFrameDecoder를 사용하세요.
BlurTransformation 및 GrayscaleTransformation이 라이브러리에서 제거되었습니다. 사용 중이라면 해당 코드를 프로젝트로 복사하여 사용할 수 있습니다.
트랜지션이 완료될 때까지 일시 중단할 필요가 없어짐에 따라 Transition.transition을 비일시 중단 함수로 변경했습니다.
진행 중인 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을 지연 해결(lazy resolve)할 수 있도록 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일

DiskCache 및 ImageSource가 Okio의 FileSystem API를 사용하도록 업데이트했습니다. (#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는 서브컴포지션을 사용하지 않으며 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 context 인자를 제거했습니다. (#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이 될 수 있습니다.
- 이 변경은 한쪽 치수가 고정 픽셀 값일 때 제한되지 않은 너비/높이 값(예: wrap_content, Constraints.Infinity)을 더 잘 지원하기 위해 이루어졌습니다.
수정: AsyncImage에 대한 검사 모드(preview)를 지원합니다.
수정: imageLoader.memoryCache가 null인 경우 SuccessResult.memoryCacheKey는 항상 null이어야 합니다.
ImageLoader, SizeResolver, ViewSizeResolver의 생성자 형태의 invoke 함수를 최상위 함수로 변환했습니다.
CrossfadeDrawable의 시작 및 종료 드로어블을 공개 API로 만들었습니다.
ImageLoader의 플레이스홀더/에러/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, // 가급적 localized string으로 설정하세요.
)

// 서클 크롭, 크로스페이드와 함께 이미지를 그리고 `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 미리보기를 수정했습니다.
더 효율적인 코드를 생성하기 위해 LocalAsyncImageLoader.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일

빌 오브 머티리얼(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를 사용하세요.
- 쓰기 중에 중단되면 손상될 수 있으므로 OkHttp의 Cache를 Coil 2.0과 함께 사용해서는 안 됩니다.
- 캐시가 URL 일치만 확인하므로 Vary 헤더를 제외한 Cache-Control 및 기타 캐시 헤더는 여전히 지원됩니다. 또한 응답 코드가 [200..300) 범위인 응답만 캐시됩니다.
- 캐시 헤더 준수 여부는 ImageLoader.Builder.respectCacheHeaders를 사용하여 활성화하거나 비활성화할 수 있습니다.
- 2.0으로 업그레이드하면 기존 디스크 캐시는 삭제되고 다시 생성됩니다.
중요: ImageRequest의 기본 Scale이 이제 Scale.FIT입니다.
- 이는 ImageRequest.scale을 기본 Scale을 갖는 다른 클래스들과 일관되게 맞추기 위한 변경입니다.
- ImageViewTarget을 사용하는 요청은 여전히 스케일이 자동 감지됩니다.
이미지 파이프라인 클래스의 대대적인 변경:
- Mapper, Fetcher, Decoder가 더 유연하게 리팩토링되었습니다.
- Fetcher.key가 새로운 Keyer 인터페이스로 교체되었습니다. Keyer는 입력 데이터로부터 캐시 키를 생성합니다.
- Decoder가 File을 직접 디코딩할 수 있게 해주는 ImageSource를 추가했습니다.
BitmapPool 및 PoolableViewTarget이 라이브러리에서 제거되었습니다. 비트맵 풀링이 제거된 이유는 다음과 같습니다:
- API 23 이하에서 가장 효과적이며 최신 Android 릴리스에서는 효과가 떨어졌습니다.
- 비트맵 풀링을 제거함으로써 Coil은 성능상 이점이 있는 불변(immutable) 비트맵을 사용할 수 있게 되었습니다.
- 비트맵 풀을 관리하는 데 따른 런타임 오버헤드가 존재합니다.
- 비트맵 풀링은 비트맵이 풀링 가능한지 추적해야 하므로 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을 비일시 중단 함수로 변경했습니다.
공통 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 메서드들을 public으로 전환했습니다. (#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에서 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일

코루틴을 두 번 이상 재개(resume)하여 ViewSizeResolver.size에서 IllegalStateException이 발생할 수 있던 문제를 수정했습니다.
HttpFetcher가 메인 스레드에서 호출될 때 영구적으로 차단(blocking)되던 문제를 수정했습니다.
- 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일

중요: CENTER 및 MATRIX ImageView 스케일 타입을 OriginalSize로 해결되도록 변경했습니다. (#587)
- 이 변경은 요청의 크기가 명시적으로 지정되지 않았을 때의 암시적 크기 해결 알고리즘에만 영향을 미칩니다.
- 이 변경은 이미지 요청의 시각적 결과가 ImageView.setImageResource/ImageView.setImageURI와 일치하도록 하기 위해 이루어졌습니다. 이전 동작으로 되돌리려면 요청을 생성할 때 ViewSizeResolver를 설정하세요.
중요: 뷰의 레이아웃 파라미터가 WRAP_CONTENT인 경우 ViewSizeResolver에서 디스플레이 크기를 반환하도록 변경했습니다. (#562)
- 이전에는 뷰가 완전히 레이아웃되었을 때만 디스플레이 크기를 반환했습니다. 이 변경으로 일반적인 동작이 더 일관되고 직관적으로 변했습니다.
알파 프리멀티플리케이션(alpha pre-multiplication)을 제어하는 기능을 추가했습니다. (#569)
CrossfadeDrawable에서 정확한 고유 크기(intrinsic size)를 선호하는 옵션을 지원합니다. (#585)
버전을 포함한 전체 GIF 헤더를 확인합니다. (#564)
빈 비트맵 풀(empty bitmap pool) 구현을 추가했습니다. (#561)
EventListener.Factory를 함수형 인터페이스로 만들었습니다. (#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)
교체된 경우 이전의 싱글톤 이미지 로더를 종료하지 않도록 수정했습니다. (#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일

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

중요: (메인 스레드에서 호출된 경우에도) 메모리 캐시의 값이 더 이상 동기적으로 해결되지 않습니다.
- 이 변경은 백그라운드 디스패처에서 Interceptor를 실행하기 위해 필요했습니다.
- 또한 더 많은 작업을 메인 스레드 밖으로 이동시켜 성능을 향상시킵니다.
중요: Mappers가 이제 백그라운드 디스패처에서 실행됩니다. 부수 효과로, 자동 비트맵 샘플링이 더 이상 자동으로 지원되지 않습니다. 동일한 효과를 얻으려면 이전 요청의 MemoryCache.Key를 이후 요청의 placeholderMemoryCacheKey로 사용하세요. 예시는 여기를 참조하세요.
- placeholderMemoryCacheKey API는 데이터가 다른 두 이미지 요청(예: 작거나 큰 이미지에 대한 다른 URL)을 "연결"할 수 있어 더 많은 자유를 제공합니다.
중요: Coil의 ImageView 확장 함수들이 coil.api 패키지에서 coil 패키지로 이동되었습니다.
- import coil.api.load -> import coil.load로 리팩토링하기 위해 찾기 및 바꾸기를 사용하세요. 아쉽게도 Kotlin의 ReplaceWith 기능으로는 임포트 교체가 불가능합니다.
중요: 드로어블이 동일한 이미지가 아닌 경우 표준 크로스페이드를 사용합니다.
중요: API 24+에서 불변 비트맵을 선호합니다.
중요: 새로운 Interceptor 인터페이스를 선호하여 MeasuredMapper가 지원 중단되었습니다. MeasuredMapper를 Interceptor로 변환하는 예시는 여기를 참조하세요.
- Interceptor는 훨씬 덜 제한적인 API로 더 넓은 범위의 커스텀 로직을 가능하게 합니다.
중요: ImageRequest.data는 이제 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일

파괴적 변경: 이 버전은 기존에 지원 중단된 모든 함수를 제거합니다.
- 이를 통해 Coil의 ContentProvider를 제거하여 앱 시작 시 어떤 코드도 실행하지 않도록 합니다.
파괴적 변경: SparseIntArraySet.size를 val로 변환했습니다. (#380)
파괴적 변경: Parameters.count()를 확장 함수로 이동했습니다. (#403)
파괴적 변경: BitmapPool.maxSize를 Int로 만들었습니다. (#404)

중요: ImageLoader.shutdown()을 (OkHttpClient와 유사하게) 선택 사항으로 만들었습니다. (#385)

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

기본 메모리 캐시 크기를 20%로 줄했습니다. (#390)
- 기존 동작을 유지하려면 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의 메모리 캐시에서 반환됩니다.
- 일반적으로 이는 메모리 캐시를 훨씬 더 예측 가능하게 만들고 히트율(hit rate)을 높여줍니다.
- 이 동작은 ImageLoaderBuilder.trackWeakReferences를 통해 활성화/비활성화할 수 있습니다.
비디오 파일의 특정 프레임을 디코딩하기 위한 새로운 아티팩트인 io.coil-kt:coil-video를 추가했습니다. 자세한 내용은 여기를 참조하세요.
지표(metrics) 추적을 위한 새로운 EventListener API를 추가했습니다.
싱글톤 초기화를 간소화하기 위해 Application에서 구현할 수 있는 ImageLoaderFactory를 추가했습니다.

전체 릴리스 노트

중요: 빌더 구문을 위해 DSL 구문을 지원 중단했습니다. (#267)
중요: Coil 및 ImageLoader 확장 함수들을 지원 중단했습니다. (#322)
파괴적 변경: ImageLoader.execute(GetRequest)에서 sealed 클래스인 RequestResult 타입을 반환합니다. (#349)
파괴적 변경: ExperimentalCoil을 ExperimentalCoilApi로 이름을 변경했습니다. @Experimental에서 @RequiresOptIn으로 마이그레이션했습니다. (#306)
파괴적 변경: CoilLogger를 Logger 인터페이스로 교체했습니다. (#316)
파괴적 변경: destWidth/destHeight를 dstWidth/dstHeight로 이름을 변경했습니다. (#275)
파괴적 변경: MovieDrawable 생성자 파라미터 순서를 조정했습니다. (#272)
파괴적 변경: Request.Listener의 메서드들이 이제 데이터뿐만 아니라 전체 Request 객체를 수신합니다.
파괴적 변경: GetRequestBuilder 생성 시 Context가 필요합니다.
파괴적 변경: 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)
수정: 높은 색 심도(color 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에서 다운샘플링 시 가로세로 비율을 준수하도록 수정했습니다. Thanks @zhanghai.

이전에는 비트맵의 설정이 요청된 설정보다 크거나 같은 경우 메모리 캐시에서 반환되었습니다. 예를 들어, ARGB_8888 비트맵을 요청했을 때 메모리 캐시에 있는 RGBA_F16 비트맵을 반환받을 수 있었습니다. 이제는 캐시된 설정과 요청된 설정이 반드시 일치해야 합니다.
CrossfadeDrawable 및 CrossfadeTransition에서 scale 및 durationMillis를 public으로 전환했습니다.

[0.9.3] - 2020년 2월 1일

수정: ScaleDrawable 내부의 자식 드로어블을 중앙에 배치하도록 평행 이동시킵니다.
수정: 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 디코딩을 수정했습니다. Thanks @mario.
수정: 래스터화된 벡터 드로어블이 샘플링된 것으로 표시되지 않던 문제를 수정했습니다.
수정: Movie 치수가 0 이하인 경우 예외를 발생시킵니다.
수정: 메모리 캐시 이벤트에 대해 CrossfadeTransition이 재개되지 않던 문제를 수정했습니다.
수정: 허용되지 않은 경우 모든 타겟 메서드에 하드웨어 비트맵을 반환하지 않도록 방어 로직을 추가했습니다.
수정: MovieDrawable이 바운드의 중앙에 배치되지 않던 문제를 수정했습니다.

CrossfadeDrawable에서 자동 스케일링을 제거했습니다.
BitmapPool.trimMemory를 public으로 전환했습니다.
AnimatedImageDrawable이 바운드를 가득 채우도록 ScaleDrawable로 래핑했습니다.
RequestBuilder.setParameter에 @JvmOverloads를 추가했습니다.
SVG의 뷰 박스가 설정되지 않은 경우 크기에 맞춰 설정합니다.
상태 및 레벨 변경 사항을 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을 적용하기 전에 Drawable을 Bitmap으로 렌더링합니다.
파괴적 변경: ImageLoader.load에 null 데이터를 전달하면 이제 에러로 처리되며, NullRequestDataException과 함께 Target.onError 및 Request.Listener.onError를 호출합니다. 이 변경은 데이터가 null일 때 fallback 드로어블을 설정할 수 있도록 하기 위해 이루어졌습니다. 이전에는 요청이 자동으로 무시되었습니다.
파괴적 변경: RequestDisposable.isDisposed가 val로 변경되었습니다.

신규: 커스텀 트랜지션을 지원합니다. 자세한 정보는 여기를 참조하세요. 트랜지션 API는 초기 단계이므로 실험적으로 마킹되어 있습니다.
신규: LoadRequest가 진행되는 동안 일시 중단할 수 있도록 RequestDisposable.await를 추가했습니다.
신규: 요청 데이터가 null일 때 fallback 드로어블을 설정하는 기능을 지원합니다.
신규: Precision을 추가했습니다. 이는 출력 Drawable의 크기를 정확하게 만들면서 스케일링을 지원하는 타겟(예: ImageViewTarget)에 대해 스케일링 최적화를 가능하게 합니다. 자세한 내용은 문서를 참조하세요.
신규: 여러 캐시 키 매칭을 지원하기 위해 RequestBuilder.aliasKeys를 추가했습니다.

수정: RequestDisposable을 스레드 안전하게 수정했습니다.
수정: RoundedCornersTransformation이 이제 타겟의 크기에 맞춰 자른 후 모서리를 둥글게 처리합니다.
수정: CircleCropTransformation이 이제 중앙에서 자릅니다.
수정: 하드웨어 비트맵 블랙리스트에 여러 기기를 추가했습니다.
수정: 드로어블을 비트맵으로 변환할 때 가로세로 비율을 유지합니다.
수정: 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일

파괴적 변경: SvgDrawable이 제거되었습니다. 대신 이제 SvgDecoder에 의해 SVG가 BitmapDrawable로 사전 렌더링됩니다. 이는 메인 스레드에서의 SVG 렌더링 비용을 현저히 낮춰줍니다. 또한 SvgDecoder 생성 시 Context가 필요합니다.
파괴적 변경: SparseIntArraySet 확장 함수들이 coil.extension 패키지로 이동되었습니다.

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

수정: CoilContentProvider를 테스트에서 볼 수 있도록 수정했습니다.
수정: 리소스 캐시 키에 야간 모드(night mode)를 포함합니다.
수정: 소스를 디스크에 일시적으로 기록함으로써 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일

파괴적 변경: 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()
    }
}

파괴적 변경: Fetcher.key가 더 이상 기본 구현을 가지지 않습니다.
파괴적 변경: 이전에는 적용 가능한 첫 번째 Mapper만 호출되었습니다. 이제는 적용 가능한 모든 Mapper가 호출됩니다. API 변경은 없습니다.
파괴적 변경: 소소한 명명 변경: url -> uri, factory -> initializer.

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

수정: 벡터 드로어블 로딩과 관련된 여러 버그를 수정했습니다.
수정: WRAP_CONTENT 뷰 치수를 지원합니다.
수정: 8192바이트보다 긴 EXIF 데이터 파싱을 지원합니다.
수정: 크로스페이드 시 가로세로 비율이 다른 드로어블이 늘어나지 않도록 수정했습니다.
수정: 예외로 인해 네트워크 옵저버 등록이 실패하는 경우에 대한 방어 로직을 추가했습니다.
수정: MovieDrawable의 0으로 나누기 오류를 수정했습니다. Thanks @R12rus.
수정: 중첩된 Android 에셋 파일을 지원합니다. Thanks @JaCzekanski.
수정: Android O 및 O_MR1에서 파일 디스크립터가 고갈되는 현상에 대한 방어 로직을 추가했습니다.
수정: 메모리 캐시를 비활성화했을 때 크래시가 발생하지 않도록 수정했습니다. Thanks @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
appcompat을 선택적 compileOnly 의존성인 훨씬 작은 아티팩트 appcompat-resources로 교체했습니다.

[0.6.1] - 2019년 8월 16일

신규: RequestBuilder에 transformations(List<Transformation>)를 추가했습니다.
수정: 파일 URI에 대해 캐시 키에 최종 수정 날짜를 추가했습니다.
수정: 뷰 치수가 최소 1px로 계산되도록 보장합니다.
수정: 프레임 사이에 MovieDrawable의 캔버스를 비우도록 수정했습니다.
수정: 에셋을 올바르게 열도록 수정했습니다.

[0.6.0] - 2019년 8월 12일

최초 릴리스.

변경 로그 ​

[3.5.0-beta01] - 2026년 5월 4일 ​

[3.4.0] - 2026년 2월 24일 ​

[3.3.0] - 2025년 7월 22일 ​

[3.2.0] - 2025년 5월 13일 ​

[3.2.0-rc02] - 2025년 4월 26일 ​

[3.2.0-rc01] - 2025년 4월 24일 ​

[3.1.0] - 2025년 2월 4일 ​

[3.0.4] - 2024년 11월 25일 ​

[3.0.3] - 2024년 11월 14일 ​

[3.0.2] - 2024년 11월 9일 ​

[3.0.1] - 2024년 11월 7일 ​

[3.0.0] - 2024년 11월 4일 ​

[3.0.0-rc02] - 2024년 10월 28일 ​

[3.0.0-rc01] - 2024년 10월 8일 ​

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

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

[2.7.0] - 2024년 7월 17일 ​

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

[3.0.0-alpha07] - 2024년 6월 26일 ​

[3.0.0-alpha06] - 2024년 2월 29일 ​

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

[2.6.0] - 2024년 2월 23일 ​

[3.0.0-alpha04] - 2024년 2월 1일 ​

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

[3.0.0-alpha02] - 2024년 1월 10일 ​

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

[2.5.0] - 2023년 10월 30일 ​

[2.4.0] - 2023년 5월 21일 ​

[2.3.0] - 2023년 3월 25일 ​

[2.2.2] - 2022년 10월 1일 ​

[2.2.1] - 2022년 9월 8일 ​

[2.2.0] - 2022년 8월 16일 ​

[2.1.0] - 2022년 5월 17일 ​

[2.0.0] - 2022년 5월 10일 ​

[2.0.0-rc03] - 2022년 4월 11일 ​

[2.0.0-rc02] - 2022년 3월 20일 ​

[2.0.0-rc01] - 2022년 3월 2일 ​

[2.0.0-alpha09] - 2022년 2월 16일 ​

[2.0.0-alpha08] - 2022년 2월 7일 ​

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

[2.0.0-alpha06] - 2021년 12월 24일 ​

[2.0.0-alpha05] - 2021년 11월 28일 ​

[2.0.0-alpha04] - 2021년 11월 22일 ​

[2.0.0-alpha03] - 2021년 11월 12일 ​

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

[2.0.0-alpha01] - 2021년 10월 11일 ​

[1.4.0] - 2021년 10월 6일 ​

[1.3.2] - 2021년 8월 4일 ​

[1.3.1] - 2021년 7월 28일 ​

[1.3.0] - 2021년 7월 10일 ​

[1.2.2] - 2021년 6월 4일 ​

[1.2.1] - 2021년 4월 27일 ​

[1.2.0] - 2021년 4월 12일 ​

[1.1.1] - 2021년 1월 11일 ​

[1.1.0] - 2020년 11월 24일 ​

[1.0.0] - 2020년 10월 22일 ​

[1.0.0-rc3] - 2020년 9월 21일 ​

[1.0.0-rc2] - 2020년 9월 3일 ​

[0.13.0] - 2020년 9월 3일 ​

[1.0.0-rc1] - 2020년 8월 18일 ​

[0.12.0] - 2020년 8월 18일 ​

[0.11.0] - 2020년 5월 14일 ​

[0.10.1] - 2020년 4월 26일 ​

[0.10.0] - 2020년 4월 20일 ​

주요 사항 ​

전체 릴리스 노트 ​

[0.9.5] - 2020년 2월 6일 ​

[0.9.4] - 2020년 2월 3일 ​

[0.9.3] - 2020년 2월 1일 ​

[0.9.2] - 2020년 1월 19일 ​

[0.9.1] - 2019년 12월 30일 ​

[0.9.0] - 2019년 12월 30일 ​

[0.8.0] - 2019년 10월 22일 ​

[0.7.0] - 2019년 9월 8일 ​

[0.6.1] - 2019년 8월 16일 ​

[0.6.0] - 2019년 8월 12일 ​

변경 로그

[3.5.0-beta01] - 2026년 5월 4일

[3.4.0] - 2026년 2월 24일

[3.3.0] - 2025년 7월 22일

[3.2.0] - 2025년 5월 13일

[3.2.0-rc02] - 2025년 4월 26일

[3.2.0-rc01] - 2025년 4월 24일

[3.1.0] - 2025년 2월 4일

[3.0.4] - 2024년 11월 25일

[3.0.3] - 2024년 11월 14일

[3.0.2] - 2024년 11월 9일

[3.0.1] - 2024년 11월 7일

[3.0.0] - 2024년 11월 4일

[3.0.0-rc02] - 2024년 10월 28일

[3.0.0-rc01] - 2024년 10월 8일

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

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

[2.7.0] - 2024년 7월 17일

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

[3.0.0-alpha07] - 2024년 6월 26일

[3.0.0-alpha06] - 2024년 2월 29일

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

[2.6.0] - 2024년 2월 23일

[3.0.0-alpha04] - 2024년 2월 1일

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

[3.0.0-alpha02] - 2024년 1월 10일

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

[2.5.0] - 2023년 10월 30일

[2.4.0] - 2023년 5월 21일

[2.3.0] - 2023년 3월 25일

[2.2.2] - 2022년 10월 1일

[2.2.1] - 2022년 9월 8일

[2.2.0] - 2022년 8월 16일

[2.1.0] - 2022년 5월 17일

[2.0.0] - 2022년 5월 10일

[2.0.0-rc03] - 2022년 4월 11일

[2.0.0-rc02] - 2022년 3월 20일

[2.0.0-rc01] - 2022년 3월 2일

[2.0.0-alpha09] - 2022년 2월 16일

[2.0.0-alpha08] - 2022년 2월 7일

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

[2.0.0-alpha06] - 2021년 12월 24일

[2.0.0-alpha05] - 2021년 11월 28일

[2.0.0-alpha04] - 2021년 11월 22일

[2.0.0-alpha03] - 2021년 11월 12일

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

[2.0.0-alpha01] - 2021년 10월 11일

[1.4.0] - 2021년 10월 6일

[1.3.2] - 2021년 8월 4일

[1.3.1] - 2021년 7월 28일

[1.3.0] - 2021년 7월 10일

[1.2.2] - 2021년 6월 4일

[1.2.1] - 2021년 4월 27일

[1.2.0] - 2021년 4월 12일

[1.1.1] - 2021년 1월 11일

[1.1.0] - 2020년 11월 24일

[1.0.0] - 2020년 10월 22일

[1.0.0-rc3] - 2020년 9월 21일

[1.0.0-rc2] - 2020년 9월 3일

[0.13.0] - 2020년 9월 3일

[1.0.0-rc1] - 2020년 8월 18일

[0.12.0] - 2020년 8월 18일

[0.11.0] - 2020년 5월 14일

[0.10.1] - 2020년 4월 26일

[0.10.0] - 2020년 4월 20일

주요 사항

전체 릴리스 노트

[0.9.5] - 2020년 2월 6일

[0.9.4] - 2020년 2월 3일

[0.9.3] - 2020년 2월 1일

[0.9.2] - 2020년 1월 19일

[0.9.1] - 2019년 12월 30일

[0.9.0] - 2019년 12월 30일

[0.8.0] - 2019년 10월 22일

[0.7.0] - 2019년 9월 8일

[0.6.1] - 2019년 8월 16일

[0.6.0] - 2019년 8월 12일