lottie-ios breaking changes

cocoapods

10 curated breaking changes across major versions of lottie-ios. Use this as a migration checklist before bumping dependencies.

10
changes
Breaking changes by transition
  • 4.0.0 \u2192 4.0.1breaking

    The new Core Animation rendering engine ([first introduced in Lottie 3.4.0](https://github.com/airbnb/lottie-ios/discussions/1627)) is now enabled by default for supported animations.

  • 4.0.0 \u2192 4.0.1breaking

    Specifically, `LottieConfiguration.shared.renderingEngine` now defaults to `.automatic` instead of `.mainThread`. Animations that use features which are not supported by the Core Animation rendering engine will automatically fall back to using the original Main Thread rendering engine.

  • 4.0.0 \u2192 4.0.1breaking

    When using the Core Animation rendering engine, Lottie animations now always animate smoothly regardless of the amount of work being done on the app’s main thread. This **significantly improves animation performance** while also eliminating CPU overhead.

  • 4.0.0 \u2192 4.0.1breaking

    If you encounter any compatibility issues when using `RenderingEngineOption.automatic`, please file an issue with a copy of your animation json.

  • 4.0.0 \u2192 4.0.1breaking

    `DecodingStrategy.dictionaryBased` is now enabled by default

  • 3.5.0 \u2192 4.0.0breaking

    The new Core Animation rendering engine ([first introduced in Lottie 3.4.0](https://github.com/airbnb/lottie-ios/discussions/1627)) is now enabled by default for supported animations.

  • 3.5.0 \u2192 4.0.0breaking

    Specifically, `LottieConfiguration.shared.renderingEngine` now defaults to `.automatic` instead of `.mainThread`. Animations that use features which are not supported by the Core Animation rendering engine will automatically fall back to using the original Main Thread rendering engine.

  • 3.5.0 \u2192 4.0.0breaking

    When using the Core Animation rendering engine, Lottie animations now always animate smoothly regardless of the amount of work being done on the app’s main thread. This **significantly improves animation performance** while also eliminating CPU overhead.

  • 3.5.0 \u2192 4.0.0breaking

    If you encounter any compatibility issues when using `RenderingEngineOption.automatic`, please file an issue with a copy of your animation json.

  • 3.5.0 \u2192 4.0.0breaking

    `DecodingStrategy.dictionaryBased` is now enabled by default

API access

Get this data programmatically \u2014 free, no authentication.

curl https://depscope.dev/api/breaking/cocoapods/lottie-ios
lottie-ios breaking changes — CocoaPods migration guide | DepScope