Часто задаваемые вопросы по iOS SDK

О: Вы можете интегрировать Pushwoosh SDK с помощью Swift Package Manager или CocoaPods.

О: В Xcode перейдите в раздел Package Dependencies и добавьте пакет, используя следующий URL: https://github.com/Pushwoosh/Pushwoosh-XCFramework.

О: Откройте Podfile вашего проекта и добавьте строку pod 'PushwooshXCFramework'. Затем выполните команду pod install в терминале.

О: В разделе Signing & Capabilities настроек вашего проекта необходимо добавить возможности Push Notifications и Background Modes. При добавлении Background Modes убедитесь, что вы отметили флажком Remote notifications.

О: Если вы планируете использовать уведомления, чувствительные ко времени (Time Sensitive Notifications, iOS 15+), вам также необходимо добавить возможность Time Sensitive Notifications.

О: Код инициализации необходимо добавить в ваш класс AppDelegate.

О: Пожалуйста, обратитесь к предоставленному примеру кода на Swift для интеграции Pushwoosh в проект SwiftUI.

О: Пожалуйста, обратитесь к предоставленному примеру кода на Swift для интеграции Pushwoosh в стандартный проект Swift.

О: Пожалуйста, обратитесь к предоставленному примеру кода на Objective-C для интеграции Pushwoosh в проект Objective-C.

О: Вам необходимо добавить в файл Info.plist вашего приложения ключ Pushwoosh_APPID со значением вашего кода приложения (Application Code) и ключ PW_API_TOKEN со значением вашего API-токена.

О: Pushwoosh поддерживает отслеживание событий доставки push-уведомлений с помощью расширения службы уведомлений (Notification Service Extension).

О: В Xcode перейдите в File > New > Target…, выберите Notification Service Extension и нажмите Next. Введите имя цели (target name) и нажмите Finish. Когда появится запрос на активацию, нажмите Cancel.

О: Добавьте предоставленный фрагмент кода на Swift или Objective-C в главный файл .swift или .m вашего расширения службы уведомлений. Этот код использует PWNotificationExtensionManager для обработки запроса уведомления.

О: Возможность App Groups необходима, чтобы позволить расширению службы уведомлений (Notification Service Extension) взаимодействовать с основным приложением.

О: Для обеих целей (targets) перейдите в Signing & Capabilities, добавьте возможность App Groups и создайте новую группу, нажав кнопку +. Убедитесь, что имя группы начинается с group. и используйте одно и то же имя группы для обеих целей.

О: В Info.plist вашей основной цели добавьте ключ PW_APP_GROUPS_NAME и установите его значение равным имени вашей группы App Groups.

О: В Info.plist вашего расширения службы уведомлений добавьте ключ PW_APP_GROUPS_NAME (установив его равным имени вашей группы App Groups) и ключ Pushwoosh_APPID (установив его равным вашему коду приложения).

О: После сборки и запуска вашего проекта перейдите в Pushwoosh Control Panel и отправьте push-уведомление в ваше приложение. Вы должны увидеть уведомление на своем устройстве.

О: Два основных колбэка — это onMessageReceived и onMessageOpened.

О: Метод onMessageReceived вызывается, когда приложение получает push-уведомление.

О: Метод onMessageOpened вызывается, когда пользователь взаимодействует с push-уведомлением и открывает его.

О: Доступ к полезной нагрузке объекта PWMessage (передаваемого в колбэки onMessageReceived и onMessageOpened) можно получить через его свойство payload.

О: Используйте метод setUserId(_:) объекта Pushwoosh.sharedInstance(), передав ID пользователя в качестве аргумента.

О: Используйте метод setEmail(_:) объекта Pushwoosh.sharedInstance(), указав email пользователя.

О: Используйте метод setTags(_:) объекта Pushwoosh.sharedInstance(), передав словарь, где ключи — это имена тегов, а значения — соответствующие значения тегов.

О: Используйте метод postEvent(_:withAttributes:) объекта PWInAppManager.shared(), указав имя события (например, "login") и словарь атрибутов (например, "name", "last_login").

О: Используйте метод postEvent(_:withAttributes:) объекта PWInAppManager.shared() с именем события "purchase" и словарем, содержащим детали продукта, такие как "product_id", "product_name", "price" и "quantity".

О: В вашем view controller или другом подходящем классе реализуйте протокол PWRichMediaPresentingDelegate и установите свойство delegate объекта PWRichMediaManager.shared() на ваш экземпляр, соответствующий протоколу.

О: Используйте объект PWModalWindowConfiguration.shared() для настройки таких свойств, как положение модального окна и анимации появления/исчезновения, с помощью метода configureModalWindow(with:present:dismiss:).

О: Методы делегата предоставляют доступ к объекту PWRichMedia, который содержит информацию о контенте rich media, включая его pushPayload. Метод presentingDidFailForRichMedia:withError: также предоставляет объект Error, описывающий ошибку.

Если вы видите сообщение об ошибке “Your provisioning profile does not have APS entry.”, убедитесь, что ваш provisioning-профиль совместим с push-уведомлениями и содержит в себе строку aps-environment со значением production или development. Самый простой способ проверки — открыть мобильный provisioning-профиль в любом текстовом редакторе и найти строку aps-environment. Она должна там быть.

Если она есть, но вы продолжаете получать ошибку, это означает, что XCode все еще выбирает “несовместимый с push” профиль. Пожалуйста, убедитесь, что вы подписываете приложение правильным профилем — иногда, если у вас есть два профиля для одного и того же App ID, XCode путается и подписывает старым.

Рекомендуемые шаги:

1. Удалите все профили из XCode;
2. Добавьте один-единственный новый профиль;
3. Пересоберите приложение.

Push-токены устройств iOS — это строки из 64 шестнадцатеричных символов. Пример push-токена:
03df25c845d460bcdad7802d2vf6fc1dfde97283bf75cc993eb6dca835ea2e2f
Убедитесь, что push-токены iOS, которые вы используете при таргетинге на конкретные устройства в ваших API-запросах, указаны в нижнем регистре.

Pushwoosh использует IDFV в качестве HWID устройства. Обратите внимание, что он может измениться, если пользователь переустановит все приложения от определенного поставщика.

CBAF8ED1-17FB-49A3-73BD-DC79B63AEF93

По умолчанию последняя версия нашего iOS SDK отображает баннер уведомлений, когда приложение работает на переднем плане.
Вы можете управлять этим поведением, изменяя следующие флаги в Info.plist:

Флаг Pushwoosh_ALERT_TYPE – тип string, значения:

• BANNER – значение по умолчанию, отображает баннерное оповещение в приложении
• ALERT – стандартное оповещение (alert)
• NONE – не показывать уведомления, когда приложение находится на переднем плане

Чтобы получить push-токен вашего iOS-устройства:

1. Откройте Xcode => Devices & Simulators;
2. Подключите тестовое устройство к вашему компьютеру;
3. Выберите ваше подключенное устройство в списке устройств слева;
4. Нажмите кнопку Open Console.

Запустите приложение, для которого вам нужен push-токен устройства, и найдите ваш 64-символьный шестнадцатеричный push-токен в строке “Registered for push notifications”:

Это ожидаемое поведение — бейджами управляет сама iOS, и их значения хранятся в настройках приложения, которые не удаляются мгновенно при удалении вашего приложения. Значение бейджа остается там на некоторое время в случае немедленной переустановки, что приводит к отображению тех же бейджей после повторной установки приложения.