Warnung

Das AppboyKit (auch bekannt als Objective-C SDK) wird nicht mehr unterstützt und wurde durch das Swift SDK. ] ersetzt. Es wird keine neuen Features, Fehlerbehebungen, Sicherheitsupdates oder technischen Support mehr erhalten - Messaging und Analytics werden jedoch weiterhin wie gewohnt funktionieren. Weitere Informationen finden Sie unter Einführung in das neue Braze Swift SDK.

Integration des Swift-Paketmanagers

Die Installation des iOS SDK über den Swift-Paketmanager (SPM) automatisiert den Großteil des Installationsprozesses für Sie. Bevor Sie mit diesem Vorgang beginnen, stellen Sie sicher, dass Sie Xcode 12 oder höher verwenden.

Hinweis

tvOS ist derzeit nicht über den Swift-Paketmanager verfügbar.

Schritt 1: Hinzufügen der Abhängigkeit zu Ihrem Projekt

SDK-Version importieren

Öffnen Sie Ihr Projekt und navigieren Sie zu den Einstellungen Ihres Projekts. Wählen Sie den Tab Swift Packages und klicken Sie auf die Schaltfläche unterhalb der Paketliste.

Wenn Sie SDK-Version 3.33.1 oder höher importieren, geben Sie die URL unseres iOS-SDK-Repository (https://github.com/braze-inc/braze-ios-sdk) in das Textfeld ein und klicken Sie auf Next.

Für die Versionen 3.29.0 bis 3.32.0 verwenden Sie die URL https://github.com/Appboy/Appboy-ios-sdk.

Wählen Sie auf dem nächsten Bildschirm die SDK-Version aus und klicken Sie auf Next. Die Versionen 3.29.0 und höher sind mit dem Swift-Paketmanager kompatibel.

Pakete auswählen

Wählen Sie das Paket, das Ihren Anforderungen am besten entspricht, und klicken Sie auf Finish. Stellen Sie sicher, dass Sie entweder AppboyKit oder AppboyUI auswählen. Die Einbeziehung beider Pakete kann zu unerwünschtem Verhalten führen:

• AppboyUI
  • Am besten geeignet, wenn Sie die von Braze bereitgestellten UI-Komponenten verwenden möchten.
  • Enthält AppboyKit automatisch.
• AppboyKit
  • Am besten geeignet, wenn Sie keine der von Braze bereitgestellten UI-Komponenten (z. B. Content Cards, In-App-Nachrichten usw.) verwenden müssen.
• AppboyPushStory
  • Fügen Sie dieses Paket hinzu, wenn Sie Push Stories in Ihre App integriert haben. Dies wird ab der Version 3.31.0 unterstützt.
  • Wählen Sie in der Dropdown-Liste unter Add to Target das Ziel für ContentExtension anstelle des Ziels Ihrer Hauptanwendung aus.

Schritt 2: Ihr Projekt konfigurieren

Navigieren Sie als Nächstes zu den Build-Einstellungen Ihres Projekts und fügen Sie das -ObjC-Flag zur Einstellung Other Linker Flags hinzu. Dieses Flag muss hinzugefügt und eventuelle Fehler müssen behoben werden, um das SDK weiter integrieren zu können.

Hinweis

Wenn Sie das Flag -ObjC nicht hinzufügen, können Teile der API fehlen und das Verhalten ist nicht definiert. Es kann zu unerwarteten Fehlern (z. B. „unrecognized selector sent to class“), Abstürzen der Anwendung und anderen Problemen kommen.

Schritt 3: Schema des Ziels bearbeiten

Wichtig

Wenn Sie Xcode 12.5 oder eine neuere Version verwenden, überspringen Sie diesen Schritt.

Wenn Sie Xcode 12.4 oder eine ältere Version verwenden, bearbeiten Sie das Schema des Ziels, das das Appboy-Paket enthält (Menüpunkt Product > Scheme > Edit Scheme):

1. Erweitern Sie das Menü Build und wählen Sie Post-actions. Drücken Sie auf das Pluszeichen (+) und wählen Sie New Run Script Action.
2. Wählen Sie in der Dropdown-Liste Provide build settings from das Ziel Ihrer App aus.
3. Kopieren Sie dieses Skript in das offene Feld:

   1
   2
   3
   4
   # iOS
   bash "$BUILT_PRODUCTS_DIR/Appboy_iOS_SDK_AppboyKit.bundle/Appboy.bundle/appboy-spm-cleanup.sh"
   # macOS (if applicable)
   bash "$BUILT_PRODUCTS_DIR/Appboy_iOS_SDK_AppboyKit.bundle/Contents/Resources/Appboy.bundle/appboy-spm-cleanup.sh"
   

Nächste Schritte

Folgen Sie den Anweisungen, um die Integration abzuschließen.