Image Loaders¶

ImageLoaders are service objects that execute ImageRequests. They handle caching, data fetching, image decoding, request management, bitmap pooling, memory management, and more. New instances can be created and configured using a builder:

val imageLoader = ImageLoader.Builder(context)
    .crossfade(true)
    .build()

Coil performs best when you create a single ImageLoader and share it throughout your app. This is because each ImageLoader has its own memory cache, disk cache, and OkHttpClient.

Caching¶

Each ImageLoader keeps a memory cache of recently decoded Bitmaps as well as a disk cache for any images loaded from the Internet. Both can be configured when creating an ImageLoader:

val imageLoader = ImageLoader.Builder(context)
    .memoryCache {
        MemoryCache.Builder(context)
            .maxSizePercent(0.25)
            .build()
    }
    .diskCache {
        DiskCache.Builder()
            .directory(context.cacheDir.resolve("image_cache"))
            .maxSizePercent(0.02)
            .build()
    }
    .build()

You can access items in the memory and disk caches using their keys, which are returned in an ImageResult after an image is loaded. The ImageResult is returned by ImageLoader.execute or in ImageRequest.Listener.onSuccess and ImageRequest.Listener.onError.

Singleton vs. Dependency Injection¶

The default Coil artifact (io.coil-kt:coil) includes the singleton ImageLoader, which can be accessed using an extension function: context.imageLoader.

Coil performs best when you have a single ImageLoader that's shared throughout your app. This is because each ImageLoader has its own set of resources.

The singleton ImageLoader can be configured by implementing ImageLoaderFactory on your Application class.

Optionally, you can create your own ImageLoader instance(s) and inject them using a dependency injector like Dagger. If you do that, depend on io.coil-kt:coil-base as that artifact doesn't create the singleton ImageLoader.