Добавление тестовых Push-устройств

Вы можете использовать тестовые устройства для предварительного просмотра Push-уведомлений на устройстве перед их отправкой пользователям приложения. Для этого вам необходимо зарегистрировать ваше устройство (с установленным на нем приложением) в качестве тестового устройства.

Чтобы добавить тестовое устройство:

Перейдите в раздел Тестовые устройства в вашем аккаунте Wavesend.

Нажмите на выпадающую кнопку Добавить устройство в правом верхнем углу и выберите Push.

Вы можете добавить тестовое Push-устройство одним из двух способов: автоматическая настройка с помощью QR-кода или ручная настройка.

Автоматическое добавление тестовых устройств

Этот метод подходит только для устройств на iOS и Android.

В разделе Тестовые устройства нажмите Добавить устройство и выберите Push.
Отсканируйте QR-код, который появится во всплывающем окне. Это сгенерирует deep link, который Wavesend SDK сможет обработать для автоматической регистрации вашего устройства в качестве тестового.
Добавьте deep link в конфигурацию приложения:

Для Android: Добавьте его в файл AndroidManifest.xml.
Для iOS: Добавьте его в файл Info.plist.

Для получения более подробной информации следуйте инструкциям для Android и iOS в разделе Реализация.

Добавление тестовых устройств вручную

Если вы предпочитаете регистрировать тестовое устройство вручную, выполните следующие шаги:

Получите Hardware ID (HWID) устройства из успешного вызова API /registerDevice.
Заполните обязательные поля:
- Имя устройства: Описательное имя для тестового устройства (например, «Android Ивана»).
- HWID устройства: Уникальный Hardware ID устройства.
- Тип устройства: Выберите платформу (например, iOS, Android, Web).
- Описание (необязательно): Добавьте любые примечания или сведения об устройстве для справки.
Нажмите Сохранить, чтобы зарегистрировать тестовое устройство.

После регистрации тестовое устройство будет доступно в разделе Тестовые устройства.

Реализация

Android

Интегрируйте Wavesend SDK с вашим приложением.
Добавьте DeepLinkActivity в ваш AndroidManifest.xml:

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

Не забудьте заменить YOUR_PUSHWOOSH_APP_ID в приведенном выше xml на ваш Wavesend App ID.
Пример: <data android:scheme=“pushwoosh-ABCDE-EDCBA” />

Запустите приложение, чтобы подписаться на Push-уведомления.
Отсканируйте QR-код в форме Тестовые устройства с помощью любого подходящего приложения для сканирования QR-кодов*. Появится всплывающее сообщение, информирующее о статусе регистрации тестового устройства.

* – большинство приложений для сканирования QR-кодов правильно обрабатывают такие deep link, вот лишь некоторые из них:

iOS

Интегрируйте Wavesend SDK с вашим приложением.
Добавьте URL-схему pushwoosh-YOUR_PUSHWOOSH_APP_ID в файл Info.plist:

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

Не забудьте заменить YOUR_PUSHWOOSH_APP_ID в приведенном выше XML-коде на ваш Wavesend App ID.
Пример: pushwoosh-ABCDE-EDCBA

Если ваш проект создан только на SwiftUI, вам необходимо добавить SceneDelegate

SwiftUI управляет жизненным циклом приложения иначе, чем UIKit. Чтобы обеспечить корректную работу определенных системных событий, таких как регистрация тестового устройства для Push-уведомлений или обработка deep link, необходимо явно добавить и зарегистрировать SceneDelegate.

Без него эти события могут не срабатывать должным образом, и регистрация для Push-уведомлений может завершиться сбоем.

Если вы не используете SwiftUI, вы можете пропустить этот шаг и перейти сразу к шагу 3.

info.plist

Добавьте UIApplicationSceneManifest в ваш Info.plist.

  <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

Добавьте код SceneDelegate, как показано в примере ниже.

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
  }

}

Запустите приложение, чтобы подписаться на Push-уведомления.
Отсканируйте QR-код в форме Тестовые устройства с помощью любого подходящего сканера QR-кодов.