Erste Schritte mit UWP/WinUI

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 möglicherweise eine Migration in Erwägung ziehen.

Erfahren Sie mehr über Supportzeitpläne und Alternativen.

• Android
• iOS
• iOS-Erweiterungen
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Unity
• macOS
• macOS-Erweiterungen
• tvOS
• Cordova

Das App Center SDK verwendet eine modulare Architektur, sodass Sie einen 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 das UWP-Projekt:

• Ihr Projekt ist in Visual Studio 2017 Update 15.9 oder höher eingerichtet.
• Sie richten sich an Geräte, die Windows 10 Build 16299 oder höher ausgeführt werden.
• Ihr Projekt verweist auf Universelle Windows-Plattform Version 6.2.8 oder höher (auf dieses Paket wird in der Regel implizit verwiesen).
• NuGet 4.3 oder höher.

Für WinUI-Projekt:

• Ihr Projekt wird in Visual Studio 2019 Update 16.9 oder höher eingerichtet.
• Sie richten sich an Geräte, die Windows 10 Build 17763 oder höher ausgeführt werden.
• 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 Xamarin-Dokumentation Erste Schritte anstelle dieser Dokumentation.

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

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 der Bezeichnung Neu hinzufügen , und 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 das entsprechende 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 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 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 Extras>NuGet-Paket-Manager-Paket-Manager-Konsole>aus.
• Geben Sie folgende Befehle ein:

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

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

Hinweis

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

4. Hinzufügen der Internet (Client) Funktion

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

5. Starten des SDK

Um App Center zu verwenden, müssen Sie sich für die Module entscheiden, 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-Anweisungen

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 dem Konstruktor Ihrer Anwendung den folgenden Aufruf hinzu:

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 Folgendes ausführen:

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 das App-Geheimnis.

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

5.3 Ersetzen Sie den Platzhalter durch Ihr App-Geheimnis

{Your App Secret} Ersetzen Sie Text durch den tatsächlichen Wert für Ihre Anwendung. 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 schließt App Center Analytics ein.

Wenn 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 in der Konsole, und nur die Dienste, die im ersten Aufruf enthalten sind, sind verfügbar.

Großartig, Sie sind alle darauf eingestellt, Analytics im Portal zu visualisieren, das das SDK automatisch erfasst.

Sehen 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.