コンテンツにスキップ

React Native アプリケーションの接続


React Native アプリケーションのメトリクスデータを収集し、アプリケーションパフォーマンスを可視化して分析します。

参照ガイド

前提条件

注意

RUM Headless サービスを開通済みの場合、前提条件は自動的に設定されているため、アプリケーションを直接接続できます。

ローカル環境にデプロイする場合は、以下のデータ受信側の設定を完了する必要があります。パブリック DataWay を使用する場合は、DataKit を自身でデプロイする必要はありません。

アプリケーションの接続

注意

現在の React Native バージョンは Android と iOS プラットフォームのみをサポートしています。

  1. RUM > アプリを作成 > React Native に移動します。
  2. React Native Android と React Native iOS 用にそれぞれアプリケーションを作成し、Android と iOS プラットフォームからの RUM データを別々に受信できるようにします。
  3. 各プラットフォームのアプリケーションに、対応するアプリケーション名とアプリケーション ID を入力します。
  4. 「接続方式の選択」で Agent による自動接続または手動接続を選択し、「接続設定」を完了します。

接続方式の選択

アプリケーション設定ページで「Agent による自動接続」または「手動接続」を選択し、「接続設定」を完了します。既存のアプリケーションの場合は、設定ページに直接移動して接続を続行できます。

接続方式 ユースケース 操作入口
Agent による自動接続 プログラミングアシスタントにプロジェクトを分析させて SDK の接続を完了したい場合 コンソールが生成したプロンプトをコピーし、アプリケーションのコードリポジトリでプログラミングアシスタントに渡して実行します
手動接続 SDK を自身でインストールしてパラメータを設定したい場合 データ送信方式を確認し、本記事とクイックスタートに従って設定を完了します

Agent による自動接続

  1. 現在のアプリケーションの設定ページで「Agent による自動接続」を選択します。
  2. 「接続設定」内のプロンプト全体をコピーし、現在のアプリケーションの接続情報が使用されることを確認します。
  3. アプリケーションのコードリポジトリでプログラミングアシスタントを開き、プロンプトを貼り付けます。Agent が接続ガイドに従ってプロジェクトを分析し、SDK の設定を完了します。
  4. アプリケーションをビルドして実行し、ページビューなどの操作をトリガーして、現在のアプリケーションのエクスプローラーでデータが受信されていることを確認します。

クロスプラットフォームフレームワークを使用する場合は、Agent にフレームワークと対象プラットフォームを伝え、各プラットフォームに対応するアプリケーション情報を個別に提供してください。

ページに個人用 API Key または一時認証コードが未準備である旨が表示された場合は、案内に従って補完したうえでプロンプトを再度コピーしてください。

手動接続

アプリケーション設定ページで「手動接続」を選択し、データ送信方式を確認します。

  • パブリック DataWay:RUM データを直接受信します。DataKit コレクターをインストールする必要はありません。
  • ローカル環境へのデプロイ:前提条件を満たしたうえで RUM データを受信します。

後述のインストールとクイックスタートに従って、SDK のインストール、初期化、検証を完了します。既存の SDK 設定がある場合は、まず確認して再利用し、重複した初期化を避けてください。

インストール

ソースコード:https://github.com/GuanceCloud/datakit-react-native

Demo:https://github.com/GuanceCloud/datakit-react-native/example

プロジェクトのパスで、ターミナルから次のコマンドを実行します。

npm install @cloudcare/react-native-mobile

これにより、パッケージの package.json に次の依存関係が追加されます。

"dependencies": {
"@cloudcare/react-native-mobile": "[latest_version]",
"..."
}

Android 統合の追加設定:

  • Gradle Plugin ft-plugin を設定し、アプリの起動イベントとネットワークリクエストデータ、および Android Native ネイティブ関連のイベント(ページ遷移、クリックイベント、Native ネットワークリクエスト、WebView データ)を収集します。

  • Gradle に Guance の Android Maven リポジトリ URL も設定する必要があります。Plugin と AAR の両方が必要です。設定の詳細は example 内の build.gradle を参照してください。

初期化について

最小構成の初期化例についてはクイックスタートを参照してください。

FTMobileConfig のパラメータの完全な説明については SDK 初期化を参照してください。

詳細設定の参照先

高度なシナリオ

よくある質問

フィードバック

このページは役に立ちましたか?