bitdrift Instrumentation 是一个用于将 bitdrift Capture SDK 集成到移动应用中的技能。该 SDK 在设备本地记录所有日志，由 bitdrift 控制平面动态决定上传哪些内容。
用途
该技能指导开发者将 bitdrift Capture SDK 集成到 iOS、Android 和 React Native 应用中，涵盖全新安装以及扩展现有集成。
主要能力
- 检测目标平台（Android、iOS、React Native）
- 判断 bitdrift Capture SDK 是否已安装
- 提供各平台参考文件，包含新安装步骤和独立的埋点类别
- 埋点类别包括：日志转发、网络监控、屏幕视图、TTI、字段、跨度等
- 提供跨平台验证清单，输出 PASS/FAIL/WARNING 报告及具体代码修复建议
使用方式
该技能通过 $bd-docs 从 docs.bitdrift.io 获取实时 API 细节。工作流程如下：
-
检测平台：根据项目文件识别目标平台。Android 的信号包括 build.gradle、build.gradle.kts、.kt、.java、AndroidManifest.xml；iOS 的信号包括 .xcodeproj、.xcworkspace、Package.swift、Podfile、.swift、.m/.h；React Native 的信号包括包含 react-native 的 package.json、metro.config.js、App.tsx/App.js。如果项目包含多个平台的文件，需询问用户要埋点的目标平台。
-
确定 SDK 状态：检查 SDK 是否已安装。Android 查找 build.gradle/build.gradle.kts 中的 io.bitdrift:capture 或源码中的 import io.bitdrift.capture；iOS 查找 Package.swift 中的 capture-ios、Podfile 中的 BitdriftCapture 或源码中的 import Capture；React Native 查找 package.json 中的 @bitdrift/react-native 或源码中的 import { init } from '@bitdrift/react-native'。
-
阅读平台参考并继续：Android（Kotlin/Java）参考 references/android.md，iOS（Swift/Objective-C）参考 references/ios.md，React Native 参考 references/react-native.md。每个参考文件包含两部分：新安装（添加 SDK 依赖并调用 Logger.start()）和埋点类别（独立增强功能，可跳转到用户需要的任意一项）。
验证清单
当被要求验证集成时，检查以下所有项目并生成报告，每项检查标注 PASS/FAIL/WARNING，并为失败项提供具体代码修复：
- SDK 依赖存在且为最新
- Logger 在应用生命周期早期初始化
- 会话策略已配置
- 网络监控已激活
- 每个屏幕都有屏幕跟踪
- TTI 已跟踪
- 崩溃报告器已链接会话 URL
- 登录后通过 setEntityID / setEntityId 设置实体 ID（仅 iOS/Android；启用 bd 实体定向） 8a. 登录后通过 addField 设置用户身份字段
- 已配置 dSYM/ProGuard 映射上传（如适用）
适用场景
适用于需要在 iOS、Android 或 React Native 移动应用中集成 bitdrift Capture SDK 的开发者，无论是全新安装还是扩展现有集成。
限制
资料中未提供关于收费、价格、平台兼容性细节、效果或具体使用步骤的更多信息。