その他の Android API

ログ レベルを調整する

LogCat に表示される App Center によるログ メッセージの量を制御できます。 デバッグ中に追加のログ記録を有効にするには、 AppCenter.setLogLevel() API を使用します。 ログ レベルは、 android.util.Logで定義されているレベルに対応します。 既定では、デバッグ不可能なアプリケーションの場合は ASSERT 、デバッグ可能なアプリケーションの場合は WARN に設定されます。 ログ レベルはいつでも設定できます。

ログ メッセージをできるだけ多くするには、 Log.Verboseを使用します。

AppCenter.setLogLevel(Log.VERBOSE);

AppCenter.setLogLevel(Log.VERBOSE)

インストールを識別する

アプリがインストールされると、App Center SDK によってデバイスごとに UUID が作成されます。 この識別子は、アプリが更新され、アプリが再インストールされたとき、またはユーザーがすべてのアプリ データを手動で削除した場合にのみ新しい識別子が生成される場合でも、デバイスに対して同じままです。 次の API は、デバッグの目的で役立ちます。

AppCenter.getInstallId();

AppCenter.getInstallId()

この API は非同期です。詳細については、 App Center の非同期 API ガイドを参照してください。

ユーザーの識別

App Center SDK では、クラッシュ レポートの拡張に使用される ユーザー ID の 設定がサポートされています。 この機能を使用するには:

1. App Center SDK の概要ガイドで説明されているように、 AppCenter.start(...) を呼び出して App Center SDK を構成します。
2. 次のコードを使用して、SDK で userID を設定します。

AppCenter.setUserId("your-user-id");

AppCenter.setUserId("your-user-id")

ユーザー ID を設定した後、App Center の検索機能を使用して、ID の特定のクラッシュ レポートを検索できます。 詳細については、App Center の 検索ドキュメントを参照してください。

実行時にすべてのサービスを無効にする

すべての App Center サービスを一度に無効にする場合は、 setEnabled() API を使用します。 無効にすると、SDK は App Center に情報を転送しません。

AppCenter.setEnabled(false);

AppCenter.setEnabled(false)

すべてのサービスを一度に有効にするには、同じ API を使用しますが、パラメーターとして true を渡します。

AppCenter.setEnabled(true);

AppCenter.setEnabled(true)

状態は、アプリケーションの起動間でデバイスのストレージに保持されます。

この API は非同期です。詳細については、 App Center の非同期 API ガイドを参照してください。

ネットワーク要求を許可しない

App Center SDK では、ネットワーク要求は既定で許可されます。 ユーザーの懸念事項によって App Center SDK によって収集されるデータを送信する場合は、データの自動送信を禁止できます。

AppCenter.setNetworkRequestsAllowed(false);

AppCenter.setNetworkRequestsAllowed(false)

この場合、App Center SDK は引き続きデータを収集しますが、ネットワーク要求が許可されるときにのみ送信されます。

AppCenter.setNetworkRequestsAllowed(true);

AppCenter.setNetworkRequestsAllowed(true)

App Center SDK でのデータの送信が許可されているかどうかをいつでも確認できます。

AppCenter.isNetworkRequestsAllowed();

AppCenter.isNetworkRequestsAllowed()

実行時のサービスの状態を変更する

次のコードを使用して、ランタイムでサービスを有効または無効にします。

Analytics.setEnabled(false);

Analytics.setEnabled(false)

App Center が有効になっているかどうかを確認する

App Center が有効になっているかどうかを確認することもできます。

AppCenter.isEnabled();

AppCenter.isEnabled()

この API は非同期です。詳細については、 App Center の非同期 API ガイドを参照してください。

実行時に App Center SDK のバージョンを確認する

現在使用している App Center SDK のバージョンを取得できます。

AppCenter.getSdkVersion();

AppCenter.getSdkVersion()

ストレージ サイズ

App Center SDK を使用する場合、ログはデバイスにローカルに格納されます。 大きなログでは大量の領域を占有する可能性があるため、ローカル データベースのサイズを制限することもできます。 また、 pause API や resume API と組み合わせて使用することもできます。 長時間一時停止することが予想される場合は、より大きなデータベース サイズを使用して、より多くのイベントを格納できます。

setMaxStorageSize API を使用して、ローカル DB のサイズを設定できます。 API は非同期であり、App Center サービスを開始するとコールバックが呼び出されます。 このため、setMaxStorageSizeを呼び出す前に、AppCenter.start(...)を呼び出す必要があります。 API を呼び出すのは 1 回だけです。

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024L).thenAccept(new AppCenterConsumer<Boolean>() {

    @Override
    public void accept(Boolean success) {
        // The success parameter is false when the size can't be honored.
    }
});
AppCenter.start("{Your App Secret}", Analytics.class);

// Use 20 MB for storage.
AppCenter.setMaxStorageSize(20 * 1024 * 1024).thenAccept {
    // The success parameter (it) is false when the size can't be honored.
}

AppCenter.start(application, "{Your App Secret}", Analytics::class.java)

最大ストレージ サイズを設定しない場合、SDK は既定の最大サイズ 10 MB を使用します。 設定できる最小サイズは 20 KB です。

配布ストアを追加する

既定では、アプリ内更新は、定義済みのストアの一覧からインストールされたアプリに対して機能します。 定義済みのストアの一覧に含まれていないストア経由でアプリケーションを配布する場合は、App Center を起動する前に、以下の API を使用して必要なパッケージ インストーラーを追加できます。

    Set<String> stores = new HashSet<String>();
    stores.add("com.store1.packageinstaller");
    stores.add("com.store2.packageinstaller");
    Distribute.addStores(stores);

失敗した API 呼び出し

コールバックが失敗する理由は多数あります。

• 指定されたサイズが無効な値です (20 KB 未満または 140 TB を超えています)。
• 現在のデータベース サイズが、指定した最大サイズを超えています。
• API は既に呼び出されています。 プロセスごとに 1 回だけ構成できます。
• API は、 AppCenter.start(...)後に呼び出されました。

AppCenter ログ タグを使用してコンソールで警告とエラーを確認し、構成の問題をトラブルシューティングできます。

Android SDK の非同期 API

非同期 API は、結果を直接返すのではなく、 AppCenterFuture オブジェクトを返します。

将来のオブジェクトの get() を呼び出して結果を同期的に待機するか、次のようなコールバックを提供して、API を呼び出すときにそれぞれの戻り値の型を入力することができます。

AppCenterFuture<{ReturnType}> future = {AnyAsyncApi}();
future.thenAccept(new AppCenterConsumer<{ReturnType}>() {

    @Override
    public void accept({ReturnType} result) {

        // do something with result, this is called back in UI thread.
    }
});

val future = {AnyAsyncApi}()
future.thenAccept(object : AppCenterConsumer<{ReturnType}> {
    override fun accept(t: {ReturnType}?) {
        // do something with result, this is called back in UI thread.
    }
})

アプリケーションの速度低下の原因となる UI スレッドがブロックされないようにするには、コールバックで常に thenAccept を使用することを検討してください。

ワーカー スレッドでは、 {AnyAsyncApi}().get()を呼び出すことができます。

コールバックの例:

AppCenter.isEnabled().thenAccept(new AppCenterConsumer<Boolean>() {

    @Override
    public void accept(Boolean enabled) {
        Log.d("MyApp", "AppCenter.isEnabled=" + enabled);
    }
});

AppCenter.isEnabled().thenAccept { enabled -> 
    Log.d("MyApp", "AppCenter.isEnabled=$enabled")
}

同期の例:

boolean enabled = AppCenter.isEnabled().get();

val enabled = AppCenter.isEnabled().get()