1# 6.4.0 2### New Features 3* Add safe mode ([#2455](https://github.com/airbnb/lottie-android/pull/2455)) 4* Clarify clipToCompositionBounds docs ([#2473](https://github.com/airbnb/lottie-android/pull/2473)) 5 6# 6.3.0 7* Add LottiePainter and rememberLottiePainter to use Lottie anywhere a Painter can be used ([#2442](https://github.com/airbnb/lottie-android/pull/2442)) 8* Constrain unconstrainted bounds when the other dimension is constrained ([#2437](https://github.com/airbnb/lottie-android/pull/2437)) 9 10# 6.1.0 11* Key dynamic properties on composition to ensure that they are set if the composition changes ([#2290](https://github.com/airbnb/lottie-android/pull/2290)) 12* Add `@JvmOverloads` to `LottieAnimation` to improve binary compatibility ([#2320](https://github.com/airbnb/lottie-android/pull/2320)) 13 14# 6.0.0 15* Add reverseOnRepeat ([#2128](https://github.com/airbnb/lottie-android/pull/2128)) 16* Allow setting a font map for custom fonts ([#2180](https://github.com/airbnb/lottie-android/pull/2180)) 17* Allow images to be rendered ([#2183](https://github.com/airbnb/lottie-android/pull/2072)) 18 19# 5.2.0 20* [BREAKING CHANGE] 21LottieAnimation now takes progress as a `() -> Float` rather than a `Float`. This allows Lottie to redraw without triggering a recomposition every time progress updates. For more information, refer to the Compose [phase docs](https://developer.android.com/jetpack/compose/phases). The existing API will exist as deprecated for one more release but will then be removed. For the vast majority of use cases: 22 23```kotlin 24LottieAnimation(composition, progress) 25``` 26will become: 27 28```kotlin 29LottieAnimation(composition, { progress }) 30``` 31 32or 33 34```kotlin 35LottieAnimation( 36 composition = composition, 37 progress = { progress } 38) 39``` 40[#2078](https://github.com/airbnb/lottie-android/pull/2078). 41 42# 5.1.1 43* Add support for completable animations in tests ([#2051](https://github.com/airbnb/lottie-android/pull/2051)) 44 45# 5.0.0 46* You can tell Lottie to render the full animation even if it extends beyond the original composition bounds by setting `clipToCompositionBounds` to false. 47* Add support for dynamic text via `LottieProperty.TEXT` and the existing dynamic property APIs ([#1995](https://github.com/airbnb/lottie-android/issues/1995)) 48* Respect Android system animator scale (include 0 for modes like battery saver) ([#2000](https://github.com/airbnb/lottie-android/pull/2000)) 49* Added support for loading animations via content provider URIs (LottieCompositionSpec.ContentProvider) ([#1982](https://github.com/airbnb/lottie-android/pull/1982)) 50* Fixed dynamic gradient properties ([#1969](https://github.com/airbnb/lottie-android/pull/1969)). 51* Prevent infinite animations from hanging espresso tests by using the same mechanism as androidx animations ([#1987](https://github.com/airbnb/lottie-android/pull/1987)) 52* Set the merge paths property before the composition to avoid building the composition layer with the wrong merge paths value and triggering a second rebuilt ([#1997](https://github.com/airbnb/lottie-android/pull/1997)) 53 54# 4.2.0 55* [BREAKING CHANGE] LottieAnimation will now default to the composition size rather than `fillMaxSize()` ([#1892](https://github.com/airbnb/lottie-android/pull/1892)) 56* Improved the performance of loading and parsing animations ([#1891](https://github.com/airbnb/lottie-android/pull/1891)) 57 58# 4.1.0 59* No changes 60 61# 4.0.0 62* Upgrade to Compose 1.0 63* Made LottieCompositionSpec an inline class([#1855](https://github.com/airbnb/lottie-android/pull/1855)) 64 65# 1.0.0-rc02-1 66* Upgrade to Compose rc02 67* Add support for ContentScale and Alignment just like the Image composable ([#1844](https://github.com/airbnb/lottie-android/pull/1844)) 68* Automatically load fonts if possible and allow setting fonts via dynamic properties ([#1842](https://github.com/airbnb/lottie-android/pull/1842)) 69* Add LottieCancellationBehavior support to animateLottieCompositionAsState ([#1846](https://github.com/airbnb/lottie-android/pull/1846)) 70* Allow custom cache keys/cache skipping ([#1847](https://github.com/airbnb/lottie-android/pull/1847)) 71* Always respect LottieClipSpec ([#1848](https://github.com/airbnb/lottie-android/pull/1848)) 72 73 74# 1.0.0-rc01-1 75## Breaking Changes 76`LottieAnimation` now takes a progress float instead of driving the animation internally. 77The driving of animations has been split into a new `LottieAnimatable` class and 78`animateLottieCompositionAsState` function. These are analogous to Jetpack's `Animatable` and 79`animate*AsState` functions. 80Properties that pertain to the animation such as speed, repeat count, and the new clip spec are part of 81`animateLottieComposition` whereas properties that are related to rendering such as enabling merge paths 82and setting an image asset delegate are on the `LottieAnimation` composable. 83 84`lottieComposition` has also been renamed `rememberLottieComposition`. 85 86There are overloaded version of `LottieAnimation` that merge the properties for convenience. Please 87refer to the docs for `LottieAnimation`, `LottieAnimatable`, `animateLottieCompositionAsState` 88and `rememberLottieComposition` for more information. 89* Added the ability to clip the progress bounds of an animation. 90* Added the ability to set and control dynamic properties. 91* Removed the existing imageAssetDelegate parameter and moved imageAssetsFolder to rememberLottieComposition. 92 Images are now loaded from assets or decoded from the base64 string embedded in the json file during parsing 93 and on the IO thread pool rather than upon first render on the main thread during animations. If you want to 94 supply your own animations, call `composition.images["your_image_id"].bitmap = yourBitmap`. This lets you control 95 exactly how and when the bitmaps get created and set. The previous implementation of calling a callback on every 96 frame encouraged the incorrect behavior of doing IO tasks during the animation hot path. Check out ImagesExamplesPage.kt 97 for usage. 98 99# 1.0.0-beta07-1 100* Compatible with Jetpack Compose Beta 07 101 102# 1.0.0-beta03-1 103* Update versioning scheme to match the underlying Compose version 104* Compatible with Jetpack Compose Beta 03 105* Added support for images ([#1766](https://github.com/airbnb/lottie-android/pull/1766)) 106* Added the ability to control whether merge paths are enabled or not ([#1744](https://github.com/airbnb/lottie-android/pull/1744)) 107* Swapped modifier application order to follow Compose guidelines (and support setting specific sizes) ([#1765](https://github.com/airbnb/lottie-android/pull/1765)) 108 109# 1.0.0-alpha07-SNAPSHOT 110* Add flag for merge paths to LottieAnimationState 111* Compatible with Jetpack Compose Beta 02 112 113# 1.0.0-alpha06 114* Compatible with Jetpack Compose Alpha 12 115 116# 1.0.0-alpha05 117* Jetpack Compose Alpha 9 118 119# 1.0.0-alpha04 120* Jetpack Compose Alpha 8 121 122# 1.0.0-alpha01 123* Initial release of Lottie Compose 124* Compatible with Jetpack Compose alpha 6 125* Built with Lottie 3.5.0 126* Wraps the existing renderer with Jetpack Compose friendly APIs. 127* For up to date docs on how to use it, check out the [docs](http://airbnb.io/lottie/#/android-compose). 128