Erste Schritte mit MAUI und Xamarin

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 .NET SDK in Ihrer App, um App Center Analytics und App Center Crashes zu verwenden. Wenn Sie Ihrer App App Center Distribute hinzufügen möchten, sehen Sie sich die Dokumentation für App Center Distribute an.

1. Voraussetzungen

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

Ihr Projekt ist in Visual Studio oder Visual Studio für Mac eingerichtet.
Sie richten sich an Geräte mit iOS 11.0 oder höher oder Android 5.0 (API-Ebene 21) oder höher.
Sie verwenden kein anderes SDK, das Absturzberichterstattungsfunktionen bereitstellt.

Unterstützte Plattformen:

MAUI iOS
MAUI Android
MAUI Windows
.NET 6.0 macOS
Xamarin.Android
Xamarin.iOS
Xamarin.Mac
Xamarin.Forms (iOS, macOS Android-, UWP- und Windows-Desktopanwendungen)

1.1 MAUI

Hinweis

Derzeit gibt es keine MAUI-Plattform im App Center-Portal. Verwenden Sie Xamarin für iOS und Android und UWP für Windows.

1.2 Über Xamarin.Android

Erstellen Sie eine App im App Center-Portal mit Android als Betriebssystem und Xamarin als Plattform.

1.3 Über Xamarin.iOS

Erstellen Sie eine App im App Center-Portal mit iOS als Betriebssystem und Xamarin als Plattform.

1.4 Über Xamarin.Mac

Erstellen Sie eine App im App Center-Portal mit macOS als Betriebssystem und Xamarin als Plattform.

Warnung

Es gibt ein bekanntes Problem, das verhindert, dass eine App in den App Store hochgeladen wird. Folgen Sie dem Fortschritt auf github.

1.5 Informationen zu Xamarin.Forms (iOS, macOS, Android, UWP und Windows Desktop)

Erstellen Sie fünf Apps im App Center – eine für jedes Betriebssystem.

Sie müssen Xamarin als Plattform für Android-, iOS- und macOS-Anwendungen auswählen (UWP- und Desktopanwendungen haben keine Xamarin-Option).

Für die Windows Desktop- und macOS-Anwendungen müssen Sie Ihr Projekt zur Kompatibilität mit der Xamarin.Forms-Plattform konfigurieren.

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.

Wechseln Sie zu appcenter.ms.
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 des App Center SDK zu Ihrer Lösung

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 für Mac

Ö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 den Abschnitt "Pakete ", und wählen Sie "NuGet-Pakete hinzufügen" aus.
Suchen Sie nach App Center, und wählen Sie "App Center Analytics " und "App Center Crashes" aus.
Klicken Sie auf "Pakete hinzufügen".

Visual Studio für Windows

Ö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.
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.
Wenn Sie in Visual Studio für Mac arbeiten, stellen Sie sicher, dass Sie NuGet-Paketverwaltungserweiterungen installiert haben. Wählen Sie dazu Visual> aus, suchen Sie bei Bedarf nach NuGet, und installieren Sie sie.
Geben Sie den folgenden Befehl in die Konsole 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 in den Abschnitten Visual Studio für Mac oder Visual Studio für Windows beschrieben sind.

4. 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 jedes modul beim Starten des SDK explizit aufrufen.

4.1 Hinzufügen von using-Anweisungen

Fügen Sie die entsprechenden Namespaces in den folgenden Dateien hinzu:

MAUI und Xamarin.Forms - App.xaml.cs
Xamarin.iOS und Xamarin.Mac - AppDelegate.cs
Xamarin.Android - MainActivity.cs

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

4.2 Hinzufügen der `Start()` Methode

4.2.1 MAUI und Xamarin.Forms

Sie müssen für jede Plattform im App Center-Portal unterschiedliche Anwendungen erstellen. Für jede App verfügen Sie über einen anderen geheimen App-Schlüssel. Öffnen Sie die App.xaml.cs Datei des Projekts, und fügen Sie die folgende Zeile im Konstruktor (oder in der OnStart() Methode für Xamarin.Forms) hinzu.

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={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("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}");
if (AppCenter.Configured)
{
    AppCenter.Start(typeof(Analytics));
    AppCenter.Start(typeof(Crashes));
}

4.2.2 Xamarin.Android

Hinweis

Falls Sie das HockeyApp SDK für Android verwenden, müssen Sie das HockeyApp SDK NACH dem App Center SDK initialisieren.

Öffnen Sie die MainActivity.cs Datei des Projekts, und fügen Sie den Start() Aufruf innerhalb der OnCreate() Methode hinzu.

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

Hinweis

Wenn Ihre Anwendung Über Hintergrunddienste oder mehrere Einstiegspunkte wie einen Übertragungsempfänger, exportierte Aktivitäten oder Inhaltsanbieter verfügt, empfiehlt es sich stattdessen, im AppCenter Rückruf zu beginnenApplication.OnCreate.

4.2.3 Xamarin.iOS und Xamarin.Mac

Hinweis

Es ist nicht möglich, mehr als ein aktives Absturzberichts-SDK in Ihrer App zu haben. Deaktivieren Sie die Absturzberichterstattungsfunktion anderer SDKs, um sicherzustellen, dass App Center die Abstürze abfangen kann.

Öffnen Sie die Projektdatei AppDelegate.cs , und fügen Sie den Start() Aufruf innerhalb der FinishedLaunching() Methode hinzu.

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

Hinweis

Wenn Sie Crashes verwenden, müssen Sie diese Methode im UI-/Hauptthread aufrufen und das Starten von Hintergrundaufgaben vermeiden, bis die Start Methode zurückgegeben wird. Der Grund dafür ist, dass jede Nullverweisausnahme, die von einem anderen Thread abgefangen wird, während Crashes initialisiert wird, einen systemeigenen Absturz auslösen und die Catch-Klausel ignorieren kann. Sobald die AppCenter.Start Methode zurückgegeben wird, ist es sicher, nullverweis ausnahmen erneut zu versuchen/abzufangen. Weitere Informationen zur Ursache dieses Timing-Problems finden Sie im Artikel Signale und Drittanbieter-Crash-Reporter.

Warnung

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

Von Bedeutung

Die geschweiften Klammern zeigen, wo die eigentlichen App-Geheimnisse platziert werden sollen, keine geschweiften Klammern im Start Aufruf.

Hinweis

Bei einer iOS-Anwendung ist es nicht möglich, mehr als ein aktives Absturzberichts-SDK in Ihrer App zu verwenden. Deaktivieren Sie die Absturzberichterstattungsfunktion anderer SDKs, um sicherzustellen, dass App Center die Abstürze abfangen kann.

4.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 sowohl App Center Analytics als auch App Center Abstürze einschließen.

Wenn Sie keinen der beiden Dienste verwenden möchten, entfernen Sie den entsprechenden Parameter aus dem obigen Methodenaufruf.

Sofern Sie nicht jedes Modul 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 module, die im ersten Aufruf enthalten sind, sind verfügbar.

Beispiel: Wenn Sie das Onboarding in App Center Analytics ausführen möchten, sollten Sie den Start() Anruf wie folgt ändern:

4.3.1 MAUI und Xamarin.Forms

AppCenter.Start("ios={Your App Secret};macos={Your App Secret};android={Your App Secret};uwp={Your App Secret};windowsdesktop={Your App Secret}", typeof(Analytics));

4.3.2 Xamarin Native

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

Großartig, Sie sind startklar, Analyse- und Absturzdaten im Portal zu visualisieren, die vom SDK automatisch gesammelt werden.

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.

Wenn Sie erfahren möchten, wie Sie mit In-App-Updates beginnen, lesen Sie die Dokumentation von App Center Distribute.

Hinweis

Mithilfe der portablen APIs von Xamarin Forms werden APIs aus allen Modulen angezeigt, aber nicht alle diese APIs werden auf den UWP- und Windows-Desktopplattformen unterstützt und führen nichts aus, wenn sie auf Ihren UWP - und Windows-Desktopanwendungen ausgeführt werden. Insbesondere unterstützt UWP und Windows Desktop nicht das folgende Modul: Verteilen. Jede Methode mit einem Rückgabetyp würde entweder null (für Objekte), 0 (für Zahlen) oder false (für Booleane) in der UWP- und Windows-Desktopanwendung zurückgeben.

5. Sicherungsregeln (nur Android)

Hinweis

Apps für Android 6.0 (API-Ebene 23) oder höher haben automatisch die automatische Sicherung aktiviert.

Hinweis

Wenn Sie bereits über eine benutzerdefinierte Datei mit Sicherungsregeln verfügen, wechseln Sie zum dritten Schritt.

Wenn Sie die automatische Sicherung verwenden, um falsche Informationen zu Geräten zu vermeiden, führen Sie die folgenden Schritte aus:

5.1. Für Android 11 (API-Ebene 30) oder niedriger.

Erstellen Sie appcenter_backup_rule.xml Datei im Ordner "Ressourcen/xml ".

Öffnen Sie die AndroidManifest.xml Datei des Projekts. Fügen Sie das android:fullBackupContent Attribut dem <application> Element hinzu. Sie sollte auf die appcenter_backup_rule.xml Ressourcendatei verweisen.

android:fullBackupContent="@xml/appcenter_backup_rule"

Fügen Sie der dateiappcenter_backup_rule.xml die folgenden Sicherungsregeln hinzu:

<full-backup-content xmlns:tools="http://schemas.android.com/tools">
      <exclude domain="sharedpref" path="AppCenter.xml"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
      <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
      <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
      <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
  </full-backup-content>

5.2. Für Android 12 (API-Ebene 31) oder höher.

Erstellen Sie appcenter_backup_rule.xml Datei im Ordner "Ressourcen/xml ".

Öffnen Sie die AndroidManifest.xml Datei des Projekts. Fügen Sie das android:dataExtractionRules Attribut dem <application> Element hinzu. Sie sollte auf die appcenter_backup_rule.xml Ressourcendatei verweisen.

android:dataExtractionRules="@xml/appcenter_backup_rule"

Fügen Sie der dateiappcenter_backup_rule.xml die folgenden Sicherungsregeln hinzu:

<data-extraction-rules xmlns:tools="http://schemas.android.com/tools">
    <cloud-backup>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </cloud-backup>
    <device-transfer>
        <exclude domain="sharedpref" path="AppCenter.xml"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence"/>
        <exclude domain="database" path="com.microsoft.appcenter.persistence-journal"/>
        <exclude domain="file" path="error" tools:ignore="FullBackupContent"/>
        <exclude domain="file" path="appcenter" tools:ignore="FullBackupContent"/>
    </device-transfer>
</data-extraction-rules>

Freigeben über

Erste Schritte mit MAUI und Xamarin

1. Voraussetzungen

1.1 MAUI

1.2 Über Xamarin.Android

1.3 Über Xamarin.iOS

1.4 Über Xamarin.Mac

1.5 Informationen zu Xamarin.Forms (iOS, macOS, Android, UWP und Windows Desktop)

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

3. Hinzufügen des App Center SDK zu Ihrer Lösung

Visual Studio für Mac

Visual Studio für Windows

Paket-Manager-Konsole

4. Starten des SDK

4.1 Hinzufügen von using-Anweisungen

4.2 Hinzufügen der Start() Methode

4.2.1 MAUI und Xamarin.Forms

4.2.2 Xamarin.Android

4.2.3 Xamarin.iOS und Xamarin.Mac

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

4.3.1 MAUI und Xamarin.Forms

4.3.2 Xamarin Native

5. Sicherungsregeln (nur Android)

5.1. Für Android 11 (API-Ebene 30) oder niedriger.

5.2. Für Android 12 (API-Ebene 31) oder höher.

Feedback

Zusätzliche Ressourcen

4.2 Hinzufügen der `Start()` Methode