使用 WPF/WinForms 開始

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

讓我們開始在您的應用程式中設定 App Center SDK,以使用 App Center 分析和 App Center 損毀。

1.Prerequisites

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

  • 您的專案的目標是 .NET Framework 4.6.1 (或更高的) 或 .NET Core 3.0 (或更高的) 。
  • 只有當 WPF/WinForms 應用程式在 Windows 上執行時,才支援 .NET Core。
  • 如果您使用來自便攜程式庫的 SDK,則必須將目標設為 .NET standard 1.0 或更高版本,) 不支援 (PCL。

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

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

  1. 註冊或登入,然後按下入口網站右上角的藍色按鈕,其中顯示 [ 新增 ],然後從下拉式功能表中選取 [新增 應用程式 ]。
  2. 輸入應用程式的名稱和選擇性描述。
  3. 根據您的專案,選取適當的作業系統和平臺,如上所述。
  4. 按一下右下方的按鈕,以顯示 [ 新增應用程式]。

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

3. 新增 App Center SDK 模組

App Center SDK 可以使用 Visual Studio 或封裝管理員主控台來整合。

注意

App Center SDK 使用 強式名稱的元件 ,與使用強式名稱簽署的應用程式相容。

Visual Studio

  • 開啟 Visual Studio。
  • 按一下 > [開啟 檔案],然後選擇您的方案。
  • 在解決方案導覽器中,以滑鼠右鍵按一下 [ 參考 ],然後選擇 [ 管理 NuGet 套件]。
  • 在 [ 流覽] 索引標籤中,搜尋 App Center,然後安裝 AppCenterAppCenter。 損毀套件。

套件管理器主控台

  • Visual Studio中開啟主控台。 若要這樣做,請選擇 [工具] > NuGet 封裝管理員 > 封裝管理員主控台
  • 輸入下列命令:
Install-Package Microsoft.AppCenter.Analytics
Install-Package Microsoft.AppCenter.Crashes

注意

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

5. 啟動 SDK

若要使用 App Center,請選擇您想要使用的模組 (s) 。 依預設,不會啟動任何模組,而且您必須在啟動 SDK 時明確地呼叫每個模組。

5.1 新增 Start() 方法

WPF

針對您的 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 服務,您應該:

  1. 使用應用程式秘密設定或啟動它。
  2. 如果可以多次呼叫程式碼,請檢查是否已設定 App Center。
  3. 啟動必要的服務 (s) ,而不需要應用程式密碼。
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 服務,您應該:

  1. 使用應用程式秘密設定或啟動它。
  2. 如果可以多次呼叫程式碼,請檢查是否已設定 App Center。
  3. 啟動必要的服務 (s) ,而不需要應用程式密碼。
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5.2 將預留位置取代為您的應用程式密碼

請務必將文字取代為 {Your App Secret} 應用程式的實際值。 應用程式秘密可在 App Center 入口網站的 [ 開始使用 ] 頁面或 [ 設定 ] 頁面上找到。

開始使用頁面包含上述的程式碼範例,其中包含您的應用程式秘密,您可以複製並貼上整個範例。

上述範例顯示如何使用 Start() 方法,並包含 App Center 分析。

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

很棒的是,您全都是在 SDK 自動收集的入口網站上將損毀視覺化。

查看 App Center 分析app center 損毀的檔,以瞭解如何自訂和使用兩項服務的更先進功能。