Gifs¶
This feature is only available on Android.
Unlike Glide, GIFs are not supported by default. However, Coil has an extension library to support them.
To add GIF support, import the extension library:
And that's it! The ImageLoader
will automatically detect any GIFs using their file headers and decode them correctly.
Optionally, you can manually add the decoder to your component registry when constructing your ImageLoader
:
val imageLoader = ImageLoader.Builder(context)
.components {
if (SDK_INT >= 28) {
add(AnimatedImageDecoder.Factory())
} else {
add(GifDecoder.Factory())
}
}
.build()
To transform the pixel data of each frame of a GIF, see AnimatedTransformation.
Note
Coil includes two separate decoders to support decoding GIFs. GifDecoder
supports all API levels, but is slower. ImageDecoderDecoder
is powered by Android's ImageDecoder API which is only available on API 28 and above. ImageDecoderDecoder
is faster than GifDecoder
and supports decoding animated WebP images and animated HEIF image sequences.