其他 React Native API

重要

Visual Studio App Center 已排定於 2025 年 3 月 31 日淘汰。 雖然您可以繼續使用 Visual Studio App Center，直到它完全淘汰為止，但有數個建議您考慮移轉至的建議替代方案。

深入瞭解支持時程表和替代方案。

• Android
• iOS
• React Native \(英文\)
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• tvOS
• Cordova

調整記錄層級

您可以控制從 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];專案 AppDelegate.m 中任何[AppCenterReactNative register];呼叫 (或 AppCenterReactNativeAnalytics 或 或 AppCenterReactNativeCrashes 或 或) AppCenterReactNativePush 。 如果檔案中遺漏，您必須新增 @import AppCenter; 。

在Android中，在回呼中MainApplication.javaonCreate呼叫 AppCenter.setLogLevel(android.util.Log.VERBOSE); 之前SoLoader.init。

識別安裝

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 中的值。 它會使用 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();