Wprowadzenie do platformy WPF/WinForms

2025-05-05

Ważne

Program Visual Studio App Center został wycofany 31 marca 2025 r. z wyjątkiem funkcji analizy i diagnostyki, które będą nadal obsługiwane do 30 czerwca 2026 r. Dowiedz się więcej.

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

Zacznijmy od skonfigurowania zestawu SDK App Center w Twojej aplikacji, aby korzystać z funkcji App Center Analytics i App Center Crashes.

1. Wymagania wstępne

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

Projekt jest przeznaczony dla platformy .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ługiwana).
Typ projektu PackageReference. To wymaganie pochodzi z SQLitePCL.raw biblioteki. Więcej informacji znajduje się na stronie https://github.com/ericsink/SQLitePCL.raw/issues/537.
Podczas integrowania zestawu SDK z projektami VSTO występuje znany problem. Aby uzyskać więcej informacji, odwiedź stronę https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

2. Utwórz swoją aplikację w Centrum aplikacji Portalu, aby uzyskać tajny klucz aplikacji.

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

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.
Wprowadź nazwę i opcjonalny opis aplikacji.
Wybierz odpowiedni system operacyjny i platformę w zależności od projektu zgodnie z powyższym opisem.
Naciśnij przycisk w prawym dolnym rogu z napisem Dodaj nową aplikację.

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

3. Dodawanie modułów zestawu SDK usługi App Center

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

Uwaga / Notatka

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

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ę w programie Visual Studio. W tym celu wybierz pozycję Narzędzia>Konsola menedżera pakietów>.
Wpisz następujące polecenia:

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

Uwaga / Notatka

Jeśli używasz zestawu SDK centrum aplikacji w projekcie przenośnym, musisz zainstalować pakiety w każdym projekcie: przenośnym i projekcie z uruchomioną aplikacją WPF/WinForms. W tym celu należy otworzyć każdy podprojekt i wykonać odpowiednie kroki opisane w sekcji Programu 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żde z nich.

4.1 Dodawanie `Start()` metody

WPF (Windows Presentation Foundation)

W przypadku aplikacji WPF, zmodyfikuj App.xaml.cs 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 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ę umieszczać tajnego klucza aplikacji w kodzie źródłowym.

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

Skonfiguruj lub uruchom go przy użyciu klucza tajnego aplikacji.
Jeśli kod może być wywoływany wiele razy, sprawdź, czy centrum aplikacji jest już skonfigurowane.
Uruchom wymagane usługi bez sekretu aplikacji.

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

Formularze WinForms

W aplikacji WinForms zmodyfikuj plik Program.cs i dodaj następujące dyrektywy 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:

Skonfiguruj lub uruchom go przy użyciu klucza tajnego aplikacji.
Jeśli kod może być wywoływany wiele razy, sprawdź, czy centrum aplikacji jest już skonfigurowane.
Uruchom wymagane usługi bez sekretu aplikacji.

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

Ostrzeżenie

Nie zaleca się umieszczać tajnego klucza aplikacji w kodzie źródłowym.

4.2 Zastąp symbol zastępczy sekretem 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, zawierający twój tajny klucz aplikacji. Możesz skopiować i wkleić cały ten przykład.

W powyższym przykładzie pokazano, jak używać metody Start() oraz jak włączyć App Center Analytics.

Jeśli nie określisz jawnie każdej usługi jako parametrów w metodzie startowej, nie można użyć tej usługi w 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 uwzględnione w pierwszym wywołaniu będą dostępne.

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

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

Udostępnij za pośrednictwem