用户体验监控 iOS SDK 由腾讯云可观测团队提供技术支持。支持 Swift Package Manager 自动集成和手动集成两种方式。
版本升级提醒
因 SDK 中存在缓存数据等，旧版本无法做到对新版本缓存数据的全兼容，故一般情况下升级后的 SDK 强烈不推荐进行降级处理，可能存在缓存读取异常的情况。若存在降级的需求，请联系我们。
前提条件
用户体验监控 iOS SDK 要求使用 Xcode 15.3 或更高版本，最低支持 iOS 12.0。
自动集成（推荐）
1. 接入 iOS SDK，支持两种方式接入。
方式1：在 Xcode 中通过 File > Add Package Dependencies 添加 SDK 仓库地址，然后在 Dependency Rule 选择 Up to Next Major Version，起始版本
0.2.0。https://cnb.cool/tencent-dem/ios-sdk
方式2：在工程的
Package.swift 中声明依赖。dependencies: [.package(url: "https://cnb.cool/tencent-dem/ios-sdk.git", from: "0.2.0")]
2. 宿主代码只允许导入这一个模块。
import TDEMiOSSDK
手动集成
若工程不使用 Swift Package Manager，可把
Frameworks/TDEM.xcframework 直接拖入工程。1. 下载用户体验监控 iOS SDK 的 xcframework 文件。
2. 拖拽
TDEM.xcframework 文件到 Xcode 工程内，在 General > Frameworks, Libraries, and Embedded Content 中添加，选择 Embed & Sign（SDK 为动态库）。3. 确认 Build Settings > Swift Compiler - General > Objective-C Interop Mode 为
objc（Xcode 默认值，无需改动）。注意：
仅当工程显式把
SWIFT_OBJC_INTEROP_MODE 设成了 objcxx、且存在 .mm（Objective-C++）文件时，才会触发编译错误。因为该 xcframework 的 TDEMiOSSDK-Swift.h 已烘入 C++ 互操作内联代码；消费侧若为 objcxx，.mm 文件会按 Objective-C++ 展开这些区块并失败。解法：把消费侧改为
objc，或避免用 .mm 文件 @import TDEMiOSSDK。
