從 HockeySDK 移轉至 App Center WPF/Winforms

  • 發行項

重要

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

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

如果您想要更新應用程式以使用 App Center SDK，而不是 HockeySDK，請遵循此檔。

1.更新連結庫

以解決方案中所有專案中的 App Center 套件取代 HockeySDK.WPF NuGet 套件。

適用於 Windows 的 Visual Studio

  • 開啟適用於 Windows 的 [Visual Studio]。
  • 按兩下 [檔案>開啟 ]，然後選擇您的解決方案。
  • 在方案導覽器中，以滑鼠右鍵按兩下 [ 參考] ，然後選擇 [ 管理 NuGet 套件]。
  • 拿掉 HockeySDK.WPF 套件。
  • 搜尋 App Center，並安裝 Microsoft.AppCenter.Analytics 和 Microsoft.AppCenter.Crashes 套件。

套件管理器主控台

  • 在 Visual Studio 中開啟控制台。 若要這樣做，請選擇 [工具>][NuGet 套件管理員>套件管理員控制台]。
  • 如果您正在 Visual Studio for Mac 工作，請確定您已安裝 NuGet 套件管理延伸模組。 針對此專案，請選擇 [Visual Studio>擴充功能]，視需要搜尋 NuGet 並安裝。
  • 在控制台中輸入下列命令：
Uninstall-Package HockeySDK.WPF
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

App Center SDK 使用模組化方法 – 您可以選擇要整合的服務。 您必須在本節中將每個 SDK 模組新增為個別的相依性。

2.更新 SDK 安裝程式碼

2.1 轉換應用程式識別碼

App Center SDK 使用全域唯一標識碼 (GUID) 格式的應用程式識別碼。 您的 HockeyApp 應用程式識別碼可由 App Center 使用，但您需要將其轉換成不同的格式。 若要轉換識別碼，您必須新增四個連字元來取得 8-4-4-4-12 表示。

(HockeyApp) 之前： 00112233445566778899aabbccddeeff

(App Center) 之後： 00112233-4455-6677-8899-aabbccddeeff

2.2 取代應用程式程式代碼中的 SDK 初始化

  1. 拿掉舊的 HockeyApp 註冊碼。 在語句宣告中 using ，移除下列這一行：

    using Microsoft.HockeyApp;

    在 App 類別建構函式的開頭，移除下列這一行：

    HockeyClient.Current.Configure("Your_App_ID");

  2. 啟動 App Center SDK。 使用我們的 API 之前，請先新增適當的命名空間。

    using Microsoft.AppCenter;
using Microsoft.AppCenter.Analytics;
using Microsoft.AppCenter.Crashes;

    將下列呼叫新增至應用程式的建構函式：

    AppCenter.Start("{Your App Secret}",  typeof(Analytics), typeof(Crashes));

3.服務和功能比較

核心

功能 HockeyApp App Center
調整記錄層級 Yes AppCenter.LogLevel

分析

功能 HockeyApp App Center
自動追蹤會話 Yes 會話和裝置資訊
具有屬性的自定義事件 HockeyClient.TrackEvent Analytics.TrackEvent

損毀

功能 HockeyApp App Center
自動傳送當機 預設啟用 當機報告
附加其他元數據 Yes 新增附件
追蹤已處理的例外狀況 HockeyClient.Current.TrackException 已處理的錯誤

發行版本

App Center SDK 尚不支援 WPF/Winforms 應用程式的散發。

意見反應服務

App Center 不支援意見反應服務。 請參閱 HockeyApp 意見反應。