開始使用UWP/WinUI

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

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

針對UWP專案：

您的專案是在Visual Studio 2017 Update 15.9或更新版本中設定。
您鎖定的裝置是執行 Windows 10 組建 16299 或更高版本的。
您的項目會參考通用 Windows 平臺 6.2.8 或更新版本（此套件通常隱含參考）。
NuGet 4.3 或更新版本。

針對 WinUI 專案：

您的專案是在Visual Studio 2019 Update 16.9或更新版本中設定。
您的目標是執行 Windows 10 組建 17763 或更新版本的裝置。
您的項目參考 WinUI 3 0.8.0 或更新版本。

備註

如果您想要使用適用於 UWP 的 Xamarin.Forms，請遵循 Xamarin 使用者入門檔，而不是此檔。

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

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

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

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

3.新增 App Center SDK 模組

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

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

既然您已在應用程式中整合 SDK，現在可以啟動 SDK 並使用 App Center 服務。

備註

如果您在可攜式專案中使用App Center SDK（例如 Xamarin.Forms），則必須在每個項目中安裝套件：可攜式、Android 和iOS 套件。若要這樣做，您應該開啟每個子專案，並遵循 Visual Studio 一節中所述的對應步驟。

4.新增 `Internet (Client)` 功能

在 Visual Studio 方案總管中，按兩下應用程式的 Package.appxmanifest 檔案。按兩下 [ 功能] 索引標籤，然後檢查 因特網（用戶端） 功能。

5.啟動 SDK

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

5.1 新增using指令

使用我們的 API 之前，請先新增適當的命名空間。

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

5.2 新增 `Start()` 方法

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

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)); 
}

5.3 用您的應用程式密鑰替換佔位符

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

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

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

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

太好了，您已準備好在 SDK 自動收集的門戶上進行數據分析視覺化。

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

共用方式為