iOS / macOS 安装 Lottie——SPM、CocoaPods、Carthage 三选一

支持的平台

lottie-ios 同时覆盖：

方式一：Swift Package Manager（推荐）

SPM 是 Apple 官方包管理方式，也是 Lottie 团队优先推荐的方式。

Xcode 界面添加

1. 打开 Xcode 项目 → File → Add Packages...
2. 输入仓库地址：lottie-spm 仓库（airbnb 组织下）
3. 选择版本（建议 Up to Next Major）
4. 选好 Target 后点 Add Package

在 Package.swift 里添加

dependencies: [
    .package(url: "lottie-spm 仓库地址", from: "4.5.0")
]

注意：用的是 lottie-spm 仓库而不是主仓库。主仓库 lottie-ios 体积超过 300MB（包含完整 git 历史），SPM 每次拉取整个仓库会非常慢。lottie-spm 是一个瘦身仓库（< 500KB），直接指向预编译的 XCFramework。

方式二：CocoaPods

# Podfile
platform :ios, '11.0'

target 'YourApp' do
  pod 'lottie-ios', '~> 4.5'
end

然后：

pod install

lottie-ios 5.x 之后，Pod 名从 lottie-ios 简化为 Lottie——注意确认你用的版本和 Pod 名对应。

方式三：Carthage

# Cartfile
github "airbnb/lottie-ios" ~> 4.5

carthage update --use-xcframeworks

Carthage 现在不是官方优先推荐，但仍然支持。

手动安装（ZIP）

如果不想用任何包管理器，可以直接从 GitHub Releases 下载 XCFramework，拖进 Xcode 项目：

1. 到 lottie-ios 的 GitHub Releases。
2. 下载最新的 Lottie.xcframework.zip。
3. 解压后把 Lottie.xcframework 拖到你的项目里。
4. 在 Target → General → Frameworks, Libraries, and Embedded Content 里确认 Lottie.xcframework 被标记为 Do Not Embed。

验证安装

在某个 Swift 文件顶部：

import Lottie

没有编译错误就是安装成功。