Lottie iOS Versions Save

An iOS library to natively render After Effects vector animations

4.1.3

1 year ago

Note Starting in Lottie 4.0, the Core Animation rendering engine is now enabled by default. Learn more about this change: Announcing Lottie 4.0 for iOS on the Airbnb Tech Blog

What's Changed

4.1.2

1 year ago

Note Starting in Lottie 4.0, the Core Animation rendering engine is now enabled by default. Learn more about this change: Announcing Lottie 4.0 for iOS on the Airbnb Tech Blog

4.1.2 fixes an issue where the lottie-spm package would fail to build in some environments: https://github.com/airbnb/lottie-spm/pull/5#issuecomment-1398991609, https://github.com/airbnb/lottie-ios/issues/1926#issuecomment-1398866563

4.1.0 release notes

We've added a new way to integrate Lottie into your project using Swift Package Manager. We now provide a separate lottie-spm repo that is much smaller than the main lottie-ios repo (~500kb instead of ~300mb). Learn more about this change here.

Improvements and bug fixes

4.1.1

1 year ago

Note Starting in Lottie 4.0, the Core Animation rendering engine is now enabled by default. Learn more about this change: Announcing Lottie 4.0 for iOS on the Airbnb Tech Blog

4.1.1 fixes an issue where the lottie-spm package could not be embedded into iOS app builds (#1925), which could cause apps to crash (#1926).

4.1.0 release notes

We've added a new way to integrate Lottie into your project using Swift Package Manager. We now provide a separate lottie-spm repo that is much smaller than the main lottie-ios repo (~500kb instead of ~300mb). Learn more about this change here.

Improvements and bug fixes

4.1.0

1 year ago

Note Starting in Lottie 4.0, the Core Animation rendering engine is now enabled by default. Learn more about this change: Announcing Lottie 4.0 for iOS on the Airbnb Tech Blog

We've added a new way to integrate Lottie into your project using Swift Package Manager. We now provide a separate lottie-spm repo that is much smaller than the main lottie-ios repo (~500kb instead of ~300mb). Learn more about this change here.

Improvements and bug fixes

4.0.1

1 year ago

4.0.1 fixes an issue in 4.0.0 where the install could fail due to issues with Git LFS: #1830, #1834.

We now publish xframework binaries as a part of our release process: https://github.com/airbnb/lottie-ios/discussions/1807#discussioncomment-4346438

Major changes in Lottie 4.0

Learn more about this release: Announcing Lottie 4.0 for iOS on the Airbnb Tech Blog

  • The new Core Animation rendering engine (first introduced in Lottie 3.4.0) is now enabled by default for supported animations.

    • 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.
    • 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.
    • If you encounter any compatibility issues when using RenderingEngineOption.automatic, please file an issue with a copy of your animation json.

  • DecodingStrategy.dictionaryBased is now enabled by default

    • The new dictionary-based decoding implementation is 2x faster than the previous Codable decoding implementation
    • If you encounter any compatibility issues with this new decoding implementation, please file an issue with a copy of your animation json.

  • Backwards compatibility typealiases for Animation, AnimationView, Color, Vector1D, Vector2D, and Vector3D, which were introduced in Lottie 3.5.0, have been removed to resolve conflicts with types in Apple frameworks. These types are now named LottieAnimation, LottieAnimationView, LottieColor, LottieVector1D, LottieVector2D, and LottieVector3D.

  • The default LottieBackgroundBehavior used by LottieAnimationView is now .pauseAndRestore instead of pause.

  • Lottie for iOS now supports the dotLottie file format.

  • The library's minimum-supported Swift version is now Swift 5.5.

XCFramework checksum: b6d8b0b81975d91965b8bb00cffb0eae4b3d94538b6950a90bc1366afd5d4239

4.0.0

1 year ago

Learn more about this release: Announcing Lottie 4.0 for iOS on the Airbnb Tech Blog

Major changes

  • The new Core Animation rendering engine (first introduced in Lottie 3.4.0) is now enabled by default for supported animations.

    • 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.
    • 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.
    • If you encounter any compatibility issues when using RenderingEngineOption.automatic, please file an issue with a copy of your animation json.

  • DecodingStrategy.dictionaryBased is now enabled by default

    • The new dictionary-based decoding implementation is 2x faster than the previous Codable decoding implementation
    • If you encounter any compatibility issues with this new decoding implementation, please file an issue with a copy of your animation json.

  • Backwards compatibility typealiases for Animation, AnimationView, Color, Vector1D, Vector2D, and Vector3D, which were introduced in Lottie 3.5.0, have been removed to resolve conflicts with types in Apple frameworks. These types are now named LottieAnimation, LottieAnimationView, LottieColor, LottieVector1D, LottieVector2D, and LottieVector3D.

  • The default LottieBackgroundBehavior used by LottieAnimationView is now .pauseAndRestore instead of pause.

  • Lottie for iOS now supports the dotLottie file format.

  • The library's minimum-supported Swift version is now Swift 5.5.

Full changelog

3.5.0

1 year ago

Note: Lottie 3.4.0 added a new rendering engine powered by Core Animation. Please try it out and let us know if you encounter any issues! It will be enabled by default in Lottie 4.0, which we plan on releasing later this month. More information is available in this announcement: https://github.com/airbnb/lottie-ios/discussions/1627

Lottie 3.5.0

This version renames several public types, to resolve conflicts with types in Apple frameworks (https://github.com/airbnb/lottie-ios/issues/1420):

  • Lottie.Animation has been renamed to LottieAnimation, to resolve a conflict with SwiftUI.Animation
  • Lottie.Color has been renamed to LottieColor, to resolve a conflict with SwiftUI.Color
  • Lottie.Vector3D has been renamed to LottieVector3D, to resolve a conflict with Spatial.Vector3D

For consistency with these new names, we have also renamed the following public types:

  • Lottie.AnimationView has been renamed to LottieAnimationView
  • Lottie.Vector1D has been renamed to LottieVector1D
  • Lottie.Vector2D has been renamed to LottieVector2D.

For backwards compatibility Lottie 3.5.0 includes typealiases for the old names, which map to the new names. These typealiases are marked as deprecated and include fix-its to update call-sites to the new name.

Lottie 4.0

We plan on releasing Lottie 4.0 in the next few weeks. In Lottie 4.0 we will remove the compatibility typealiases (for Animation, AnimationView, Color, etc) , so code using the old names will no longer compile. This will resolve the naming conflicts with SwiftUI types. Consider updating to Lottie 3.5.0 first, applying the fix-its recommended by the deprecation warnings, and then update to Lottie 4.0 once it is released (Lottie 4.0 will no longer include deprecation warnings with fix-its). Thank you for bearing with us through this transition process!

Lottie 4.0 will also make the new Core Animation rendering engine (added in Lottie 3.4.0) the default rendering engine option. As mentioned above, please try out the new rendering engine if you haven't yet and let us know if you encounter any issues! We've been hard at work fixing issues reported by the community.

Known issues

If your application has a storyboard that references AnimationView, it may crash when using Lottie 3.5.0 (https://github.com/airbnb/lottie-ios/issues/1771). The fix for this issue is to update all references of AnimationView to LottieAnimationView and update all references of Animation to LottieAnimation. This should be resolved in Lottie 4.0, where code using the old names will no longer compile.

3.4.4

1 year ago

Note: Lottie 3.4.0 added a new rendering engine powered by Core Animation. Please try it out and let us know if you encounter any issues! It will be enabled by default in Lottie 4.0, which we plan on releasing later this month. More information is available in this announcement: https://github.com/airbnb/lottie-ios/discussions/1627

What's Changed

3.4.3

1 year ago

Note: Lottie 3.4.0 added a new rendering engine powered by Core Animation. Please try it out and let us know if you encounter any issues! It will be enabled by default in a future version of Lottie. More information is available in this announcement: https://github.com/airbnb/lottie-ios/discussions/1627

New Features

Bug fixes

3.4.2

1 year ago

Note: Lottie 3.4.0 added a new rendering engine powered by Core Animation. Please try it out and let us know if you encounter any issues! It will be enabled by default in a future version of Lottie. More information is available in this announcement: https://github.com/airbnb/lottie-ios/discussions/1627

New features

Bug fixes