Erste Schritte mit WPF/WinForms

2025-05-05

Von Bedeutung

Visual Studio App Center wurde am 31. März 2025 eingestellt, mit Ausnahme der Analyse- und Diagnosefeatures, die bis zum 30. Juni 2026 weiterhin unterstützt werden. Weitere Informationen

Das App Center SDK verwendet eine modulare Architektur, sodass Sie beliebige oder alle Dienste verwenden können.

Beginnen wir mit dem Einrichten des App Center SDK in Ihrer App für die Verwendung von App Center Analytics und App Center Crashes.

1. Voraussetzungen

Stellen Sie zunächst sicher, dass die folgenden Voraussetzungen erfüllt sind:

Ihr Projekt richtet sich entweder auf .NET Framework 4.6.2 (oder höher) oder .NET Core 3.1 (oder höher).
.NET Core wird nur unterstützt, wenn die WPF/WinForms-Anwendung unter Windows ausgeführt wird.
Wenn Sie das SDK aus einer portablen Bibliothek verwenden, muss es auf .NET Standard 2.0 oder höher abzielen (PCL wird nicht unterstützt).
PackageReference-Projekttyp. Diese Anforderung stammt aus der SQLitePCL.raw-Bibliothek. Weitere Informationen unter https://github.com/ericsink/SQLitePCL.raw/issues/537.
Beim Integrieren des SDK in VSTO-Projekte ist ein bekanntes Problem aufgetreten. Weitere Details finden Sie unter https://github.com/microsoft/appcenter-sdk-dotnet/issues/1583/.

2. Erstellen Sie Ihre App im App Center-Portal, um das App-Geheimnis zu erhalten.

Wenn Sie Ihre App bereits im App Center-Portal erstellt haben, können Sie diesen Schritt überspringen.

Registrieren Sie sich oder loggen Sie sich ein und drücken Sie die blaue Schaltfläche in der oberen rechten Ecke des Portals mit der Aufschrift Neu hinzufügen. Wählen Sie im Dropdownmenü Neue App hinzufügen aus.
Geben Sie einen Namen und eine optionale Beschreibung für Ihre App ein.
Wählen Sie je nach Projekt wie oben beschrieben das entsprechende Betriebssystem und die entsprechende Plattform aus.
Klicken Sie unten rechts auf die Schaltfläche, die " Neue App hinzufügen" anzeigt.

Nachdem Sie eine App erstellt haben, können Sie den App-Schlüssel auf der Seite "Einstellungen" im App Center-Portal abrufen. Klicken Sie in der oberen rechten Ecke der Seite "Einstellungen " auf die dreifachen vertikalen Punkte , und wählen Sie aus Copy app secret , um Ihren App-Geheimschlüssel zu erhalten.

3. Hinzufügen der App Center SDK-Module

Das App Center SDK kann mit Visual Studio oder der Paket-Manager-Konsole integriert werden.

Hinweis

Das App Center SDK verwendet stark benannte Assemblys für die Kompatibilität mit Anwendungen, die eine stark benannte Signatur verwenden.

Visual Studio

Öffnen Sie Visual Studio.
Klicken Sie auf "Datei>öffnen ", und wählen Sie Ihre Lösung aus.
Klicken Sie im Lösungsnavigator mit der rechten Maustaste auf Verweise , und wählen Sie "NuGet-Pakete verwalten" aus.
Auf der Registerkarte "Durchsuchen" suchen Sie nach App Center, und installieren Sie die Pakete "Microsoft.AppCenter.Analytics " und "Microsoft.AppCenter.Crashes ".

Paket-Manager-Konsole

Öffnen Sie die Konsole in Visual Studio. Wählen Sie dazu Tools>NuGet-Paket-Manager>Paket-Manager-Konsole aus.
Geben Sie die folgenden Befehle ein:

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

Hinweis

Wenn Sie das App Center SDK in einem portablen Projekt verwenden, müssen Sie die Pakete in jedem der Projekte installieren: dem portablen Projekt und dem plattformspezifischen Projekt, das die WPF/WinForms-App ausführt. Dazu sollten Sie jedes Unterprojekt öffnen und die entsprechenden Schritte ausführen, die im Abschnitt "Visual Studio " beschrieben sind.

4. Starten des SDK

Um Das App Center zu verwenden, melden Sie sich für die Module an, die Sie verwenden möchten. Standardmäßig werden keine Module gestartet, und sie müssen beim Starten des SDK explizit aufgerufen werden.

4.1 Hinzufügen der `Start()` Methode

WPF (Windows Presentation Foundation)

Ändern Sie für Ihre WPF-Anwendung das App.xaml.cs und fügen Sie die folgenden using-Anweisungen hinzu:

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

Fügen Sie dann in derselben Datei den folgenden Code in der OnStartup Methode hinzu:

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

Wenn die App.xaml.cs Datei nicht über die OnStartup Methode verfügt, können Sie die Application.OnStartup(StartupEventArgs) Methode hinzufügen. Ihre App.xaml.cs Datei sollte etwa wie folgt aussehen:

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

Warnung

Es wird nicht empfohlen, Den Geheimen App-Schlüssel in Quellcode einzubetten.

Wenn Sie App Center-Dienste separat starten müssen, sollten Sie:

Konfigurieren oder starten Sie es mit dem Geheimen App-Schlüssel.
Wenn der Code mehrmals aufgerufen werden kann, überprüfen Sie, ob das App Center bereits konfiguriert ist.
Starten Sie die erforderlichen Dienste ohne den App-Geheimschlüssel.

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

WinForms

Ändern Sie für Ihre WinForms-Anwendung die Program.cs Datei, und fügen Sie die folgenden using-Anweisungen hinzu:

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

Fügen Sie dann in derselben Datei den folgenden Code in der Main Methode vor der Application.Run Anweisung hinzu.

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

Wenn Sie App Center-Dienste separat starten müssen, sollten Sie:

Konfigurieren oder starten Sie es mit dem Geheimen App-Schlüssel.
Wenn der Code mehrmals aufgerufen werden kann, überprüfen Sie, ob das App Center bereits konfiguriert ist.
Starten Sie die erforderlichen Dienste ohne den App-Geheimschlüssel.

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

Warnung

Es wird nicht empfohlen, Den Geheimen App-Schlüssel in Quellcode einzubetten.

4.2 Ersetzen Sie den Platzhalter durch Ihren App-Geheimschlüssel.

Stellen Sie sicher, dass Sie den Text {Your App Secret} durch den tatsächlichen Wert für Ihre Anwendung ersetzen. Das App-Geheimnis befindet sich auf der Seite " Erste Schritte " oder auf der Seite " Einstellungen " im App Center-Portal.

Die Seite "Erste Schritte" enthält das oben genannte Codebeispiel mit Ihrem App-Geheimnis darin. Sie können das gesamte Beispiel kopieren.

Im obigen Beispiel wird gezeigt, wie Sie die Start() Methode verwenden und App Center Analytics einbinden.

Sofern Sie nicht jeden Dienst explizit als Parameter in der Startmethode angeben, können Sie diesen App Center-Dienst nicht verwenden. Darüber hinaus kann die Start() API nur einmal im Lebenszyklus Ihrer App verwendet werden – alle anderen Aufrufe protokollieren eine Warnung an der Konsole, und nur die dienste, die im ersten Aufruf enthalten sind, sind verfügbar.

Großartig, Sie sind bereit, Abstürze auf dem Portal zu visualisieren, die das SDK automatisch sammelt.

Schauen Sie sich die Dokumentation für App Center Analytics und App Center Crashes an, um zu erfahren, wie Sie erweiterte Funktionen beider Dienste anpassen und verwenden.

Freigeben über