其他MAUI和 Xamarin API

重要

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

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

調整記錄層級

您可以控制控制台中從 App Center 顯示的記錄訊息數量。 LogLevel使用 -API 在偵錯時啟用其他記錄。 根據預設,它會針對 App Store 環境設定為 ASSERTWARN否則會設定為 。

若要盡可能有多個記錄訊息,請使用 LogLevel.Verbose

AppCenter.LogLevel = LogLevel.Verbose;

識別安裝

App Center SDK 會在安裝應用程式之後,為每個裝置建立 UUID。 當應用程式更新時,裝置的這個標識碼會維持不變,而且只有在重新安裝應用程式時才會產生新的標識符。 下列 API 適用於偵錯用途。

System.Guid? installId = await AppCenter.GetInstallIdAsync();

注意

在Android上,這個方法只能在啟動之後 AppCenter 使用,它一律會在開始之前傳回 null

識別使用者

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

  1. 快速入門指南中所述,呼叫 AppCenter.Start(...) 來設定App Center SDK。
  2. userID使用下列程式代碼在 SDK 中設定 :
AppCenter.SetUserId("your-user-id");

設定使用者標識碼之後,您可以使用 App Center 的搜尋功能來搜尋標識碼的特定損毀報告。 在 App Center 的 搜尋檔中深入瞭解。

注意

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

停用運行時間的所有服務

如果您想要一次停用所有 App Center 服務,請使用 Enabled 屬性。 停用時,SDK 不會將任何信息轉送至 App Center。

AppCenter.SetEnabledAsync(false);

若要再次啟用所有服務,請使用相同的 API,但傳遞 true 為參數。

AppCenter.SetEnabledAsync(true);

您不需要等候此呼叫,才能 (進行其他 API 呼叫,例如 IsEnabledAsync) 一致。

狀態會保存在應用程式啟動的裝置記憶體中。

注意

只有在啟動之後 AppCenter ,才能使用這個方法。

不允許網路要求

在 App Center SDK 中,預設允許網路要求。 如果您想要傳送 App Center SDK 由使用者所收集的數據,您可以不允許自動傳送資料。

AppCenter.IsNetworkRequestsAllowed = false;

在此情況下,App Center SDK 會繼續收集數據,但只有在允許網路要求時才會傳送。

AppCenter.IsNetworkRequestsAllowed = true;

注意

此值會在開始之間保留。

您可以隨時檢查是否允許在 App Center SDK 中傳送數據。

AppCenter.IsNetworkRequestsAllowed;

注意

在 Android 平台上啟動之前AppCenter,會忽略先前儲存在中的SharedPreferences值。 它會使用 AppCenter.IsNetworkRequestsAllowed = allowedtrue 如果值在 AppCenter 開始之前未變更,則會傳回最後一個設定的值。

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

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

Analytics.SetEnabledAsync(true);

注意

只有在啟動之後 Analytics ,才能使用這個方法。

檢查 App Center 是否已啟用

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

bool enabled = await AppCenter.IsEnabledAsync();

注意

這個方法只能在啟動之後 AppCenter 使用,它一律會在 start 之前傳回 false

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

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

AppCenter.SdkVersion;