mcpField
B
bd-instrumentation

bd-instrumentation

github.com/bitdriftlabs開発13483 回インストール1 週間前に更新
リポジトリ

bd-instrumentation について

bd-instrumentationは、Android、iOS、React Nativeアプリへのbitdrift Capture SDKの導入と検証を開発者向けに案内します。プロジェクトのプラットフォームとSDKの状態を判定し、プラットフォーム別の資料に沿って設定と計測を進めます。

主な機能

  1. 01Android、iOS、React Nativeプロジェクトの判別
  2. 02SDK導入状況の確認
  3. 03SDK設定と計測の案内
  4. 04統合検証チェックリスト

活用シーン

  1. 01モバイルアプリへのbitdrift Capture SDK導入
  2. 02ネットワーク監視や画面トラッキングの追加
  3. 03既存SDK統合の確認

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bitdriftlabs/bd-skills --skill bd-instrumentation

インストール後、Claude Code で/bd-instrumentationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

VERSION
references/
android.md
ios.md
react-native.md

詳細

bitdrift Instrumentation

モバイルアプリへの bitdrift Capture SDK の統合をガイドします。SDK はすべてのログをデバイス上にローカルで記録し、何をアップロードするかは bitdrift のコントロールプレーンが動的に決定します。

このスキルでのドキュメントの利用方法

各ステップで bd-docs を使用して、docs.bitdrift.io から最新の API 詳細を取得します。プラットフォームのリファレンスファイルには、調べる内容が示されています。検索と取得の手順は bd-docs が処理します。

ワークフローの概要

プラットフォームを特定 → SDK がインストール済みか確認 → プラットフォームのリファレンスを読む → 新規インストールの場合：依存関係を追加し、Logger.start() を呼び出す → ユーザーが必要とする計測カテゴリーを追加

ステップ 1 — プラットフォームを特定する

ユーザーのプロジェクトから対象プラットフォームを特定します。

シグナルプラットフォーム
build.gradle、build.gradle.kts、.kt、.java、AndroidManifest.xmlAndroid
.xcodeproj、.xcworkspace、Package.swift、Podfile、.swift、.m/.hiOS
react-native を含む package.json、metro.config.js、App.tsx/App.jsReact Native

プロジェクトに複数のプラットフォームのファイルが含まれている場合（例：モノレポに Android と React Native の両方がある場合）、どの対象に計測を追加するかユーザーに確認します。

ステップ 2 — SDK の状態を確認する

プロジェクトを検索し、bitdrift Capture SDK がすでにインストールされているか確認します。

プラットフォーム次の項目が見つかった場合、SDK はすでに存在します
Androidbuild.gradle/build.gradle.kts 内の io.bitdrift:capture、またはソース内の import io.bitdrift.capture
iOSPackage.swift 内の capture-ios、Podfile 内の BitdriftCapture、またはソース内の import Capture
React Nativepackage.json 内の @bitdrift/react-native、またはソース内の import { init } from '@bitdrift/react-native'

ステップ 3 — プラットフォームのリファレンスを読み、作業を進める

プラットフォームのリファレンスファイルを読み、適切な手順に従います。

プラットフォームリファレンスファイル
Android（Kotlin/Java）このスキルディレクトリ内の references/android.md
iOS（Swift/Objective-C）このスキルディレクトリ内の references/ios.md
React Nativeこのスキルディレクトリ内の references/react-native.md

各リファレンスファイルには、次の 2 つのセクションがあります。

  • 新規インストール — SDK の依存関係を追加し、Logger.start() を呼び出します。SDK がまだ存在しない場合は、こちらに従います。SDK の起動後、以下の計測カテゴリーに進みます。
  • 計測カテゴリー — 単独で利用できる機能強化（ログ転送、ネットワーク監視、画面表示、TTI、フィールド、スパンなど）です。それぞれ独立しているため、ユーザーが必要とする項目に直接進めます。新規インストールを完了した場合も、すでに SDK が設定済みの場合も、利用できます。

検証チェックリスト（全プラットフォーム）

統合の検証を依頼された場合は、すべての項目を確認し、各チェックの PASS/FAIL/WARNING と、失敗に対する具体的なコード修正を含むレポートを作成します。

#チェック
1SDK の依存関係があり、最新の状態である
2アプリのライフサイクルの早い段階で Logger が初期化されている
3セッション戦略が設定されている
4ネットワーク監視が有効になっている
5すべての画面で画面トラッキングが有効になっている
6TTI がトラッキングされている
7クラッシュレポーターがセッション URL と連携されている
8ログイン後に setEntityID / setEntityId でエンティティ ID が設定されている（iOS/Android のみ。bd entity によるターゲティングが可能になります）
8aログイン後に addField でユーザー ID フィールドが設定されている
9該当する場合、dSYM/ProGuard マッピングのアップロードが設定されている

コメント

Markdown 対応