Erste Schritte mit Unity

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.

Lassen Sie uns loslegen und das App Center Unity SDK für die Verwendung von App Center Analytics und Crashes einrichten. Informationen zum Hinzufügen von App Center Distribute zu Ihrer App finden Sie in der Dokumentation für App Center Distribute.

1. Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Ihr Projekt in Unity 2018.1 oder höher eingerichtet ist.

Das App Center SDK für Unity unterstützt die folgenden Plattformen:

iOS (9.0 oder höher)
Android (5.0/API 21 oder höher)
UWP (Build 16299 oder höher)

Hinweis

.NET 3.5-Skripting-Laufzeitversion und .NET-Skripting-Back-End werden auf der UWP-Plattform nicht mehr unterstützt.

Informationen zur Verwendung von Coroutines/Callbacks anstelle von async/await mit dem .NET 3.5 Backend finden Sie im Abschnitt Asynchrone APIs im Unity SDK der Dokumentation.

Außerdem ist das App Center SDK für Unity nur in C# verfügbar.

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

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 melden Sie sich beim App Center an.
Klicken Sie auf die blaue Schaltfläche in der oberen rechten Ecke des Portals, die " Neu hinzufügen " anzeigt, und 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 der Seite auf die Schaltfläche " Neue App hinzufügen ".

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 Ihrem Projekt

3a Installieren des Erweiterungs-Editors

Das App Center SDK ist integriert, indem Unity-Pakete in Ihr Projekt importiert werden. Installieren Sie dazu zuerst das App Center Unity Editor Extensions-Plug-In . Öffnen Sie die Editorerweiterungen über das Unity-Menü: Windows > App Center-Editor-Erweiterungen > , und wählen Sie "App Center SDK installieren" aus.

Hinweis

In den Unity-Versionen 2019.1.2f1 und höher können während der Installation Fehler in Protokollen auftreten, wie z.B. Coroutine continue failure. Es ist ein bekanntes Unity-Problem, und Sie sollten es ignorieren.

3.1b Installieren einzelner Pakete

Alternativ können alle einzelnen Unity-Pakete heruntergeladen und importiert werden. Sie befinden sich auf der GitHub-Seite des App Center Unity SDK. Laden Sie die neueste Version der Pakete herunter, die Sie verwenden möchten. Der Name sollte im Format "AppCenter{Analytics/Crashes/Distribute}-v{version}.unitypackage" angegeben sein.

3.2b Importieren des Pakets

Öffnen Sie Ihr Unity-Projekt, und doppelklicken Sie dann auf das paket, das Sie heruntergeladen haben. Ein Popupfenster sollte in Ihrem Unity-Projekt mit einer Liste von Dateien angezeigt werden. Wählen Sie "Importieren" aus, und das SDK wird Ihrem Projekt hinzugefügt. Wiederholen Sie diesen Schritt für jedes Paket, das Sie heruntergeladen haben, und planen Sie die Verwendung in Ihrem Projekt.

4. Aktivieren des SDK

4.1 Erstellen eines leeren Spielobjekts

App Center funktioniert als Komponente, die Sie an ein Spielobjekt in der Szene anfügen, in der ihr Spiel gestartet wird. Navigieren Sie zu dieser Szene, und fügen Sie ein leeres Spielobjekt hinzu. Geben Sie ihm einen beschreibenden Namen, z. B. "App Center".

4.2 Anfügen des App Center-Skripts

Navigieren Sie im Projektfenster zum Ordner "AppCenter", der Ihrem Projekt hinzugefügt wurde. Suchen Sie das Skript mit dem Namen "AppCenterBehavior", und ziehen Sie es in das neu erstellte Spielobjekt im Hierarchiefenster .

Hinweis

Sie müssen app Center nicht zu jeder Szene hinzufügen, in der Sie es verwenden möchten. Das Hinzufügen des Elements zur ersten geladenen Szene reicht aus.

4.3 Konfigurieren von App Center-Einstellungen

Klicken Sie auf dieses neue "App Center"-Objekt, und fügen Sie die geheimen App-Schlüssel den entsprechenden Feldern im Inspektorfenster hinzu. Stellen Sie sicher, dass Sie auch die Kontrollkästchen "{service}" für jeden App Center-Dienst aktivieren, den Sie verwenden möchten.

App Center-Skriptkonfiguration

Warnung

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

Hinweis

Wenn Ihr Projekt eine der drei in den Einstellungen aufgeführten Plattformen nicht unterstützt, lassen Sie das Feld "App-Geheimnis" as-is; es hat keine Wirkung. Wenn Ihr Projekt Plattformen unterstützt, die app Center nicht unterstützt, haben die APIs und die Konfiguration keine Auswirkungen auf diese Plattformen.

Großartig, alles ist bereit, um Analyse- und Diagnosedaten, einschließlich Absturz- und Fehlerdaten, im Portal darzustellen, 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 mit beiden Diensten verwenden.

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

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 Sicherungsregel verfügen, wechseln Sie zum dritten Schritt.

Hinweis

Wenn Sie noch nicht über eine eigene AndroidManifest.xml Datei verfügen, erstellen Sie sie im Ordner "Assets/Plugins/Android ". Dieses Manifest wird zum Zeitpunkt des Builds mit dem von Unity erstellten Standard zusammengeführt.

Wenn Sie die automatische Sicherung verwenden, um falsche Informationen über das Gerät 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 "Assets/Plugins/Android/res/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 "Assets/Plugins/Android/res/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 Unity

1. Voraussetzungen

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

3. Hinzufügen des App Center SDK zu Ihrem Projekt

3a Installieren des Erweiterungs-Editors

3.1b Installieren einzelner Pakete

3.2b Importieren des Pakets

4. Aktivieren des SDK

4.1 Erstellen eines leeren Spielobjekts

4.2 Anfügen des App Center-Skripts

4.3 Konfigurieren von App Center-Einstellungen

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