如何快速集成 Adjust iOS SDK：2025 最新完整指南 🚀

2026-02-05 04:53:22作者：盛欣凯Ernestine

Adjust iOS SDK 是一款功能强大的移动归因分析工具，帮助开发者轻松追踪用户行为、优化营销效果。本指南将带你快速掌握 SDK 的目录结构、核心功能及集成方法，让你的 iOS 应用数据追踪更高效！

📂 一目了然的目录结构

Adjust iOS SDK 的目录组织清晰合理，核心代码与辅助资源分离，便于开发者快速定位所需文件：

gh_mirrors/io/ios_sdk/
├── Adjust/                # SDK核心代码
│   ├── Internal/          # 内部实现模块 [Internal/](https://gitcode.com/gh_mirrors/io/ios_sdk/blob/fbe95360df63c3c0f9a98c5f2efb39b46bd2f08d/Adjust/Internal/?utm_source=gitcode_repo_files)
│   ├── include/           # 公开头文件 [include/](https://gitcode.com/gh_mirrors/io/ios_sdk/blob/fbe95360df63c3c0f9a98c5f2efb39b46bd2f08d/Adjust/include/?utm_source=gitcode_repo_files)
│   └── PrivacyInfo.xcprivacy  # 隐私配置文件
├── examples/              # 多平台示例代码
│   ├── AdjustExample-ObjC/   # Objective-C示例
│   ├── AdjustExample-Swift/  # Swift示例
│   ├── AdjustExample-iMessage/ # iMessage扩展示例
│   └── AdjustExample-iWatch/  # Apple Watch示例
├── scripts/               # 自动化构建脚本 [scripts/](https://gitcode.com/gh_mirrors/io/ios_sdk/blob/fbe95360df63c3c0f9a98c5f2efb39b46bd2f08d/scripts/?utm_source=gitcode_repo_files)
├── Package.swift          # Swift Package配置
└── Adjust.podspec         # CocoaPods配置文件

🔑 核心目录功能解析

Adjust/Internal/：包含 SDK 核心逻辑实现，如 ADJActivityHandler（活动处理）、ADJPackageBuilder（数据打包）等关键组件，是追踪功能的核心引擎。
examples/：提供全平台集成示例，涵盖 iOS 主应用、iMessage 扩展、Apple Watch 等场景，代码简洁易懂，新手可直接参考实现。
scripts/：存放 build_frameworks.sh 等自动化脚本，支持一键构建静态/动态框架，大幅提升开发效率。

🚀 3 种快速集成方法

1. CocoaPods 一键集成（推荐）

# 1. 在Podfile中添加
pod 'Adjust'

# 2. 执行安装命令
pod install

⚠️ 注意：确保 CocoaPods 版本 ≥ 1.10.0，支持 XCFramework 集成。

2. Swift Package Manager 配置

在 Xcode 中通过菜单 File > Add Packages...，输入仓库地址：
https://gitcode.com/gh_mirrors/io/ios_sdk
选择最新版本即可完成集成。

3. 手动集成 XCFramework

执行构建脚本生成框架：
```
./scripts/build_frameworks.sh
```
将生成的 AdjustSdk.xcframework 拖拽至 Xcode 项目，并勾选 "Copy items if needed"。

✨ 核心功能与使用示例

📊 归因分析与事件追踪

通过 Adjust 类可快速实现安装归因和事件追踪：

// 初始化配置
ADJConfig *config = [ADJConfig configWithAppToken:@"YOUR_APP_TOKEN" environment:@"production"];
[Adjust appDidLaunch:config];

// 追踪自定义事件
ADJEvent *event = [ADJEvent eventWithEventToken:@"YOUR_EVENT_TOKEN"];
event.revenue = @(0.99);
event.currency = @"USD";
[Adjust trackEvent:event];

📱 多平台支持

SDK 全面支持 iOS、iPadOS、tvOS、watchOS 及 iMessage 扩展，统一的 API 设计确保跨平台开发体验一致。例如 Apple Watch 扩展中初始化：

// Apple Watch扩展初始化示例 [AdjustExample-iWatch/](https://gitcode.com/gh_mirrors/io/ios_sdk/blob/fbe95360df63c3c0f9a98c5f2efb39b46bd2f08d/examples/AdjustExample-iWatch/?utm_source=gitcode_repo_files)
ADJConfig *config = [ADJConfig configWithAppToken:@"WATCH_APP_TOKEN" environment:@"production"];
[Adjust appDidLaunch:config];

📚 官方资源与文档

完整文档：帮助中心（支持中文）
API 参考：UmbrellaHeaders/sdk/AdjustSdk.h
示例代码：examples/AdjustExample-Swift/（Swift 版本）

🎯 常见问题解决

Q：如何开启调试日志？

A：在初始化配置时设置日志级别：

config.logLevel = ADJLogLevelVerbose;

Q：支持 iOS 最低版本是多少？

A：当前 SDK 支持 iOS 11.0+，兼容 iPhone、iPad 及 iPod touch 设备。

📈 为什么选择 Adjust iOS SDK？

✅ 轻量级设计：核心包体积 < 1MB，不影响应用启动速度
✅ 隐私合规：内置 GDPR/CCPA 合规工具，支持数据匿名化处理
✅ 全平台覆盖：一次集成，支持 iOS、tvOS、watchOS 等多终端
✅ 实时数据：与 Adjust 后台无缝对接，事件数据实时可视化