その他のReact Native API
重要
Visual Studio App Center は、2025 年 3 月 31 日に廃止される予定です。 完全に廃止されるまで Visual Studio App Center を引き続き使用できますが、移行を検討できる推奨される代替手段がいくつかあります。
ログ レベルを調整する
App Center から表示されるログ メッセージの量を制御できます。 ログ メッセージは、iOS のコンソールと Android の LogCat に表示されます。 API を setLogLevel
使用して、デバッグ中に追加のログ記録を有効にします。 既定のレベルは、LogLevel.ASSERT
iOS App Store環境と Android リリース ビルド用です。 それ以外の場合は、 に LogLevel.WARNING
設定されます。
すべてのログ メッセージを出力するには、 を使用します LogLevel.VERBOSE
。
import AppCenter from 'appcenter';
await AppCenter.setLogLevel(AppCenter.LogLevel.VERBOSE);
注意
JavaScript API では、JavaScript setLogLevel
が読み込まれる前に、アプリのスタートアップ コードのログ記録を増やすことはできません。
アプリの起動のログ記録を増やす場合は、ネイティブの App Center setLogLevel API を使用します。
iOS では、プロジェクトの AppDelegate.m で (または AppCenterReactNativeAnalytics
または AppCenterReactNativeCrashes
AppCenterReactNativePush
) を[AppCenterReactNative register];
呼び出す前に を呼び出[MSACAppCenter setLogLevel: MSACLogLevelVerbose];
します。 そのファイルに存在しない場合は、 を追加 @import AppCenter;
する必要があります。
Android では、 のコールバックで の前をSoLoader.init
onCreate
MainApplication.java
呼び出します。AppCenter.setLogLevel(android.util.Log.VERBOSE);
インストールを特定する
アプリがインストールされると、App Center SDK によってデバイスごとに UUID が作成されます。 アプリが更新され、新しい識別子が生成されるのは、アプリが再インストールされたとき、またはユーザーが Android 上のすべてのアプリ データを手動で削除した場合に限られます。 次の API は、デバッグの目的で役立ちます。
import AppCenter from 'appcenter';
const installId = await AppCenter.getInstallId(); // Returned as a string
ユーザーの識別
App Center SDK では、クラッシュ レポートの拡張に使用される ユーザー ID の 設定がサポートされています。 この機能を使用するには:
- App Center SDK の概要ガイドの説明に従って 、App Center SDK を構成します。
userID
次のコードを使用して、SDK で を設定します。
AppCenter.setUserId("your-user-id");
ユーザー ID を設定した後、App Center の検索機能を使用して、ID の特定のクラッシュ レポートを検索できます。 詳細については、App Center の 検索ドキュメントを参照してください。
注意
ユーザー ID の値は 256 文字に制限されています。 クラッシュ レポートと共に表示されますが、影響を受けるユーザーの集計やカウントには使用されません。 ユーザー ID を複数回設定した場合は、最後のユーザー ID のみが使用されます。 この値は起動の間に SDK によって格納されないため、各アプリケーションの起動前にユーザー ID を自分で設定する必要があります。
実行時にすべてのサービスを無効にする
すべての App Center サービスを一度に無効にする場合は、API を使用します setEnabled()
。 無効にすると、SDK は App Center に情報を転送しません。
import AppCenter from 'appcenter';
await AppCenter.setEnabled(false);
すべてのサービスを一度に有効にするには、同じ API を使用しますが、 パラメーターとして を渡 true
します。
await AppCenter.setEnabled(true);
状態は、アプリケーションの起動間でデバイスのストレージに保持されます。
ネットワーク要求を禁止する
App Center SDK では、ネットワーク要求は既定で許可されます。 App Center SDK がユーザーの懸念によって収集したデータを送信する場合は、データの自動送信を禁止できます。
await AppCenter.setNetworkRequestsAllowed(false);
この場合、App Center SDK は引き続きデータを収集しますが、ネットワーク要求が許可される場合にのみ送信されます。
await AppCenter.setNetworkRequestsAllowed(true);
注意
この値は、開始間も保持されます。
App Center SDK でのデータの送信が許可されているかどうかをいつでもチェックできます。
await AppCenter.isNetworkRequestsAllowed();
注意
SharedPreferences に保存された値は、Android プラットフォームでが開始されるまで AppCenter
無視されます。
を使用して setNetworkRequestsAllowed
、または true
AppCenter の開始前に値が変更されなかった場合に、最後に設定された値が返されます。
実行時のサービスの状態を変更する
次のコードを使用して、実行時にサービスを有効または無効にすることができます。
await AppCenter.Analytics.setEnabled(false);
App Center が有効になっているかどうかを確認する
App Center が有効になっているかどうかをチェックすることもできます。
const enabled = await AppCenter.isEnabled();
実行時に App Center SDK のバージョンを確認する
現在使用している App Center SDK のバージョンを取得できます。
AppCenter.getSdkVersion();