コンテンツにスキップ

トラブルシューティング

SDK 初期化異常チェック

Logcat を確認し、Level が Error、Tag が [FT-SDK] プレフィックスのログが存在するか確認します。

14:46:04.825 [FT-SDK] com.demo E 请先安装SDK(在应用启动时调用FTSdk.install(FTSDKConfig ftSdkConfig))

Debug 環境で、Guance SDK を設定し、アプリケーションを初回実行した後、Xcode のデバッガコンソールを確認してください。SDK はアサーションを使用して複数の設定が正しいかを確認し、設定に誤りがある場合はクラッシュして関連する警告を出力します。

例:SDK の設定時に datakit metrics の書き込み先を設定していない場合、プログラムはクラッシュし、コンソールに警告⚠️を出力します。

*** 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 バージョンのリリース時には、この設定をオフにすることを推奨します

Logcat で Tag が [FT-SDK] プレフィックスのログを確認します。

SDK のデバッグログには [FTLog] というプレフィックスが付きます。

  • xcode で実行する場合、xcode のデバッグコンソールで SDK のデバッグログを直接確認できます。

  • ターミナルコマンド yarn ios または yarn react-native run-ios で実行する場合、Mac の「コンソール」で SDK のデバッグログを確認できます。

「コンソール」の使用方法:

操作 を選択し、概要情報を含める、デバッグ情報を含める にチェックを入れます。

デバッグ対象のデバイスを選択し、開始 ボタンをクリックして、右側の検索条件ボックスに検索条件 [FTLog] を入力します。これで SDK のデバッグログを確認できます。

console_app_use

Android Logcat および iOS Xcode Console のログ例

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

  • Datakit が正常に動作しているか確認します。

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

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

データ損失

一部のデータが失われる場合

  • RUM の特定の Session データ、または Log、Trace の数件のデータが失われた場合は、まず FTRUMConfig、FTLogConfig、FTTraceConfig で 100 未満のパーセントサンプリングレート(sessionSamplingRate、logSamplingRate、traceSamplingRate)が設定されていないか、新しいフィールドを設定せずに sampleRate < 1 を使用していないかを確認してください。SDK 0.4.3 以降、新旧のフィールドを同時に設定した場合は新しいフィールドが優先されます。詳細はサンプリング設定を参照してください。

  • 収集した 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 のバージョンが互換性がない、またはインストールが不完全であることが原因です。

問題の確認方法:

Android プロジェクトのルートディレクトリで、ターミナルから ./gradlew app:dependencies コマンドを実行し、出力結果に cloudcare_react-native-mobile が含まれているか確認します。

cloudcare_react-native-mobile は、RN プロジェクトに Guance RN SDK の依存関係を追加した後、Android 側でインストールされる依存ライブラリです。

Podfile.lock ファイルを確認し、FTMobileReactNativeSDK 依存関係が存在するか確認します。

FTMobileReactNativeSDK は、RN プロジェクトに Guance RN SDK を統合した後、iOS 側でインストールされる依存ライブラリです。

修正の推奨事項:

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

    • RN SDK とネイティブ SDK のバージョンが一致することを確認します
    • RN SDK に対応するネイティブ SDK のバージョン情報の確認パス:

    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
    

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

関連情報

フィードバック

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