Wprowadzenie do platformy WPF/WinForms

Ważne

Program Visual Studio App Center ma zostać wycofany 31 marca 2025 r. Chociaż możesz nadal używać programu Visual Studio App Center do momentu jego pełnego wycofania, istnieje kilka zalecanych alternatyw, do których można rozważyć migrację.

Dowiedz się więcej o osiach czasu pomocy technicznej i alternatywach.

• Android
• iOS
• Rozszerzenia systemu iOS
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• Rozszerzenia systemu macOS
• tvOS
• Cordova

Zestaw SDK centrum aplikacji korzysta z architektury modułowej, dzięki czemu można używać dowolnych lub wszystkich usług.

Zacznijmy od konfigurowania zestawu SDK centrum aplikacji w aplikacji w celu używania analizy centrum aplikacji i awarii centrum aplikacji.

1. Wymagania wstępne

Przed rozpoczęciem upewnij się, że zostały spełnione następujące wymagania wstępne:

• Projekt jest przeznaczony dla .NET Framework 4.6.2 (lub nowszej) lub .NET Core 3.1 (lub nowszej).
• Platforma .NET Core jest obsługiwana tylko wtedy, gdy aplikacja WPF/WinForms działa w systemie Windows.
• Jeśli używasz zestawu SDK z biblioteki przenośnej, musi być przeznaczony dla platformy .NET Standard 2.0 lub nowszej (PCL nie jest obsługiwany).
• Typ projektu PackageReference. To wymaganie pochodzi z SQLitePCL.raw biblioteki. Więcej informacji można znaleźć na stronie https://github.com/ericsink/SQLitePCL.raw/issues/537.
• Podczas integrowania zestawu SDK z projektami VSTO występuje znany problem. Więcej informacji można znaleźć na stronie https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

2. Tworzenie aplikacji w portalu Centrum aplikacji w celu uzyskania wpisu tajnego aplikacji

Jeśli aplikacja została już utworzona w portalu Centrum aplikacji, możesz pominąć ten krok.

1. Zarejestruj się lub zaloguj się i naciśnij niebieski przycisk w prawym górnym rogu portalu z komunikatem Dodaj nową i wybierz pozycję Dodaj nową aplikację z menu rozwijanego.
2. Wprowadź nazwę i opcjonalny opis aplikacji.
3. Wybierz odpowiedni system operacyjny i platformę w zależności od projektu zgodnie z powyższym opisem.
4. Naciśnij przycisk w prawym dolnym rogu z komunikatem Dodaj nową aplikację.

Po utworzeniu aplikacji możesz uzyskać jej klucz tajny aplikacji na stronie Ustawienia w portalu Centrum aplikacji. W prawym górnym rogu strony Ustawienia kliknij potrójne pionowe kropki i wybierz pozycję Copy app secret , aby uzyskać wpis tajny aplikacji.

3. Dodawanie modułów zestawu SDK centrum aplikacji

Zestaw SDK centrum aplikacji można zintegrować przy użyciu programu Visual Studio lub konsoli menedżera pakietów.

Uwaga

Zestaw SDK usługi App Center używa zestawów o silnych nazwach w celu zapewnienia zgodności z aplikacjami, które używają znaku o silnych nazwach.

Visual Studio

• Otwórz program Visual Studio.
• Kliknij pozycję Plik>Otwórz i wybierz rozwiązanie.
• W nawigatorze rozwiązań kliknij prawym przyciskiem myszy pozycję Odwołania i wybierz polecenie Zarządzaj pakietami NuGet.
• Na karcie Przeglądaj wyszukaj pozycję App Center i zainstaluj pakiety Microsoft.AppCenter.Analytics i Microsoft.AppCenter.Crash .

Konsola menedżera pakietów

• Otwórz konsolę programu Visual Studio. W tym celu wybierz pozycję Narzędzia>Konsola menedżera pakietówNuGet Package Manager>.
• Wpisz następujące polecenia:

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

Uwaga

Jeśli używasz zestawu SDK centrum aplikacji w projekcie przenośnym, musisz zainstalować pakiety w każdym z projektów: przenośnego i projektu, w którym jest uruchomiona aplikacja WPF/WinForms. W tym celu należy otworzyć każdy podprojekt i wykonać odpowiednie kroki opisane w sekcji Visual Studio .

4. Uruchamianie zestawu SDK

Aby użyć centrum aplikacji, wybierz moduły, których chcesz użyć. Domyślnie nie są uruchamiane żadne moduły i podczas uruchamiania zestawu SDK należy jawnie wywołać każdą z nich.

4.1 Dodawanie Start() metody

WPF

W przypadku aplikacji WPF zmodyfikuj i App.xaml.cs dodaj następujące instrukcje using:

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

Następnie w tym samym pliku dodaj następujący kod w metodzie OnStartup :

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

App.xaml.cs Jeśli plik nie ma OnStartup metody , możesz dodać metodę Application.OnStartup(StartupEventArgs) . Plik App.xaml.cs powinien wyglądać następująco:

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

Ostrzeżenie

Nie zaleca się osadzania wpisu tajnego aplikacji w kodzie źródłowym.

Jeśli musisz uruchomić usługi App Center oddzielnie, wykonaj następujące kroki:

1. Skonfiguruj lub uruchom go za pomocą wpisu tajnego aplikacji.
2. Jeśli kod może być wywoływany wiele razy, sprawdź, czy centrum aplikacji jest już skonfigurowane.
3. Uruchom wymagane usługi bez wpisu tajnego aplikacji.

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

WinForms

W przypadku aplikacji WinForms zmodyfikuj Program.cs plik i dodaj następujące instrukcje using:

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

Następnie w tym samym pliku dodaj następujący kod w metodzie Main przed instrukcją Application.Run .

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

Jeśli musisz uruchomić usługi App Center oddzielnie, wykonaj następujące kroki:

1. Skonfiguruj lub uruchom go za pomocą wpisu tajnego aplikacji.
2. Jeśli kod może być wywoływany wiele razy, sprawdź, czy centrum aplikacji jest już skonfigurowane.
3. Uruchom wymagane usługi bez wpisu tajnego aplikacji.

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

Ostrzeżenie

Nie zaleca się osadzania wpisu tajnego aplikacji w kodzie źródłowym.

4.2 Zastąp symbol zastępczy wpisem tajnym aplikacji

Pamiętaj, aby zastąpić {Your App Secret} tekst rzeczywistą wartością aplikacji. Wpis tajny aplikacji można znaleźć na stronie Wprowadzenie lub stronie Ustawienia w portalu Centrum aplikacji.

Strona Wprowadzenie zawiera powyższy przykładowy kod z wpisem tajnym aplikacji. Możesz skopiować i wkleić cały przykład.

W powyższym przykładzie Start() pokazano, jak używać metody i uwzględniać usługę App Center Analytics.

Jeśli nie określisz jawnie każdej usługi jako parametrów w metodzie uruchamiania, nie możesz użyć tej usługi Centrum aplikacji. Ponadto Start() interfejs API może być używany tylko raz w cyklu życia aplikacji — wszystkie inne wywołania będą rejestrować ostrzeżenie do konsoli, a tylko usługi zawarte w pierwszym wywołaniu będą dostępne.

Świetnie— wszystko jest gotowe do wizualizacji awarii w portalu, które zestaw SDK zbiera automatycznie.

Zapoznaj się z dokumentacją dotyczącą awarii usług App Center Analytics i App Center , aby dowiedzieć się, jak dostosowywać i korzystać z bardziej zaawansowanych funkcji obu usług.