Erste Schritte mit macOS

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

• Android
• Ios
• iOS-Erweiterungen
• React Native
• MAUI/Xamarin
• UWP
• WPF/WinForms
• Einheit
• macOS
• macOS-Erweiterungen
• tvOS

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 macOS SDK in Ihrer App für die Verwendung von App Center Analytics und App Center Crashes.

1. Voraussetzungen

Die folgenden Anforderungen müssen erfüllt sein, um das App Center SDK zu verwenden:

• Ihr macOS-Projekt ist in Xcode 13 oder höher unter macOS, Version 10.14.4 oder höher, eingerichtet.
• Sie richten sich an Geräte, die unter macOS 10.13 oder höher ausgeführt werden.
• Sie verwenden keine andere Bibliothek, die Absturzberichterstattungsfunktionen bereitstellt.

Hinweis

App Center SDK wird die Unterstützung für Xcode 10 mit der Juni-SDK-Version ablegen.

App Center SDK Analytics und Crashes sind mit Mac Catalyst über XCFramework oder SwiftPM kompatibel.

Das App Center SDK ist mit Apple Silicon kompatibel.

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. Wechseln Sie zu appcenter.ms.
2. 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 Aufschrift Neu hinzufügen und wählen Sie Neue App hinzufügen im Dropdownmenü aus.
3. Geben Sie einen Namen und eine optionale Beschreibung für Ihre App ein.
4. Wählen Sie macOS als Betriebssystem und Objective-C/Swift als Plattform aus.
5. 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 für macOS kann Ihrer App über Cocoapods, Carthage, Swift Package Manager oder durch manuelles Hinzufügen der Binärdateien zu Ihrem Projekt hinzugefügt werden.

Hinweis

In der 4.0.0 Version des App Center wurden bahnbrechende Änderungen eingeführt. Folgen Sie dem Abschnitt "Migrieren zu App Center SDK 4.0.0" und höher , um App Center aus früheren Versionen zu migrieren.

3.1 Integration über Kakaopoden

1. Fügen Sie die folgenden Abhängigkeiten podfile hinzu, um App Center Analytics und App Center Crashes in Ihre App einzuschließen. Dadurch werden die folgenden Frameworks abgerufen: AppCenter, AppCenterAnalytics und AppCenterCrashes. Stattdessen können Sie angeben, welche Dienste in Ihrer App verwendet werden sollen. Jeder Dienst hat seine eigene Teilspezifikation, und alle verlassen sich auf AppCenter. Es wird automatisch eingezogen.

    # Use the following line to use App Center Analytics and Crashes.
    pod 'AppCenter'
   
    # Use the following lines if you want to specify which service you want to use.
    pod 'AppCenter/Analytics'
    pod 'AppCenter/Crashes'
   

2. Führen Sie pod install aus, um Ihren neu definierten Pod zu installieren und das Projekt zu öffnen .xcworkspace.

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

3.2 Integration über Karthage

Im Folgenden finden Sie die Schritte zum Integrieren des App Center SDK in Ihr Xcode-Projekt mit Carthage Version 0.30 oder höher, einem dezentralen Abhängigkeits-Manager, der Ihre Abhängigkeiten erstellt und Ihnen binäre Frameworks bereitstellt.

1. Fügen Sie die folgenden Abhängigkeiten zu Cartfile hinzu, um App Center in Ihre App einzuschließen. Dies zieht alle Frameworks ein. Anschließend können Sie nur die Frameworks verknüpfen, die Sie in Ihrer App verwenden möchten.

   # Use the following line to get the latest version of App Center
   github "microsoft/appcenter-sdk-apple"
   

   # Use the following line to get the specific version of App Center
   github "microsoft/appcenter-sdk-apple" ~> X.X.X
   

2. Führen Sie carthage update --platform macOS aus. Dadurch werden Abhängigkeiten in den Ordner Carthage/Checkouts geladen und anschließend jedes Framework erstellt.

3. Öffnen Sie die Registerkarte " Allgemeine Einstellungen" des Anwendungsziels. Ziehen Sie die Dateien "AppCenter.framework", "AppCenterAnalytics.framework" und "AppCenterCrashes.framework " aus dem Ordner "Carthage/Build/macOS " in den Project Navigator von Xcode. Das AppCenter.framework ist erforderlich, um das SDK zu starten. Wenn sie nicht zum Projekt hinzugefügt wird, funktionieren die anderen Module nicht, und Ihre App wird nicht kompiliert.

4. Es wird ein Dialogfeld angezeigt. Stellen Sie sicher, dass Ihr App-Ziel überprüft ist. Klicken Sie auf Fertig stellen.

   Hinweis

   Wenn Sie in Ihrer carthage copy-frameworks verwenden, sollten Sie die App Center-SDKs dort nicht hinzufügen, da sie als statische Frameworks ausgeliefert werden.

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

3.3 Integration über Swift Package Manager

1. Klicken Sie im Menü „Xcode“ auf „Datei > Swift-Pakete > Paketabhängigkeit hinzufügen“.
2. Geben Sie im daraufhin angezeigten Dialogfeld die Repository-URL ein: https://github.com/microsoft/appcenter-sdk-apple.git.
3. Wählen Sie in Version die Option Bis zur nächsten Hauptversion aus und nehmen Sie die Standardoption.
4. Wählen Sie die benötigten Module in der Spalte "Paketprodukt " aus.

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

Hinweis

Wenn Sie App Center über SwiftPM integrieren und es auch im Extension-Target Ihrer App verwenden möchten, stellen Sie sicher, dass Sie in Ihrer Konfiguration DISABLE_DIAMOND_PROBLEM_DIAGNOSTIC=YES bereitstellen. Dies ist erforderlich, um SwiftPM-Einschränkungen beim Verknüpfen eines Moduls mit mehreren Zielen zu vermeiden.

3.4 Integration durch Kopieren der Binärdateien in Ihr Projekt

Im Folgenden finden Sie die Schritte zum Integrieren der kompilierten Binärdateien in Ihr Xcode-Projekt zum Einrichten von App Center Analytics und App Center Crashes für Ihre macOS-App.

Hinweis

App Center SDK unterstützt die Verwendung von XCframework. Wenn Sie XCframeworks in Ihr Projekt integrieren möchten, laden Sie die AppCenter-SDK-Apple-XCFramework.zip von der Veröffentlichungsseite herunter, und entpacken Sie es. Resultierende Ordnerinhalte sind nicht plattformspezifisch, sondern enthält XCframeworks für jedes Modul. Sie können auf die gleiche Weise wie übliche Frameworks integriert werden, wie unten beschrieben.

1. Laden Sie die App Center SDK-Frameworks herunter, die als ZIP-Datei bereitgestellt werden.

2. Entpacken Sie die Datei, und Sie sehen einen Ordner namens "AppCenter-SDK-Apple" , der unterschiedliche Frameworks für jeden App Center-Dienst in jedem Plattformordner enthält. Das AppCenter Framework ist im Projekt erforderlich, da es Code enthält, der zwischen den verschiedenen Modulen geteilt wird.

3. [Optional] Erstellen Sie ein Unterverzeichnis für Drittanbieterbibliotheken.

   • Drittanbieterbibliotheken befinden sich in der Regel in einem Unterverzeichnis (es wird häufig "Vendor" genannt). Wenn Ihr Projekt also kein Unterverzeichnis für Bibliotheken verwendet, erstellen Sie jetzt ein Unterverzeichnis des Anbieters .
   • Erstellen Sie eine Gruppe namens "Vendor " in Ihrem Xcode-Projekt, um die Dateistruktur auf dem Datenträger nachzuahmen.

4. Öffnen Sie den entzippten AppCenter-SDK-Apple-Ordner in Finder, und kopieren Sie den Ordner in den Ordner Ihres Projekts an der gewünschten Position. Der Ordner enthält Frameworks in Unterordnern für andere Plattformen, die das App Center SDK unterstützt. Daher müssen Sie möglicherweise nicht benötigte Unterordner löschen.

5. Fügen Sie dem Projekt in Xcode die SDK-Frameworks hinzu:

   • Stellen Sie sicher, dass der Project Navigator sichtbar ist (⌘+1).
   • Ziehen Sie jetzt AppCenter.framework, AppCenterAnalytics.framework und AppCenterCrashes.framework aus dem Finder (die im Ordner "Vendor ") in den Project Navigator von Xcode. AppCenter.framework ist erforderlich, um das SDK zu starten. Wenn die anderen Module fehlen, funktioniert sie nicht, und Ihre App wird nicht kompiliert.
   • Es wird ein Dialogfeld angezeigt. Stellen Sie sicher, dass Ihr App-Ziel überprüft ist. Klicken Sie auf Fertig stellen.

Hinweis

Die SDK-Binärdatei wird nicht nach der macOS-Framework-Konvention verpackt. Der Grund dafür ist, dass das App Center SDK für Mac kein herkömmliches Framework, sondern ein statisches Framework ist. Sie müssen es als statisches Framework verknüpfen: Achten Sie darauf, die Binärdateien nicht einzubetten und sie nicht in der Buildphase "Bündelressourcen kopieren" einzuschließen.

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

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 aufrufen. Wenn Sie eine Erweiterung entwickeln, lesen Sie die Seite "Erste Schritte" der Erweiterung.

4.1 Importanweisungen hinzufügen

Öffnen Sie die AppDelegate-Datei des Projekts, und fügen Sie die folgenden Importanweisungen hinzu:

@import AppCenter;
@import AppCenterAnalytics;
@import AppCenterCrashes;

import AppCenter
import AppCenterAnalytics
import AppCenterCrashes

4.2 Hinzufügen der start:withServices: Methode

Fügen Sie die folgende Zeile in die didFinishLaunchingWithOptions-Delegatmethode der App ein.

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self, Crashes.self])

Wenn Sie über eine Catalyst-Anwendung verfügen, können Sie geheime App-Schlüssel für iOS und macOS gleichzeitig übergeben:

[MSACAppCenter start:@"ios={Your iOS App Secret};macos={Your macOS App Secret}" withServices:@[[MSACAnalytics class], [MSACCrashes class]]];

AppCenter.start(withAppSecret:"ios={Your iOS App Secret};macos={Your macOS App Secret}", services: [Analytics.self, Crashes.self])

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.

[MSACAppCenter configureWithAppSecret:@"{Your App Secret}"];
if ([MSACAppCenter isConfigured]) {
   [MSACAppCenter startService:[MSACAnalytics class]];
   [MSACAppCenter startService:[MSACCrashes class]];
}

AppCenter.configure(withAppSecret: "{Your App Secret}")
if AppCenter.isConfigured {
    AppCenter.startService(Analytics.self)
    AppCenter.startService(Crashes.self)
}

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:withServices-Methode (start(withAppSecret:services:) für Swift) verwenden und sowohl App Center Analytics als auch App Center Crashes einbinden.

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. Außerdem kann die start:withServices (start(withAppSecret:services:) für Swift)-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 app Center Analytics integrieren möchten, sollten Sie den start:withServices (start(withAppSecret:services:) für Swift)-API-Aufruf wie folgt ändern:

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class]]];

AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self])

4.4 Hinzufügen von Internetfunktionen für Sandkasten-Apps

Wenn Ihre App den App-Sandbox verwendet, müssen Sie die Funktion festlegen, ausgehende (Client)-Verbindungen zuzulassen, damit die App Zugriff auf das Internet hat. Xcode 9 aktiviert standardmäßig die App-Sandbox, aber die Funktionen für ausgehende Verbindungen müssen explizit festgelegt werden.

Wählen Sie Ihr Projekt im Projektnavigator aus, wählen Sie die Registerkarte "Funktionen " aus, und aktivieren Sie ausgehende Verbindungen, wenn Ihre App den Sandkasten verwendet.

---

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

Schauen Sie sich die Dokumentationen zu App Center Analytics und App Center Crashes an, um zu erfahren, wie Sie erweiterte Features der einzelnen Dienste anpassen und verwenden.