Erste Schritte mit iOS

Das App Center SDK verwendet eine modulare Architektur, sodass Sie beliebige oder alle Dienste verwenden können.

Informationen zu daten, die von App Center gesammelt werden, finden Sie auf den Seiten Von App Center SDKs, Datenschutz-Grundverordnungund FAQ gesammelte Daten. Häufig gestellte Fragen enthalten auch die Antworten, die Sie für App Store Datenschutzkonfiguration bereitstellen müssen.

Beginnen wir mit dem Einrichten App Center iOS SDK in Ihrer App für die Verwendung von App Center Analytics und App Center Abstürzen. Informationen zum Hinzufügen App Center Verteilen zu Ihrer App finden Sie in der Dokumentation für App Center Verteilenvon .

1. Voraussetzungen

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

  • Ihr iOS-Projekt ist in Xcode 11 oder höher unter macOS Version 10.14.4 oder höher eingerichtet.
  • Sie richten sich an Geräte, die unter iOS 9.0 oder höher ausgeführt werden.
  • Sie verwenden keine andere Bibliothek, die Absturzberichtsfunktionen 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-Analysen und -Abstürze sind über XCFramework oder SwiftPM mit Mac Predictive kompatibel.

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. Fahren Sie mit appcenter.msum.
  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 Option Neu hinzufügen, und wählen Sie im Dropdownmenü Neue App hinzufügen aus.
  3. Geben Sie einen Namen und optional eine Beschreibung für Ihre App ein.
  4. Wählen Sie iOS als Betriebssystem und Objective-C/Swift als Plattform aus.
  5. Klicken Sie unten rechts auf die Schaltfläche Neue App hinzufügen.

Nachdem Sie eine App erstellt haben, können Sie ihr App-Geheimnis auf der Seite Einstellungen im App Center abrufen. Klicken Sie in der oberen rechten Ecke der Seite Einstellungen auf die drei vertikalen Punkte, und wählen Sie aus, um Ihr App-Geheimnis Copy app secret zu erhalten.

3. Hinzufügen der App Center SDK-Module

Das App Center SDK für iOS kann Ihrer App über Cocoapods, Carthage, Swift Paket-Manageroder durch manuelles Hinzufügen der Binärdateien zu Ihrem Projekt hinzugefügt werden.

Hinweis

In der 4.0.0 Version von App Center Breaking Changes eingeführt. Führen Sie den Abschnitt Migrieren App Center SDK 4.0.0 und höher aus, um App Center früheren Versionen zu migrieren.

3.1 Integration über Cocoapods

Hinweis

ARM64-Simulatoren (wenn sie über Xcode unter Apple Silicon Mac gestartet werden) werden nicht über CocoaPods unterstützt. Erwägen Sie, andere Integrationsmethoden zu verwenden, damit dies funktioniert.

  1. Fügen Sie Ihrem die folgenden Abhängigkeiten podfile hinzu, um App Center Analytics und App Center Abstürze in Ihre App ein include. Diese Aktion pullt die folgenden Frameworks: AppCenter, AppCenterAnalytics und AppCenterCrashes. Stattdessen können Sie die Dienste angeben, die Sie in Ihrer App verwenden möchten. Jeder Dienst verfügt über eine eigene Unterspezifisch, und alle sind auf AppCenter angewiesen. Sie 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'
    
  2. Führen pod install Sie aus, um ihren neu definierten Pod zu installieren, und öffnen Sie die .xcworkspace des Projekts.

Hinweis

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

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

3.2 Integration über Carthage

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 dezentralisierten Abhängigkeits-Manager, der Ihre Abhängigkeiten erstellt und Ihnen binäre Frameworks bereitstellt.

Hinweis

Die Carthage-Integration funktioniert in Xcode 12 nicht vor ort. Informationen zum Funktionieren finden Sie in dieser Carthage-Anweisung.

  1. Fügen Sie ihrem die folgenden Abhängigkeiten Cartfile hinzu, um App Center einzubeziehen. Diese Abhängigkeiten pullen alle Frameworks. 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 aus, um Abhängigkeiten in einen Carthage/Checkouts-Ordner abzurufen. Erstellen Sie dann jedes Framework.

  3. Öffnen Sie die Registerkarte Allgemeine Einstellungen Ihres Anwendungsziels. Ziehen Sie die Dateien AppCenter.framework, AppCenterAnalytics.framework und AppCenterCrashes.framework aus dem Ordner Carthage/Build/iOS in den Projektnavigator von Xcode. AppCenter.framework ist erforderlich, um das SDK zu starten. Wenn sie dem Projekt nicht 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 aktiviert ist. Klicken Sie auf Fertig stellen.

    Hinweis

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

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

3.3 Integration über Swift Paket-Manager

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

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

Hinweis

Wenn Sie App Center SwiftPM integrieren und sie auch im Erweiterungsziel 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, um App Center Analytics und App Center Abstürze für Ihre iOS-App einzurichten.

Hinweis

App Center SDK unterstützt die Verwendung von XCframework . Wenn Sie XCframeworks in Ihr Projekt integrieren möchten, laden Sie dieAppCenter-SDK-Apple-XCFramework.zipvon der Seite Releases herunter, und entzippen Sie sie. Die resultierenden Ordnerinhalte sind nicht plattformspezifisch, sondern enthalten 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. Entzippen Sie die Datei, und Sie sehen einen Ordner namens AppCenter-SDK-Apple, der verschiedene Frameworks für jeden App Center Dienst auf jedem Plattformordner enthält. Das aufgerufene Framework AppCenter ist im Projekt erforderlich, da es Code enthält, der von den verschiedenen Modulen gemeinsam genutzt wird.

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

    • Als bewährte Methode befinden sich Bibliotheken von Drittanbietern in der Regel in einem Unterverzeichnis, das häufig als Anbieter bezeichnet wird. Wenn das Projekt nicht mit einem Unterverzeichnis für Bibliotheken organisiert ist, erstellen Sie jetzt ein Vendor-Unterverzeichnis.
    • Erstellen Sie in Ihrem Xcode-Projekt eine Gruppe namens Vendor, um Ihre Dateistruktur auf dem Datenträger zu imitieren.
  4. Öffnen Sie den entpackten Ordner AppCenter-SDK-Apple im Finder, und kopieren Sie den Ordner in den Ordner Ihres Projekts an dem Speicherort, an dem Sie ihn wünschen. Der Ordner enthält Frameworks in Unterordnern für andere Plattformen, die App Center SDK unterstützt, sodass Sie unter Umständen Unterordner löschen müssen, die Sie nicht benötigen.

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

    • Stellen Sie sicher, dass der Projektnavigator sichtbar ist (⌘+1).
    • Ziehen Sie & AppCenter.framework, AppCenterAnalytics.framework und AppCenterCrashes.framework aus dem Finder (am Speicherort aus dem vorherigen Schritt) in den Projektnavigator von Xcode. AppCenter.framework ist erforderlich, um das SDK zu starten. Wenn sie dem Projekt nicht hinzugefügt wird, funktionieren die anderen Module nicht, und Ihre App wird nicht kompiliert.
    • Ein Dialogfeld wird angezeigt. Stellen Sie sicher, dass Ihr App-Ziel aktiviert ist. Klicken Sie auf Fertig stellen.

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

4. Starten des SDK

Wenn Sie App Center verwenden möchten, können Sie die Module verwenden, die Sie verwenden möchten. Standardmäßig werden keine Module gestartet, und Sie müssen jedes modul beim Starten des SDK aufrufen.

Die nachstehenden Anweisungen unterscheiden sich geringfügig, je nachdem, welchen Lebenszyklus Sie verwenden. Ab Xcode 12 können Sie einen von zwei Lebenszyklen auswählen: "Swift UI App" (standardmäßig in Xcode 12 ausgewählt) und "UI Kit AppDelegate". Wenn Sie Xcode 11 oder niedriger verwenden, verwenden Sie den AppDelegate-Lebenszyklus des UI Kit. Wenn Sie für eine Erweiterung entwickeln, lesen Sie die Seite Erste Schritte mit der Erweiterung.

4.1 Hinzufügen der Import-Anweisungen

Öffnen Sie die AppDelegate-Datei des Projekts (für den AppDelegate-Lebenszyklus des UI Kit) oder die Datei App.swift (für den Swift UI-App-Lebenszyklus), und fügen Sie die folgenden Import-Anweisungen hinzu:

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

4.2 Hinzufügen der start:withServices: -Methode

UI Kit AppDelegate

Fügen Sie der Delegatmethode Initialisierungscode didFinishLaunchingWithOptions hinzu.

Swift UI-App-Lebenszyklus

Erstellen Sie eine Methode in , init() und fügen Sie darin struct Initialisierungscode hinzu.

Verwenden Sie diesen Code in zuvor beschriebenen Methoden, um das SDK zu starten:

[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 Anwendung mit dem Folgenden verfügen, können Sie App-Geheimnisse 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])

Wenn Sie App Center Dienste separat starten müssen, sollten Sie:

  1. Konfigurieren oder starten Sie es mit dem App-Geheimnis.
  2. Wenn der Code mehrmals aufgerufen werden kann, überprüfen Sie, ob die App Center bereits konfiguriert ist.
  3. Starten Sie die erforderlichen Dienste ohne das App-Geheimnis.
[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 Ihr App-Geheimnis.

Ersetzen Sie Text durch {Your App Secret} 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 Erste Schritte Seite enthält das obige Codebeispiel mit Ihrem App-Geheimnis darin. Sie können das gesamte Beispiel kopieren und einfügen.

Im obigen Beispiel wird gezeigt, wie sie die start:withServices -Methode ( für Swift) verwendet und sowohl App Center Analytics als auch App Center start(withAppSecret:services:) Abstürze enthält.

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

Sofern Sie nicht explizit jedes Modul als Parameter in der start-Methode angeben, können Sie diesen App Center Dienst nicht verwenden. Außerdem kann die start:withServices API ( start(withAppSecret:services:) für Swift) nur einmal im Lebenszyklus Ihrer App verwendet werden. Alle anderen Aufrufe protokollieren eine Warnung an die Konsole, und nur die module, die im ersten Aufruf enthalten sind, sind verfügbar.

Beispiel: Wenn Sie das Onboarding für App Center Analytics durchführen möchten, sollten Sie den start:withServices start(withAppSecret:services:) API-Aufruf ( für Swift) wie folgt ändern:

[MSACAppCenter start:@"{Your App Secret}" withServices:@[[MSACAnalytics class]]];
AppCenter.start(withAppSecret: "{Your App Secret}", services: [Analytics.self])

Hervorragend, Sie sind alle darauf festgelegt, Analytics- und Crashes-Daten im Portal zu visualisieren, die das SDK automatisch sammelt.

Sehen Sie sich die App Center Analytics-Dokumentation und App Center Crashes-Dokumentation an, um zu erfahren, wie Sie erweiterte Funktionen beider Dienste anpassen und verwenden.

Informationen zu den ersten Schritte mit In-App-Updates finden Sie in der Dokumentation zu App Center Verteilenvon .

Informationen zu den ersten Schritte mit Push finden Sie in der Dokumentation zu App Center Push.