トラブルシューティング¶

SDK 初期化異常チェック¶

14:46:04.825 [FT-SDK] com.demo E まずSDKをインストールしてください（アプリ起動時に FTSdk.install(FTSDKConfig ftSdkConfig) を呼び出してください）

*** Assertion failure in +[FTMobileAgent startWithConfigOptions:], FTMobileAgent.m:53
*** Terminating app due to uncaught exception 'NSInternalInconsistencyException', reason: 'datakit metrics 書き込みアドレスを設定してください'

Debug デバッグを有効にする¶

以下の設定で SDK の debug 機能を有効にできます。

 let config: FTMobileConfig = {
    serverUrl: Config.SERVER_URL,
    debug: true
 };
 FTMobileReactNative.sdkConfig(config);

Release 版をリリースする際は、この設定を無効にすることを推奨します

Android Logcat および iOS Xcode Console のログサンプル

SDK は正常に動作しているがデータがない¶

• Datakit のトラブルシューティング を参照し、Datakit が正常に動作しているか確認します。

• SDK のアップロード先 datakitUrl または datawayUrl が 正しく設定 され、正しく初期化されていることを確認します。debug モード で、Android Logcat または iOS Xcode Console の同期ログを確認します。

• datakit が対応するワークスペースにデータをアップロードしているか、オフライン状態になっていないかを確認します。これは Guance にログインし、「インフラストラクチャー」を確認することで確認できます。

  

データロスト¶

一部のデータがロスト¶

• RUM の特定の Session データや、Log、Trace の数件のデータが欠落している場合、まず FTRUMConfig、FTLoggerConfig、FTTraceConfig で sampleRate < 1 が設定されていないか確認してください。

• RUM データが不完全で、Resource や Action データがない？

  Resource と Action データは View にバインドされています。FTReactNativeRUM.startView 操作が行われていることを確認してください。View イベントの収集方法については、RUM View のドキュメントを参照してください。

• データをアップロードするデバイスのネットワーク、および Datakit をインストールしたデバイスのネットワークと負荷の問題を確認します。

互換性の問題¶

react-native-navigation の実行互換性の問題¶

ReactTextShadowNode.UNSET が見つからない¶

これは react-native-navigation のバージョン互換性の問題によるものです。関連する Issue はこちらを参照してください。ReactTypefaceUtils.java を変更するか、ダウンロードして置き換えることで修正できます。

モジュール react/jsx-runtime が見つからない¶

影響範囲：SDK バージョン 0.3.0 && React バージョン < 16.14.0

原因：SDK 内部で使用している react/jsx-runtime は React >= 16.14.0 でのみサポートされています。

修正提案：

• SDK バージョンを >= 0.3.1 にアップグレードします。

注意：ローカルパスで @cloudcare/react-native-mobile 依存ライブラリを追加することは推奨しません。エラーが修正できない可能性があります。

ネイティブと React Native のハイブリッド開発¶

エラー：Cannot read properties of undefined (reading 'addError')¶

原因：RN SDK と Native SDK のバージョンが互換性がない、またはインストールが不完全であることが原因です。

問題の確認方法：

修正提案：

1. バージョン互換性の確認

   • RN SDK と Native SDK のバージョンが一致していることを確認します。
   • RN SDK に対応する Native SDK のバージョン情報は以下のパスで確認できます：
   AndroidiOS

   node_modules/@cloudcare/react-native-mobile/android/build.gradle

   node_modules/@cloudcare/react-native-mobile/FTMobileReactNativeSDK.podspec

2. 依存関係の再インストール

   • プロジェクトキャッシュのクリア：

   # npm キャッシュをクリア
   npm cache clean --force
   # または yarn キャッシュをクリア
   yarn cache clean
   

   • 依存関係の再インストール：

   # npm を使用する場合
   npm install
   # または yarn を使用する場合
   yarn install
   # iOS プロジェクトの場合、ios ディレクトリに移動して実行
   pod install
   

上記の手順により、バージョンの非互換性やインストールの不完全さに起因するこのエラーを効果的に解決できます。

関連情報¶

• Android トラブルシューティング
• iOS トラブルシューティング