Freigeben über

Erste Schritte mit iOS-Erweiterungen

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

Anwendungserweiterungen unterstützen nur Absturzberichte.

Informationen zum Hinzufügen des App Center SDK zu Ihrer Container-App finden Sie in der Dokumentation für app Center iOS – Erste Schritte.

Beginnen wir mit dem Einrichten des App Center iOS SDK in Ihrer App-Erweiterung, um App Center Crashes zu verwenden.

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.

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 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.
  3. Geben Sie einen Namen und eine optionale 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, 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.

Hinweis

Die Verwendung eines vorhandenen App-Schlüssels aus einem anderen iOS-Projekt hat Nebenwirkungen. Das App Center unterstützt keine Filterung nach Projekt in derselben App Center-Anwendung. Zum Beispiel werden bei der Auflistung von Abstürzen für eine bestimmte Version alle Abstürze aus beiden Projekten für diese Version ohne Unterscheidung aufgeführt. Es kann verwirrend sein.

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. Hinzufügen der App Center SDK-Module

Das App Center SDK kann über Cocoapods, Carthage oder durch manuelles Hinzufügen der Binärdateien zu Ihrem Projekt in Ihre App integriert werden.

3.1 Integration über Kakaopoden

  1. Fügen Sie die folgenden Abhängigkeiten zu Ihrem podfile hinzu, um App Center-Abstürze in Ihre App zu integrieren. Dadurch werden die folgenden Frameworks abgerufen: AppCenter und AppCenterCrashes.

     pod 'AppCenter/Crashes'

  2. 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.

  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 diese Frameworks verknüpfen, die in Ihrer App verwendet werden sollen.

    # 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. 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 " und "AppCenterCrashes.framework " aus dem Ordner "Carthage/Build/" 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 Crashes für Ihre App-Erweiterung.

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 aufgerufene AppCenter Framework ist im Projekt erforderlich, da es Code enthält, der zwischen den verschiedenen Modulen gemeinsam verwendet wird.

  3. [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.

  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, sodass Sie möglicherweise 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 Project Navigator sichtbar ist (⌘+1).
    • Ziehen Sie jetzt AppCenter.framework und AppCenterCrashes.framework aus dem Finder (vom im vorherigen Schritt angegebenen Speicherort) 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-Erweiterung wird nicht kompiliert.
    • Es wird ein Dialogfeld angezeigt, vergewissern Sie sich, dass Ihr Ziel für die App-Erweiterung markiert ist. Klicken Sie auf Fertig stellen.

Nachdem Sie die Frameworks in Ihre App-Erweiterung 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 zu verwendenden Module anmelden. Standardmäßig werden keine Module gestartet, und Sie müssen jedes modul beim Starten des SDK explizit aufrufen.

4.1 Importanweisungen hinzufügen

Fügen Sie die folgenden Zeilen in die Datei ein, die den Einstiegspunkt der App-Erweiterung enthält. Beispiel: Innerhalb der Hauptdatei "ViewController" einer Erweiterung "Today".

@import AppCenter;
@import AppCenterCrashes;

import AppCenter
import AppCenterCrashes

4.2 Hinzufügen der start:withServices: Methode

Fügen Sie die folgende Zeile in den Einstiegspunkt der App-Erweiterung ein. Beispiel: innerhalb der viewDidLoad-Methode der Haupt-ViewController-Datei einer Erweiterung „Today“.

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

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

Derzeit wird nur absturzberichterstattung für Anwendungserweiterungen unterstützt.

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 die Anwendungserweiterung 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.

Großartig, Sie können jetzt die Daten zu Abstürzen im Portal visualisieren, die das SDK automatisch sammelt.

Sehen Sie sich die Dokumentation zu App Center Crashes an, um zu erfahren, wie Sie Ihre App-Erweiterung anpassen und erweiterte Funktionen nutzen können.