Test-Push-Geräte hinzufügen

Sie können Testgeräte verwenden, um eine Vorschau davon zu erhalten, wie Push-Benachrichtigungen auf einem Gerät aussehen, bevor Sie sie an die App-Benutzer senden. Dazu müssen Sie Ihr Gerät (mit Ihrer installierten App) als Testgerät registrieren.

So fügen Sie ein Testgerät hinzu:

1. Navigieren Sie zum Abschnitt Testgeräte in Ihrem Pushwoosh-Konto.

2. Klicken Sie auf die Dropdown-Schaltfläche Gerät hinzufügen in der oberen rechten Ecke und wählen Sie Push.

Sie können ein Push-Testgerät mit einer von zwei Methoden hinzufügen: Automatische Konfiguration mit QR-Code oder manuelle Konfiguration.

Testgeräte automatisch hinzufügen

Diese Methode ist nur für iOS- und Android-Geräte geeignet.

1. Klicken Sie im Abschnitt Testgeräte auf Gerät hinzufügen und wählen Sie Push.
2. Scannen Sie den QR-Code, der im Popup erscheint. Dadurch wird ein Deep Link generiert, den das Pushwoosh SDK parsen kann, um Ihr Gerät automatisch als Testgerät zu registrieren.
3. Fügen Sie den Deep Link zur App-Konfiguration hinzu:

• Für Android: Fügen Sie ihn zur Datei AndroidManifest.xml hinzu.
• Für iOS: Fügen Sie ihn zur Datei Info.plist hinzu.

Weitere Details finden Sie in den Anleitungen für Android und iOS im Abschnitt Implementierung.

Tipp für QR-Reader

Stellen Sie sicher, dass der gescannte Link im nativen Browser geöffnet wird, nicht in der Webansicht des QR-Readers. Viele QR-Reader haben dafür eine Schaltfläche „Im Browser öffnen“.

Testgeräte manuell hinzufügen

Wenn Sie es vorziehen, ein Testgerät manuell zu registrieren, folgen Sie diesen Schritten:

1. Rufen Sie die Hardware-ID (HWID) des Geräts aus einem erfolgreichen /registerDevice API-Aufruf ab.
2. Füllen Sie die erforderlichen Felder aus:
   • Gerätename: Ein beschreibender Name für das Testgerät (z. B. „Johns Android“).
   • Geräte-HWID: Die eindeutige Hardware-ID des Geräts.
   • Gerätetyp: Wählen Sie die Plattform (z. B. iOS, Android, Web).
   • Beschreibung (Optional): Fügen Sie Notizen oder Details zum Gerät als Referenz hinzu.
3. Klicken Sie auf Speichern, um das Testgerät zu registrieren.

Nach der Registrierung ist das Testgerät im Abschnitt Testgeräte verfügbar.

Implementierung

Android

1. Integrieren Sie das Pushwoosh SDK in Ihre Anwendung.

2. Fügen Sie DeepLinkActivity zu Ihrer AndroidManifest.xml hinzu:

<activity
          android:name="com.pushwoosh.DeepLinkActivity"
          android:theme="@android:style/Theme.Translucent.NoTitleBar" >
  <intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />

    <data android:scheme="pushwoosh-YOUR_PUSHWOOSH_APP_ID" />
  </intent-filter>
</activity>

Vergessen Sie nicht, YOUR_PUSHWOOSH_APP_ID im obigen XML durch Ihre Pushwoosh App ID zu ersetzen.
Beispiel: <data android:scheme=“pushwoosh-ABCDE-EDCBA” />

3. Starten Sie die Anwendung, um Push-Benachrichtigungen zu abonnieren.

4. Scannen Sie den QR-Code im Formular Testgeräte mit einer geeigneten QR-Code-Scanner-App*. Eine Toast-Nachricht wird angezeigt, die den Status der Registrierung des Testgeräts anzeigt.

* Die meisten QR-Code-Scan-Apps behandeln solche Deep Links korrekt, hier sind nur einige davon:

• QR & Barcode Scanner, Gamma Play
• QR & Barcode Scanner, Maker, AppSourceHub

iOS

1. Integrieren Sie das Pushwoosh SDK in Ihre Anwendung.

2. Fügen Sie das URL-Schema pushwoosh-YOUR_PUSHWOOSH_APP_ID zur Datei Info.plist hinzu:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLName</key>
    <string>com.pushwoosh.scheme</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>pushwoosh-YOUR_PUSHWOOSH_APP_ID</string>
    </array>
  </dict>
</array>

Vergessen Sie nicht, YOUR_PUSHWOOSH_APP_ID im obigen XML durch Ihre Pushwoosh App ID zu ersetzen.
Beispiel: pushwoosh-ABCDE-EDCBA

Vorsicht

Wenn Ihr Projekt (nur) mit SwiftUI erstellt wurde, müssen Sie einen SceneDelegate hinzufügen

SwiftUI verwaltet den App-Lebenszyklus anders als UIKit. Um sicherzustellen, dass bestimmte Systemereignisse korrekt funktionieren – wie das Registrieren eines Testgeräts für Push-Benachrichtigungen oder das Behandeln von Deep Links – müssen Sie explizit einen SceneDelegate hinzufügen und registrieren.

Ohne ihn werden diese Ereignisse möglicherweise nicht richtig ausgelöst, und die Push-Registrierung kann fehlschlagen.

Wenn Sie SwiftUI nicht verwenden, können Sie diesen Schritt überspringen und direkt zu Schritt 3 gehen.

Info.plist

Fügen Sie UIApplicationSceneManifest zu Ihrer Info.plist hinzu.

  <key>UIApplicationSceneManifest</key>
  <dict>
    <key>UIApplicationSupportsMultipleScenes</key>
    <true/>
    <key>UISceneConfigurations</key>
    <dict>
      <key>UIWindowSceneSessionRoleApplication</key>
      <array>
        <dict>
          <key>UISceneConfigurationName</key>
          <string></string>
          <key>UISceneDelegateClassName</key>
          <string>$(PRODUCT_MODULE_NAME).SceneDelegate</string>
        </dict>
      </array>
    </dict>
  </dict>

SceneDelegate

Fügen Sie den SceneDelegate-Code wie im folgenden Beispiel gezeigt hinzu.

import SwiftUI

@main
struct DemoApp: App {
  @UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate

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

class SceneDelegate: NSObject, UIWindowSceneDelegate {

  var window: UIWindow?

  func scene(_ scene: UIScene, willConnectTo session: UISceneSession, options connectionOptions: UIScene.ConnectionOptions) {
      guard let _ = (scene as? UIWindowScene) else { return }
  }
}

class AppDelegate: NSObject, UIApplicationDelegate, PWMessagingDelegate {

  func application(_ application: UIApplication, configurationForConnecting connectingSceneSession: UISceneSession, options: UIScene.ConnectionOptions) -> UISceneConfiguration {
      let sceneConfig: UISceneConfiguration = UISceneConfiguration(name: nil, sessionRole: connectingSceneSession.role)
      sceneConfig.delegateClass = SceneDelegate.self
      return sceneConfig
  }

}

3. Starten Sie die Anwendung, um Push-Benachrichtigungen zu abonnieren.

4. Scannen Sie den QR-Code im Formular Testgeräte mit einem geeigneten QR-Code-Scanner.