共用方式為


開始使用UWP/WinUI

重要

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

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

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

讓我們開始在應用程式中設定 App Center SDK,以使用 App Center Analytics 和 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 入口網站中建立應用程式,您可以略過此步驟。

  1. 註冊或登入並叫用入口網站右上角的藍色按鈕,指出 [ 新增 ],然後從下拉功能表中選取 [ 新增應用程式 ]。
  2. 輸入應用程式的名稱和選擇性描述。
  3. 視您的專案而定,選取適當的OS和平臺,如上所述。
  4. 按兩下角按鈕指出 [新增應用程式]。

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

3.新增 App Center SDK 模組

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

Visual Studio

  • 開啟 Visual Studio。
  • 按兩下[檔案>開啟],然後選擇您的解決方案。
  • 在解決方案導覽器中,以滑鼠右鍵按兩下 [ 參考 ],然後選擇 [ 管理 NuGet 套件]。
  • 在 [ 流覽] 索引標籤中,搜尋 App Center,並安裝 Microsoft.AppCenter.AnalyticsMicrosoft.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 服務,您應該:

  1. 使用應用程式密碼進行設定或啟動。
  2. 如果可以多次呼叫程式代碼,請檢查App Center是否已設定。
  3. 在沒有應用程式密碼的情況下,啟動必要的服務 (s) 。
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 AnalyticsApp Center 當機 的檔,瞭解如何自定義和使用這兩項服務的更進階功能。