Erste Schritte mit iOS

2025-05-06

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.

Informationen zu Daten, die vom App Center gesammelt werden, finden Sie auf den Seiten zu von App Center-SDKs gesammelten Daten, den Allgemeinen Datenschutzbestimmungen und häufig gestellten Fragen. Außerdem enthalten häufig gestellte Fragen die Antworten, die Sie für die Datenschutzkonfiguration des App Store bereitstellen müssen.

Beginnen wir mit dem Einrichten des App Center iOS SDK in Ihrer App, um App Center Analytics und App Center Crashes zu verwenden. Wenn Sie App Center Distribute zu Ihrer App hinzufügen, sehen Sie die Dokumentation von App Center Distribute an.

1. Voraussetzungen

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

Ihr iOS-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 auf ios 11.0 oder höher ausgeführt werden.
Sie verwenden keine andere Bibliothek, die Absturzberichterstattungsfunktionen bereitstellt (nur für App Center-Abstürze).
Wenn Sie CocoaPods verwenden, um App Center zu integrieren, benötigen Sie CocoaPods Version 1.10 oder höher.

App Center SDK Analytics und Crashes sind mit Mac Catalyst über XCFramework oder SwiftPM 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.

Wechseln Sie zu appcenter.ms.
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.
Geben Sie einen Namen und eine optionale Beschreibung für Ihre App ein.
Wählen Sie iOS als Betriebssystem und Objective-C/Swift als 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 der App Center SDK-Module

Das App Center SDK für iOS 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

Hinweis

ARM64 Simulatoren (die von Xcode gestartet werden, die auf Apple Silicon Mac ausgeführt werden) werden nicht über CocoaPods unterstützt, erwägen Sie die Verwendung anderer Integrationsmethoden, damit sie funktionieren.

Fügen Sie die folgenden Abhängigkeiten podfile hinzu, um App Center Analytics und App Center Crashes in Ihre App einzuschließen. Diese Aktion ruft die folgenden Frameworks ab: AppCenter, AppCenterAnalytics und AppCenterCrashes. Stattdessen können Sie in Ihrer App gewünschte Dienste angeben. Jeder Dienst verfügt über eine eigene Teilspezifikation, und sie alle sind auf AppCenter angewiesen. Es wird automatisch eingezogen.
```
 # Use the following line to use App Center Analytics and Crashes.x
 pod 'AppCenter'

 # Use the following lines if you want to specify which service you want to use.
 pod 'AppCenter/Analytics'
 pod 'AppCenter/Crashes'
 pod 'AppCenter/Distribute'
```
Führen Sie pod install aus, um Ihren neu definierten Pod zu installieren und das Projekt zu öffnen .xcworkspace.

Hinweis

Wenn beim Ausführen von [!] Unable to find a specification for `AppCenter` ein Fehler wie pod install angezeigt wird, führen Sie pod repo update aus, um die neuesten Pods aus dem Cocoapods-Repository abzurufen und danach pod install auszuführen.

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.

Hinweis

Die Carthage-Integration funktioniert in Xcode 12 nicht von Haus aus. Um es zum Laufen zu bringen, lesen Sie diese Carthage-Anleitung

Fügen Sie die folgenden Abhängigkeiten Ihrem Cartfile hinzu, um das App Center einzuschließen. Diese Abhängigkeiten binden 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
```
Führen Sie carthage update aus, um Abhängigkeiten in einen Carthage/Checkouts Ordner abzurufen. Erstellen Sie dann jedes Framework.
Öffnen Sie die Registerkarte " Allgemeine Einstellungen" des Anwendungsziels. Ziehen Sie die Dateien "AppCenter.framework", "AppCenterAnalytics.framework" und "AppCenterCrashes.framework " aus dem Ordner "Carthage/Build/iOS " 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.
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

Klicken Sie im Menü „Xcode“ auf „Datei > Swift-Pakete > Paketabhängigkeit hinzufügen“.
Geben Sie im daraufhin angezeigten Dialogfeld die Repository-URL ein: https://github.com/microsoft/appcenter-sdk-apple.git.
Wählen Sie in Version die Option Bis zur nächsten Hauptversion aus und nehmen Sie die Standardoption.
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 iOS-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.

Laden Sie die App Center SDK-Frameworks herunter, die als ZIP-Datei bereitgestellt werden.
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.
[Optional] Erstellen Sie ein Unterverzeichnis für Drittanbieterbibliotheken.
- Als bewährte Methode befinden sich Drittanbieterbibliotheken in der Regel in einem Unterverzeichnis, häufig als "Vendor" bezeichnet. Wenn das Projekt nicht mit einem Unterverzeichnis für Bibliotheken organisiert ist, erstellen Sie jetzt ein Lieferantenunterverzeichnis .
- Erstellen Sie eine Gruppe namens "Vendor " in Ihrem Xcode-Projekt, um die Dateistruktur auf dem Datenträger nachzuahmen.
Ö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 Unterordner löschen, die Sie nicht benötigen.
Fügen Sie dem Projekt in Xcode die SDK-Frameworks hinzu:
- Stellen Sie sicher, dass der Project Navigator sichtbar ist (⌘+1).
- Ziehen Sie nun AppCenter.framework, AppCenterAnalytics.framework und AppCenterCrashes.framework aus dem Finder (an dem im vorherigen Schritt angegebenen Ort) in den Xcode-Projektnavigator. 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.
- Es wird ein Dialogfeld angezeigt. Stellen Sie sicher, dass Ihr App-Ziel überprüft ist. Klicken Sie auf Fertig stellen.

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 Das App Center zu verwenden, melden Sie sich für die Module an, die Sie verwenden möchten. Standardmäßig werden keine Module gestartet, und Sie müssen jedes Modul beim Starten des SDK aufrufen.

Die folgenden Anweisungen unterscheiden sich geringfügig, je nachdem, welchen Lebenszyklus Sie verwenden. Ab Xcode 12 können Sie einen von zwei Lebenszyklus auswählen: "Swift UI App" (standardmäßig in Xcode 12 ausgewählt) und "UI Kit AppDelegate". 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 (für den Lebenszyklus des UI Kit AppDelegate) oder <die Datei ProjectName>App.swift (für swift UI App Lifecycle), 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

UI Kit AppDelegate

Initialisierungscode in die didFinishLaunchingWithOptions-Delegiertenmethode hinzufügen.

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

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

Swift UI App-Lebenszyklus

Um sicherzustellen, dass das App Center SDK mit swift UI ordnungsgemäß funktioniert, initialisieren Sie es nach dem Laden der Benutzeroberfläche. Die einfachste Möglichkeit, dies zu erreichen, ist die Verwendung der UIApplicationDelegate:

class AppDelegate: NSObject, UIApplicationDelegate {
    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
          AppCenter.start(withAppSecret: "{Your App Secret}", services:[
            Crashes.self, Analytics.self, Distribute.self])
        return true
    }
}

Verwenden Sie dann UIApplicationDelegateAdaptor in struct:

@main
struct YourAppName: App {

  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

    var body: some Scene {
        WindowGroup {
            ContentView()
        }
    }
}

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

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:

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.

[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])

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

Schauen Sie sich die Dokumente "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.

Freigeben über

Erste Schritte mit iOS

1. Voraussetzungen

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

3. Hinzufügen der App Center SDK-Module

3.1 Integration über Kakaopoden

3.2 Integration über Karthage

3.3 Integration über Swift Package Manager

3.4 Integration durch Kopieren der Binärdateien in Ihr Projekt

4. Starten des SDK

4.1 Importanweisungen hinzufügen

4.2 Hinzufügen der start:withServices: Methode

UI Kit AppDelegate

Swift UI App-Lebenszyklus

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

Feedback

Zusätzliche Ressourcen

4.2 Hinzufügen der `start:withServices:` Methode