平台与兼容性
选择 SDK 前，先核对目标系统、构建方式和所用包版本。安装步骤见各平台接入指南；功能范围见客户端能力总览。
Web
| 项目 | 要求 |
|---|---|
| 包 | @track-business/sdk-web，版本 1.0.0 |
| 模块格式 | ESM，包含 TypeScript 类型；不提供原生 CommonJS require 入口 |
| 浏览器版本 | 最低版本尚未声明；请在目标浏览器、WebView 中验证 |
| 框架 | React、Vue 3 有适配包；在 Next.js、Nuxt 等 SSR 应用中，只在浏览器环境创建客户端 |
使用其他构建工具时，请确认项目能够消费 ESM。Web 接入步骤见Web SDK。
Android
| 项目 | 要求 |
|---|---|
| 系统 | Android 6.0（API 23）及以上 |
| 字节码 | Java 17；宿主工具链还需与包内 AndroidX 依赖兼容 |
| 核心包 | com.trackbusiness:track-business-sdk:1.0.0 |
| 可选组件 | Compose：com.trackbusiness:track-business-sdk-compose:1.0.0；传统 View 自动采集：com.trackbusiness:track-business-sdk-android-autotrack:1.0.0 |
SDK 使用 AndroidX 和 SQLite，不随核心包提供自有 .so。应用需要网络权限；应用的 targetSdk 由宿主根据发布要求配置。安装和权限配置见Android SDK。
iOS
| 项目 | 要求 |
|---|---|
| 系统 | iOS 13 及以上 |
| 下载包 | TrackBusinessSDK-<版本>.xcframework.zip，解压目录为 TrackBusinessSDK.xcframework，二进制 Swift 模块名为 TrackBusinessSDKKit |
| 架构 | iOS arm64 设备及 arm64 模拟器；不包含 x86_64 模拟器架构 |
| 链接方式 | 静态 XCFramework；按包内接入说明链接，并核对隐私清单进入最终应用 |
| 可选组件 | SwiftUI、UIKit / Objective-C 桥接及 Location 模块，使用与核心包相同的版本 |
按iOS SDK 接入指南安装，并在目标应用中验证 Xcode 和 Swift 工具链兼容性。
React Native 与 Flutter
React Native 1.0.0 和 Flutter 1.0.0 使用配套的 Android/iOS SDK；下载包已包含对应原生组件。Expo 应使用 Prebuild 或 Development Build。第三方依赖仍由应用提供。接入步骤见React Native和Flutter。
服务端 SDK
服务端 SDK 独立于客户端版本组合发布。当前接入语言及运行环境见服务端 SDK 概览，安装包见服务端 SDK 下载。需要与业务事务一起提交的事件，应由应用的事务 Outbox 保证。
接入时还需核对
- Web
create后可用await sdk.ready()等待初始化；Android 和 iOS 使用各自的创建接口。具体调用见平台接入指南。 - Android SDK 默认观察应用前后台；iOS 应用生命周期事件需要可选 UIKit 适配器或应用显式转发。后台上传受系统调度影响，详见应用生命周期。
- 事件恢复取决于实际存储后端；内存队列不能跨进程恢复，详见离线队列与重试。
- 自动采集按平台分别配置，Compose、传统 View、UIKit 与 Web 的触发范围不同，详见客户端能力总览。
- Web 上报地址、移动端网络限制及项目凭据见环境与项目凭据。应用商店隐私申报见Google Play和App Store。