iOS SDK 7.0+ Schnellstart

Legen Sie mit diesem schnellen und einfachen Beispiel mit dem Pushwoosh iOS SDK los.

Was ist neu im iOS SDK 7.0+

Ab Version 7.0 wurde das Pushwoosh iOS SDK mit einer vollständig modularen Architektur neu gestaltet. Das SDK ist jetzt in separate Module aufgeteilt: PushwooshFramework, PushwooshCore, PushwooshBridge und PushwooshLiveActivities sind für die grundlegende Integration erforderlich, während PushwooshForegroundPush, PushwooshVoIP und PushwooshTVOS je nach Bedarf optional hinzugefügt werden können.

Dieser modulare Ansatz ermöglicht es Ihnen, nur die Funktionen einzubinden, die Ihre App tatsächlich verwendet, was die endgültige Binärgröße reduziert und die Build-Zeiten verbessert. Jedes Modul kann unabhängig aktualisiert werden, was die Übernahme neuer Funktionen erleichtert, ohne den Rest Ihrer Integration zu beeinträchtigen.

Diese Version führt native Unterstützung für den Swift Package Manager für eine einfachere Abhängigkeitsverwaltung ein, zusammen mit verbesserter Swift-Interoperabilität über alle Module hinweg. Die Dokumentation ist jetzt direkt in die binären Frameworks eingebettet, sodass Sie über die Schnellhilfe und das Fenster für die Entwicklerdokumentation direkt in Xcode auf API-Referenzen und Codebeispiele zugreifen können. Zu den neuen Funktionen gehören die volle Unterstützung für iOS 16+ Live-Aktivitäten mit Dynamic Island-Integration, anpassbare Push-Benachrichtigungen im Vordergrund mit animierten Bannern und haptischem Feedback, erweiterte VoIP-Funktionen und ein dediziertes tvOS-Modul für Apple TV-Anwendungen.

Voraussetzungen

Um das Pushwoosh iOS SDK in Ihre App zu integrieren, benötigen Sie Folgendes:

Voraussetzungen

• Ein Pushwoosh-Konto
• Ein Pushwoosh-Projekt, das in Ihrem Konto eingerichtet ist.
• Eine iOS-Plattform, die für den Versand von Push-Benachrichtigungen konfiguriert ist. Wir empfehlen die Verwendung der Konfiguration für die tokenbasierte Authentifizierung als einfachsten Ansatz.
• Stellen Sie während der Einrichtung das Gateway auf Sandbox ein, um Pushes an einen Simulator zu senden.
• Ihr Pushwoosh Application Code und Ihr Pushwoosh Device API Token aus dem Pushwoosh Control Panel für Ihre Anwendung.

Laden Sie das Beispielprojekt herunter

Klonen Sie das Beispielprojekt von GitHub:

git clone https://github.com/Pushwoosh/pushwoosh-ios-sample.git

Konfigurieren Sie das Projekt

1. Öffnen Sie das Projekt in Xcode.

2. Fügen Sie https://github.com/Pushwoosh/Pushwoosh-XCFramework als Swift Package Dependency hinzu.

3. Legen Sie den Bundle Identifier für das Hauptziel (PushwooshSampleApp) so fest, dass er mit Ihrem Pushwoosh-Projekt übereinstimmt (z. B. com.pushwoosh.PushwooshSampleApp).

4. Verwenden Sie denselben Bundle Identifier für das NotificationService-Ziel und hängen Sie .NotificationService an (z. B. com.pushwoosh.PushwooshSampleApp.NotificationService).

5. Legen Sie in Info.plist Folgendes fest:

   • den Pushwoosh_APPID-Schlüssel auf den Pushwoosh Application Code
   • den Pushwoosh_API_TOKEN-Schlüssel auf den Pushwoosh Device API Token

Wichtig: Stellen Sie sicher, dass Sie dem Token in Ihrem Pushwoosh Control Panel Zugriff auf die richtige App gewähren. Erfahren Sie mehr

Führen Sie das Projekt aus

1. Erstellen und führen Sie das Projekt aus.
2. Die App wird zwei Tabs haben: „Aktionen“ und „Einstellungen“. Navigieren Sie zum Tab Einstellungen.
3. Tippen Sie auf die Schaltfläche Für Push-Benachrichtigungen registrieren.
4. Erteilen Sie die Erlaubnis für Push-Benachrichtigungen. Das Gerät wird bei Pushwoosh registriert.

Sie sollten einen Log-Eintrag wie diesen sehen:

Pushwoosh: Initializing application runtime
[PW] BUNDLE ID: __YOUR_BUNDLE_ID__
[PW] APP CODE: __YOUR_APP_CODE__
[PW] PUSHWOOSH SDK VERSION: 7.0.0
[PW] HWID: __YOUR_HWID__
[PW] PUSH TOKEN: (null)
[PW] [I] -[PWNotificationManagerCompatiOS10] NotificationCenter authorization granted: 1
[PW] [I] -[PWPushNotificationsManagerCommon] Registered for push notifications: __YOUR_PUSH_TOKEN__

Ihr Gerät ist jetzt bei Pushwoosh registriert.

Senden Sie eine Push-Benachrichtigung

Gehen Sie zurück zum Pushwoosh Control Panel und senden Sie eine Push-Benachrichtigung an Ihr registriertes Gerät.

Migration von SDK 6.x

Wenn Sie von SDK-Version 6.x upgraden, besteht die Hauptänderung darin, wie Sie auf die Pushwoosh-Instanz zugreifen. In Version 7.0+ verwenden Sie Pushwoosh.configure anstelle von Pushwoosh.sharedInstance():

Vorher (6.x):

Pushwoosh.sharedInstance().registerForPushNotifications()
Pushwoosh.sharedInstance().delegate = self

Nachher (7.0+):

Pushwoosh.configure.registerForPushNotifications()
Pushwoosh.configure.delegate = self

Alle anderen APIs bleiben gleich, sodass die Aktualisierung Ihres Codes nur das Ersetzen von sharedInstance() durch configure in Ihrem gesamten Projekt erfordert.

Was kommt als Nächstes

Um mehr zu erfahren, lesen Sie bitte die Anleitung zur grundlegenden Integration