v3.3.0

Compare Source

• New: Introduce a new API to limit MemoryCache.maxSize on Android while the app is backgrounded.
  • If ImageLoader.Builder.memoryCacheMaxSizePercentWhileInBackground is set, the ImageLoader's memory cache will be limited to a percent of its max size while the app is backgrounded. This setting is currently disabled by default.
  • Images will be trimmed from the memory cache to reach the limited max size when the app is backgrounded, however the memory cache's weak references to recently trimmed images are unaffected. This means if an image is currently referenced elsewhere (e.g. AsyncImage, ImageView, etc.) it will still be present in the memory cache.
  • This API is useful to reduce background memory usage, keep your app from being killed earlier, and help reduce memory pressure on your users' devices.
• New: Add an Svg.Parser argument to SvgDecoder.
  • This enables using custom SVG parsers if the default SVG parser doesn't meet your needs.
• Add a density argument to SvgDecoder to support providing a custom density multiplier.
• Add Uri.Builder to support copying and modifying Uris.
• Add ImageLoader.Builder.mainCoroutineContext to support overriding Coil's Dispatchers.main.immediate usage in tests.
• Fix CrossfadePainter.intrinsicSize changing when the start image is dereferenced at the end of the animation. This aligns with the behaviour of CrossfadeDrawable.
• Fix ImageLoaders.executeBlocking being inaccessible from Java.
• Use kotlinx.io's Okio interop module in coil-network-ktor3.
• Update kotlinx-datetime to 0.7.1.
  • This release includes binary incompatible changes that only affect the coil-network-cache-control module. See here for more info.
• Update Kotlin to 2.2.0.
• Update Compose to 1.8.2.
• Update Okio to 3.15.0.
• Update Skiko to 0.9.4.2.

v3.2.0

Compare Source

Changes since 3.1.0:

• Important: coil-compose and coil-compose-core now require Java 11 bytecode due to Compose 1.8.0 requiring it. See here for how to enable it.
• Change AsyncImagePreviewHandler's functional constructor to return AsyncImagePainter.State.Success instead of AsyncImagePainter.State.Loading.
• Fix cancellation in ConstraintsSizeResolver#size().
• Fix warning for missing PlatformContext when building with R8.
• Fix FakeImageLoaderEngine not setting Transition.Factory.NONE when the default FakeImageLoaderEngine response is returned.
• Remove experimental annotation from ColorImage.
• Parse network headers lazily in CacheControlCacheStrategy.
• Refactor CircleCropTransformation and RoundedCornersTransformation to share common code.
• Fall back to using BitmapFactory internally if ExifOrientationStrategy is not RESPECT_PERFORMANCE.
• Update Kotlin to 2.1.20.
• Update Compose to 1.8.0.
• Update Okio to 3.11.0.
• Update Skiko to 0.9.4.
• Update Coroutines to 1.10.2.
• Update accompanist-drawablepainter to 0.37.3.

Changes since 3.2.0-rc02:

• Fall back to using BitmapFactory internally if ExifOrientationStrategy is not RESPECT_PERFORMANCE.
• Update Compose to 1.8.0.
• Update accompanist-drawablepainter to 0.37.3.

v3.1.0

Compare Source

• Improve AsyncImage performance.
  • Runtime performance is improved by 25% to 40% depending on if the composable is being instantiated or reused. Allocations are also reduced by 35% to 48%. More info here.
• Add ColorImage and deprecate FakeImage.
  • ColorImage is useful for returning a fake value in tests and previews. It solves the same use case as FakeImage, but is more easily accessible in coil-core instead of coil-test.
• Remove coil-compose-core's dependency on Dispatchers.Main.immedate.
  • This also fixes a case where AsyncImagePainter would not execute ImageRequests synchronously in Paparazzi and Roborazzi screenshot tests.
• Add support for data URIs with the format: data:[<mediatype>][;base64],<data>
• Add AnimatedImageDecoder.ENCODED_LOOP_COUNT to support using the encoded repeat count in a GIF's metadata.
• Add Extras to NetworkRequest to support custom extensions.
• Add DiskCache.Builder.cleanupCoroutineContext and deprecate DiskCache.Builder.cleanupDispatcher.
• Add ImageLoader.Builder.imageDecoderEnabled to optionally disable using android.graphics.ImageDecoder on API 29 and above.
• Log a warning if there is no registered Keyer for an ImageRequest's data type.
• Make CrossfadePainter public.
• Support Transformations on all multiplatform targets.
• Support 0 as Expires header value in CacheControlCacheStrategy.
• Fix AsyncImage/SubcomposeAsyncImage/rememberAsyncImage not launching a new ImageRequest if its ContentScale changes to/from None.
• Update Kotlin to 2.1.10.
  • NOTE: This release requires compiling with Kotlin 2.1.0 or greater if you use Kotlin native due to an LLVM update.
• Update Compose to 1.7.3.
• Update androidx.core to 1.15.0.

v3.0.4

Compare Source

• Fix vector drawables not rendering in the Android Studio preview.
• Fix potential memory cache miss for requests whose size exceeds maxBitmapSize.
• Fix FakeImage not rendering on Android.
• Fix not launching a new image request when the request's Transformations change when used with AsyncImage/rememberAsyncImagePainter/SubcomposeAsyncImage.
• Fix ScaleDrawable and CrossfadeDrawable not respecting tint states.
• Allow ImageDecoder to decode partial image sources. This matches the behavior in BitmapFactory.
• Fix Bitmap.prepareToDraw() not being called after decoding.
• SvgDecoder should not return isSampled = true for non-rasterized images.
• Fall back to Dispatchers.Unconfined in Compose if an immediate main dispatcher is unavailable. This is only used in preview/test environments.
• Update Ktor 2 to 2.3.13.