Freigeben über

Erste Schritte mit UWP/WinUI

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:

Für UWP-Projekt:

  • Ihr Projekt ist in Visual Studio 2017 Update 15.9 oder höher eingerichtet.
  • Sie richten sich an Geräte mit Windows 10 Build 16299 oder höher.
  • Ihr Projekt verweist auf die universelle Windows-Plattform 6.2.8 oder höher (dieses Paket wird in der Regel implizit referenziert).
  • NuGet 4.3 oder höher.

Für WinUI-Projekt:

  • Ihr Projekt ist in Visual Studio 2019 Update 16.9 oder höher eingerichtet.
  • Sie richten sich an Geräte mit Windows 10 Build 17763 oder höher.
  • Ihr Projekt verweist auf WinUI 3 0.8.0 oder höher.

Hinweis

Wenn Sie Xamarin.Forms für UWP verwenden möchten, folgen Sie der Dokumentation " Erste Schritte " von Xamarin anstelle dieser Dokumentation.

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 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.
  2. Geben Sie einen Namen und eine optionale Beschreibung für Ihre App ein.
  3. Wählen Sie je nach Projekt wie oben beschrieben das entsprechende Betriebssystem und die entsprechende Plattform aus.
  4. 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.

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

Nachdem Sie das SDK in Ihre Anwendung integriert haben, ist es an der Zeit, das SDK zu starten und die App Center-Dienste zu verwenden.

Hinweis

Wenn Sie das App Center SDK in einem tragbaren Projekt (z. B. Xamarin.Forms) verwenden, müssen Sie die Pakete in jedem der Projekte installieren: portabel, Android und iOS. Dazu sollten Sie jedes Unterprojekt öffnen und die entsprechenden Schritte ausführen, die im Abschnitt "Visual Studio " beschrieben sind.

4. Hinzufügen der Internet (Client) Funktion

Doppelklicken Sie im Projektmappen-Explorer von Visual Studio auf die Datei "Package.appxmanifest " für Ihre Anwendung. Klicken Sie auf die Registerkarte "Funktionen ", und überprüfen Sie dann die Internetfunktion (Client ).

5. Starten des SDK

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

5.1 Hinzufügen der using-Direktiven

Fügen Sie die entsprechenden Namespaces hinzu, bevor Sie unsere APIs verwenden.

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

5.2 Hinzufügen der Start() Methode

Fügen Sie den folgenden Aufruf zum Konstruktor Ihrer Anwendung hinzu:

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:

  1. Konfigurieren oder starten Sie es mit dem Geheimen App-Schlüssel.
  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 den App-Geheimschlüssel.
AppCenter.Configure("{Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics)); 
    AppCenter.Start(typeof(Crashes)); 
}

5.3 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 alle bereit, Analysen im 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.