Skip to content

Releases: airbnb/lottie-spm

4.3.0

14 Sep 22:27
2ae19d3
Compare
Choose a tag to compare

Lottie 4.3.0 adds many new features, including:

  • Official support for SwiftUI!
  • A public Core Animation CALayer subclass
  • Support for reduced motion
  • Support for drop shadow layer effects
  • Support for visionOS in the lottie-ios repo

You can learn more about Lottie 4.3.0 in this announcement: Lottie 4.3.0 now available, with official support for SwiftUI #2189

New Features

Bug fixes

Thanks to everyone who contributed to this release!

4.2.0

28 Apr 00:48
60ea4f8
Compare
Choose a tag to compare

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

Full Changelog: airbnb/lottie-ios@4.1.3...4.2.0

4.1.3

15 Feb 23:50
c385281
Compare
Choose a tag to compare

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

23 Jan 18:27
f2b51ce
Compare
Choose a tag to compare

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: #5 (comment), airbnb/lottie-ios#1926 (comment)

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

20 Jan 18:48
92b75c5
Compare
Choose a tag to compare

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 (airbnb/lottie-ios#1925), which could cause apps to crash (airbnb/lottie-ios#1925).

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

19 Jan 20:04
fe58b54
Compare
Choose a tag to compare

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

18 Jan 17:55
a62f3c4
Compare
Choose a tag to compare

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: airbnb/lottie-ios#1807 (comment)

This is also the first release available through the lottie-spm repo.

Note
There's a known issue where lottie-spm 4.0.1 only supports Swift 5.7 / Xcode 14. This will be resolved in lottie-spm 4.1.0.

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.