開始使用 WPF/WinForms

2025-05-05

這很重要

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

App Center SDK 使用模組化架構，因此您可以使用任何或所有服務。

讓我們開始在應用程式中設定 App Center SDK，以使用 App Center 分析與 App Center 當機。

1.Prerequisites

開始之前，請確定您已符合下列必要條件：

您的專案是以 .NET Framework 4.6.2 （或更新版本）或 .NET Core 3.1 或更新版本為目標。
只有在 WPF/WinForms 應用程式在 Windows 上執行時，才支援 .NET Core。
如果您使用可攜式連結庫的 SDK，它必須以 .NET 標準 2.0 或更高版本為目標（不支援 PCL）。
PackageReference 項目類型。這項需求來自 SQLitePCL.raw 函式庫。如需詳細資訊，請在 https://github.com/ericsink/SQLitePCL.raw/issues/537。
將 SDK 整合到 VSTO 項目時發生已知問題。如需詳細資訊，請造訪 https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/。

2.在 App Center 入口網站中建立您的應用程式，以取得應用程式秘密

如果您已在 App Center 入口網站中建立應用程式，您可以略過此步驟。

註冊或登入，並按入口網站右上角的藍色按鈕，顯示 [ 新增 ]，然後從下拉功能表中選取 [ 新增應用程式 ]。
輸入應用程式的名稱和選擇性描述。
根據您的項目選取適當的OS和平臺，如上所述。
按兩下右下角按鈕，顯示 [新增應用程式]。

建立應用程式之後，您可以在 App Center 入口網站的 [設定] 頁面上取得其應用程式秘密。在 [ 設定 ] 頁面右上角，按兩下 三個垂直點 ，然後選取 Copy app secret 以取得您的應用程式秘密。

3.新增 App Center SDK 模組

App Center SDK 可以使用 Visual Studio 或套件管理員控制台進行整合。

備註

App Center SDK 使用強名稱元件來與使用強名稱符號的應用程式相容。

Visual Studio

開啟 Visual Studio。
按兩下 [ 檔案>開啟 ]，然後選擇您的解決方案。
在方案導覽器中，以滑鼠右鍵按兩下 [ 參考 ]，然後選擇 [ 管理 NuGet 套件]。
在 [ 流覽] 索引標籤中，搜尋 App Center，並安裝 Microsoft.AppCenter.Analytics 和 Microsoft.AppCenter.Crashes 套件。

套件管理員主控台

在 Visual Studio 中開啟控制台。若要這樣做，請選擇 [工具>][NuGet 套件管理員>套件管理員控制台]。
輸入下列命令：

Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

備註

如果您在可攜式專案中使用App Center SDK，則必須在每個專案中安裝套件：可攜式，以及執行 WPF/WinForms 應用程式的專案。若要這樣做，您應該開啟每個子專案，並遵循 Visual Studio 一節中所述的對應步驟。

4.啟動 SDK

若要使用 App Center，請加入您想要使用的模組。根據預設，不會啟動任何模組，而且您必須在啟動 SDK 時明確呼叫每個模組。

4.1 新增 `Start()` 方法

WPF（Windows Presentation Foundation）

針對 WPF 應用程式，修改 App.xaml.cs 並新增下列 using 語句：

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

然後在相同的檔案中，在OnStartup方法中新增下列程式碼：

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

App.xaml.cs如果檔案沒有 OnStartup 方法，您可以新增 Application.OnStartup(StartupEventArgs) 方法。您的 App.xaml.cs 檔案看起來應該像這樣：

public partial class App : Application
{
    protected override void OnStartup(StartupEventArgs e)
    {
      base.OnStartup(e);
      AppCenter.Start("{Your App Secret}", typeof(Analytics), typeof(Crashes));
    }
  }
}

警告

不建議在原始碼中內嵌您的應用程式秘密。

如果您需要個別啟動 App Center 服務，您應該：

使用應用程式密碼來設定或啟動它。
如果可以多次呼叫程式代碼，請檢查是否已設定App Center。
在沒有應用程式秘密的情況下啟動必要的服務。

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

WinForms

針對您的 WinForms 應用程式，修改 Program.cs 檔案並新增以下 using 語句：

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

然後在相同的檔案中，在 Main 方法中於 Application.Run 語句之前新增以下代碼。

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

如果您需要個別啟動 App Center 服務，您應該：

使用應用程式密碼來設定或啟動它。
如果可以多次呼叫程式代碼，請檢查是否已設定App Center。
在沒有應用程式秘密的情況下啟動必要的服務。

AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

警告

不建議在原始碼中內嵌您的應用程式秘密。

4.2 將佔位符取代為您的應用程式密鑰

請務必將 {Your App Secret} 替換為應用程式中的實際值。您可以在 App Center 入口網站的 [ 使用者入門 ] 頁面或 [ 設定 ] 頁面上找到應用程式密碼。

[用戶入門] 頁面包含上述程式碼範例，其中包含您的應用程式秘密，您可以複製並貼上整個範例。

上述範例示範如何使用 Start() 方法，並包含App Center Analytics。

除非您在 start 方法中明確指定每個服務做為參數，否則您無法使用該 App Center 服務。此外， Start() API 只能在應用程式的生命週期中使用一次– 所有其他呼叫都會將警告記錄至主控台，且只會使用第一次呼叫中包含的服務。

太好了，您已準備好查看 SDK 自動收集的當機數據在網站上的情況。

查看 App Center 分析與 App Center 當機的檔，瞭解如何自定義和使用這兩個服務更進階的功能。

共用方式為