Repository files navigation

This repo provides Swift Package Manager support forlottie-ios.

To install Lottie usingSwift Package Manager you can follow thetutorial published by Apple using the URL for this repo with the current version:

1. In Xcode, select “File” → “Add Packages...”
2. Enterhttps://github.com/airbnb/lottie-spm.git

or you can add the following dependency to yourPackage.swift:

.package(url:"https://github.com/airbnb/lottie-spm.git", from:"4.5.1")

and add it to your target like this:

dependencies:[.product(name:"Lottie",package:"lottie-spm")]

The main git repository forlottie-ios is somewhat large (300+ MB), and Swift Package Manager always downloads the full repository with all git history. Thislottie-spm repo is much smaller (less than 500kb), so can be downloaded much more quickly.

Instead of downloading the full git history of Lottie and building it from source, this repo just contains a pointer to the precompiled XCFramework included in thelatest lottie-ios release (typically ~8MB). If you prefer to include Lottie source directly your project, you can directly depend on thelottie-ios repo instead.

Lottie is also available via Cocoapods, Carthage, and npm. You can also build Lottie directly from source, or manually integrate precompiled XCFrameworks into your project. More information is available in the mainlottie-ios repo.

Lottie supports Swift / Xcode versions back to the minimum version that is permitted by Apple for submissions to the App Store. You can see the most up-to-date information for which Swift versions Lottie supports onSwift Package Index:

Lottie does not collect any data. We provide this notice to help you fill outApp Privacy Details. We additionally provide aprivacy manifest which can be included in your app.

When generating a privacy report, Xcode will automatically detect and use the privacy manifest included in the downloadedLottie.xcframework. For convenience we also provide a copy of the privacy manifestin this repo.

We distribute XCFramework bundles for each release onGitHub. In Lottie 4.4.0 and later, these XCFramework bundles include acode signature. These bundles are self-signed under the name "Lottie iOS" and have the following fingerprint:

89 2F 1B 43 04 7B 50 53 8F 2F 46 EA D9 29 00 DD 3D 48 11 F358 21 78 C0 61 A5 FB 20 F1 11 CB 26

When using lottie-spm, the downloadedLottie.xframework isn't visible in the project navigator. To validate the authenticity of a lottie-spm package, you can confirm that thePackage.swift file references a binary XCFramework fromhttps://github.com/airbnb/lottie-ios/releases.