Erste Schritte mit WPF/WinForms

  • Artikel

Wichtig

Visual Studio App Center wird am 31. März 2025 eingestellt. Sie können Visual Studio App Center zwar weiterhin verwenden, bis es vollständig eingestellt ist, es gibt jedoch mehrere empfohlene Alternativen, zu denen Sie eine Migration in Betracht ziehen können.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

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-Abstürze.

1. Voraussetzungen

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

  • Ihr Projekt zielt entweder auf .NET Framework Version 4.6.2 (oder höher) oder .NET Core 3.1 (oder höher) ab.
  • .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 ausgerichtet sein (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.
  • Es gibt ein bekanntes Problem bei der Integration des SDK in VSTO-Projekte. Weitere Informationen 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.

  1. Registrieren Sie sich, oder melden Sie sich an, und klicken Sie auf die blaue Schaltfläche in der oberen rechten Ecke des Portals mit dem Namen Neu hinzufügen , und wählen Sie im Dropdownmenü Die Option Neue App hinzufügen aus.
  2. Geben Sie einen Namen und eine optionale Beschreibung für Ihre App ein.
  3. Wählen Sie je nach Projekt das geeignete Betriebssystem und die entsprechende Plattform aus, wie oben beschrieben.
  4. Klicken Sie auf die Schaltfläche unten rechts mit der Bezeichnung Neue App hinzufügen.

Nachdem Sie eine App erstellt haben, können Sie ihr App-Geheimnis auf der Seite Einstellungen im App Center-Portal abrufen. Klicken Sie oben rechts auf der Seite Einstellungen auf die dreifachen vertikalen Punkte , und wählen Sie aus Copy app secret , um Ihr App-Geheimnis abzurufen.

3. Hinzufügen der App Center SDK-Module

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

Hinweis

Das App Center SDK verwendet Assemblys mit starkem Namen aus Gründen der Kompatibilität mit Anwendungen, die Einzeichen mit starkem Namen verwenden.

Visual Studio

  • Öffnen Sie Visual Studio.
  • Klicken Sie auf Datei>öffnen , und wählen Sie Ihre Projektmappe aus.
  • Klicken Sie im Lösungsnavigator mit der rechten Maustaste auf Verweise , und wählen Sie NuGet-Pakete verwalten aus.
  • Suchen Sie auf der Registerkarte Durchsuchen 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 hierzu Tools> NuGet-Paket-Manager-Paket-Manager-Paket-Manager-Konsole> aus.
  • Geben Sie folgende 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: das portierbare und das Projekt, in dem die WPF/WinForms-App ausgeführt wird. Dazu sollten Sie jedes Unterprojekt öffnen und die entsprechenden Schritte ausführen, die im Visual Studio-Abschnitt beschrieben werden.

4. Starten des SDK

Um App Center zu verwenden, wählen Sie die Module aus, die Sie verwenden möchten. Standardmäßig werden keine Module gestartet, und Sie müssen diese beim Starten des SDK explizit aufrufen.

4.1 Hinzufügen der Start() -Methode

WPF

Ändern Sie für Ihre WPF-Anwendung, 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 in 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, Ihr App-Geheimnis in den Quellcode einzubetten.

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

  1. Konfigurieren oder starten Sie sie mit dem App-Geheimnis.
  2. Wenn der Code mehrmals aufgerufen werden kann, überprüfen Sie, ob das App Center bereits konfiguriert ist.
  3. Starten Sie die erforderlichen Dienste ohne das App-Geheimnis.
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:

  1. Konfigurieren oder starten Sie sie mit dem App-Geheimnis.
  2. Wenn der Code mehrmals aufgerufen werden kann, überprüfen Sie, ob das App Center bereits konfiguriert ist.
  3. Starten Sie die erforderlichen Dienste ohne das App-Geheimnis.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

Warnung

Es wird nicht empfohlen, Ihr App-Geheimnis in den Quellcode einzubetten.

4.2 Ersetzen Sie den Platzhalter durch Ihr App-Geheimnis.

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

Die Seite Erste Schritte enthält das obige Codebeispiel mit Ihrem App-Geheimnis. Sie können das gesamte Beispiel kopieren und einfügen.

Das obige Beispiel zeigt die Verwendung der Start() -Methode und enthält App Center Analytics.

Wenn Sie die einzelnen Dienste nicht explizit als Parameter in der start-Methode 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 in der Konsole, und nur die Dienste, die im ersten Aufruf enthalten sind, sind verfügbar.

Großartig, Sie können alle Abstürze im Portal visualisieren, die das SDK automatisch erfasst.

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