> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kontext.so/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装

> 把 Swift SDK 加入你的 iOS 项目，并完成 ATT 与 SKAdNetwork 配置。

<Note>
  你需要一个 [发布方账号](/publishers#getting-started-is-easy) 来获取 `publisherToken` 与 placement code。
</Note>

## 1. 添加 SDK

<Tabs>
  <Tab title="Swift Package Manager">
    将 SDK 作为包依赖添加：

    ```swift theme={null}
    dependencies: [
        .package(url: "https://github.com/kontextso/sdk-swift", .upToNextMajor(from: "4.0.0")) // 拉取最新的 4.x 版本
    ]
    ```

    然后把 `KontextSwiftSDK` 产物加入你的 target。
  </Tab>

  <Tab title="CocoaPods">
    在 `Podfile` 中加入：

    ```ruby theme={null}
    pod 'KontextSwiftSDK', '~> 4.0' # 拉取最新的 4.x 版本
    ```

    然后运行 `pod install`。
  </Tab>
</Tabs>

## 2. 配置 IDFA（App Tracking Transparency）

请把 `NSUserTrackingUsageDescription` 加入到 `Info.plist`。SDK 会在首次创建 session 时自动触发 ATT 弹窗，并据此读取 IDFA 与 IDFV。

完整设置见 [IFA 与 ATT](/guides/ifa)——必填 key、弹窗时机的坑，以及如何自己管理弹窗。

## 3. 配置 SKAdNetwork

请把 onboarding 时提供的 SKAdNetwork 标识符追加到 `Info.plist` 中。SDK 会在启动时读取，并在每次 `/init` 时一并转发。

完整指南见 [SKAdNetwork](/guides/skadnetwork)。