共用方式為

其他 React 原生 API

這很重要

Visual Studio App Center 於 2025 年 3 月 31 日淘汰，但分析和診斷功能除外，這些功能將持續支援到 2026 年 6 月 30 日。 瞭解更多資訊。

調整記錄層級

您可以控制從 App Center 顯示的記錄訊息數量。 iOS 上的控制台和 Android 上的 LogCat 中顯示的記錄訊息。 使用setLogLevel API 在偵錯過程中啟用額外的日誌記錄。 默認層級適用於 LogLevel.ASSERT iOS App Store 環境和 Android 發行組建。 否則，它會設定為 LogLevel.WARNING。

若要輸出所有記錄訊息，請使用 LogLevel.VERBOSE。

import AppCenter from 'appcenter';

await AppCenter.setLogLevel(AppCenter.LogLevel.VERBOSE);

備註

在載入 JavaScript 之前，JavaScript setLogLevel API 無法增加應用程式啟動程式代碼的記錄。

如果您想要增加應用程式啟動的記錄，請使用原生 App Center setLogLevel API。

在 iOS 中，應在專案 [MSACAppCenter setLogLevel: MSACLogLevelVerbose]; 中的任何呼叫 [AppCenterReactNative register]; （或 AppCenterReactNativeAnalytics、AppCenterReactNativeCrashes 或 AppCenterReactNativePush）之前呼叫 。 如果檔案中遺漏，您必須新增 @import AppCenter; 。

在 Android 中的 AppCenter.setLogLevel(android.util.Log.VERBOSE); 回呼中，應在 SoLoader.init 之前呼叫 onCreateMainApplication.java。

識別裝置

App Center SDK 會在安裝應用程式之後，為每個裝置建立 UUID。 更新應用程式時，裝置的這個標識碼會維持不變，而且只有在重新安裝應用程式或使用者手動刪除 Android 上的所有應用程式數據時，才會產生新的識別碼。 下列 API 適用於偵錯目的。

import AppCenter from 'appcenter';

const installId = await AppCenter.getInstallId();   // Returned as a string

找出使用者

App Center SDK 支援設定用來增強當機報告 的使用者標識碼 。 若要使用這項功能：

  1. 如 App Center SDK 使用者入門指南中所述，設定 App Center SDK。
  2. userID使用下列程式代碼在 SDK 中設定 ：
AppCenter.setUserId("your-user-id");

設定使用者標識碼之後，您可以使用 App Center 的搜尋功能來搜尋標識碼的特定當機報告。 在 App Center 的 搜尋文件中了解更多。

備註

用戶標識碼的值限製為 256 個字元。 它會與您的當機報告一起顯示，但不會用於匯總或受影響使用者的計數。 如果您多次設定使用者標識碼，則只會使用最後一個使用者識別碼。 您必須在每次啟動應用程式之前自行設定使用者標識碼，因為 SDK 不會在啟動之間儲存此值。

在運行時間停用所有服務

如果您想要一次停用所有 App Center 服務，請使用 setEnabled() API。 停用時，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();

備註

在 Android 平台上啟動 AppCenter 之前，儲存在 SharedPreferences 中的值會被忽略。 ** 如果在 AppCenter 启动之前值没有更动，它会返回使用 setNetworkRequestsAllowed 或 true 所设定的最后一个值。

變更運行時間中的服務狀態

您可以使用下列程式代碼在執行時間開啟或停用服務：

await AppCenter.Analytics.setEnabled(false);

檢查 App Center 是否已啟用

您也可以檢查 App Center 是否已啟用。

const enabled = await AppCenter.isEnabled();

在運行時間檢查 App Center SDK 版本

您可以取得您目前使用的 App Center SDK 版本。

AppCenter.getSdkVersion();
  • Last updated on