# Руководство по базовой интеграции iOS SDK 7.0+
В этом разделе содержится информация о том, как интегрировать Pushwoosh SDK в ваше iOS-приложение.
## Предварительные требования
Для интеграции Pushwoosh iOS SDK в ваше приложение вам понадобится следующее:
## Шаги интеграции
### 1. Установка
Вы можете интегрировать Pushwoosh SDK в ваше приложение, используя **Swift Package Manager** или **CocoaPods**.
#### Swift Package Manager
В разделе **Package Dependencies** добавьте следующий пакет:
```
https://github.com/Pushwoosh/Pushwoosh-XCFramework
```
Чтобы использовать Pushwoosh iOS SDK, убедитесь, что вы добавили следующие три фреймворка в таргет вашего приложения при интеграции через Swift Package Manager:
* ```PushwooshFramework```
* ```PushwooshCore```
* ```PushwooshBridge```
#### CocoaPods
Откройте ваш `Podfile` и добавьте зависимость:
```bash
# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'
target 'MyApp' do
# Comment the next line if you don't want to use dynamic frameworks
use_frameworks!
pod 'PushwooshXCFramework'
end
```
Затем в терминале выполните следующую команду для установки зависимостей:
```bash
pod install
```
### 2. Capabilities
Чтобы включить Push-уведомления в вашем проекте, необходимо добавить определенные capabilities.
В разделе Signing & Capabilities добавьте следующие capabilities:
- `Push Notifications`
- `Background Modes`. После добавления этой capability, отметьте флажок `Remote notifications`.
Если вы планируете использовать Time Sensitive Notifications (iOS 15+), также добавьте capability `Time Sensitive Notifications`.
### 3. Код инициализации
#### AppDelegate
Добавьте следующий код в ваш класс AppDelegate:
```swift
import SwiftUI
import PushwooshFramework
@main
struct MyApp: App {
// Регистрируем AppDelegate как UIApplicationDelegate
@UIApplicationDelegateAdaptor(AppDelegate.self) var appDelegate
var body: some Scene {
WindowGroup {
ContentView()
}
}
}
class AppDelegate: NSObject, UIApplicationDelegate, PWMessagingDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
// Код инициализации
// Устанавливаем кастомный делегат для обработки push-уведомлений
Pushwoosh.configure.delegate = self
// Регистрируемся для получения push-уведомлений
Pushwoosh.configure.registerForPushNotifications()
return true
}
// Обрабатываем токен, полученный от APNS
func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
Pushwoosh.configure.handlePushRegistration(deviceToken)
}
// Обрабатываем ошибку получения токена
func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
Pushwoosh.configure.handlePushRegistrationFailure(error)
}
// для тихих push-уведомлений
func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
Pushwoosh.configure.handlePushReceived(userInfo)
completionHandler(.noData)
}
// Срабатывает при получении push-уведомления
func pushwoosh(_ pushwoosh: Pushwoosh, onMessageReceived message: PWMessage) {
print("onMessageReceived: ", message.payload!.description)
}
// Срабатывает, когда пользователь нажимает на уведомление
func pushwoosh(_ pushwoosh: Pushwoosh, onMessageOpened message: PWMessage) {
print("onMessageOpened: ", message.payload!.description)
}
}
struct ContentView: View {
var body: some View {
Text("Pushwoosh with SwiftUI")
.padding()
}
}
```
```swift
import PushwooshFramework
@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, PWMessagingDelegate {
var window: UIWindow?
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
//код инициализации
//устанавливаем кастомный делегат для обработки push-уведомлений, в нашем случае AppDelegate
Pushwoosh.configure.delegate = self;
//регистрируемся для получения push-уведомлений
Pushwoosh.configure.registerForPushNotifications()
return true
}
//обрабатываем токен, полученный от APNS
func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
Pushwoosh.configure.handlePushRegistration(deviceToken)
}
//обрабатываем ошибку получения токена
func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
Pushwoosh.configure.handlePushRegistrationFailure(error);
}
//для тихих push-уведомлений
func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable : Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
Pushwoosh.configure.handlePushReceived(userInfo)
completionHandler(.noData)
}
//это событие срабатывает при получении push-уведомления
func pushwoosh(_ pushwoosh: Pushwoosh, onMessageReceived message: PWMessage) {
print("onMessageReceived: ", message.payload!.description)
}
// Срабатывает, когда пользователь нажимает на уведомление
func pushwoosh(_ pushwoosh: Pushwoosh, onMessageOpened message: PWMessage) {
print("onMessageOpened: ", message.payload!.description)
}
}
```
```objective-c
#import
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
//-----------PUSHWOOSH PART-----------
// устанавливаем кастомный делегат для обработки push-уведомлений, в нашем случае AppDelegate
[Pushwoosh configure].delegate = self;
//регистрируемся для получения push-уведомлений!
[[Pushwoosh configure] registerForPushNotifications];
return YES;
}
//обрабатываем токен, полученный от APNS
- (void)application:(UIApplication *)application
didRegisterForRemoteNotificationsWithDeviceToken:(NSData *)deviceToken {
[[Pushwoosh configure] handlePushRegistration:deviceToken];
}
//обрабатываем ошибку получения токена
- (void)application:(UIApplication *)application didFailToRegisterForRemoteNotificationsWithError:(NSError *)error {
[[Pushwoosh configure] handlePushRegistrationFailure:error];
}
//для тихих push-уведомлений
- (void)application:(UIApplication *)application
didReceiveRemoteNotification:(NSDictionary *)userInfo
fetchCompletionHandler:(void (^)(UIBackgroundFetchResult))completionHandler {
[[Pushwoosh configure] handlePushReceived:userInfo];
completionHandler(UIBackgroundFetchResultNoData);
}
//это событие срабатывает при получении push-уведомления
- (void)pushwoosh:(Pushwoosh *)pushwoosh onMessageReceived:(PWMessage *)message {
NSLog(@"onMessageReceived: %@", message.payload);
}
//это событие срабатывает, когда пользователь нажимает на уведомление
- (void)pushwoosh:(Pushwoosh *)pushwoosh onMessageOpened:(PWMessage *)message {
NSLog(@"onMessageOpened: %@", message.payload);
}
@end
```
#### Info.plist
В вашем `Info.plist`:
- установите для ключа `Pushwoosh_APPID` значение Pushwoosh Application Code.
- установите для ключа `Pushwoosh_API_TOKEN` значение [Pushwoosh Device API Token](/ru/developer/api-reference/api-access-token/#device-api-token)
### 4. Отслеживание доставки сообщений
Pushwoosh поддерживает отслеживание событий доставки для push-уведомлений через Notification Service Extension
#### Добавление Notification Service Extension
1. В Xcode выберите **File** > **New** > **Target...**
2. Выберите **Notification Service Extension** и нажмите **Next.**
3. Введите имя таргета и нажмите **Finish.**
4. Когда появится запрос на активацию, нажмите **Cancel.**
#### Зависимости для Notification Service Extension (только для CocoaPods)
Примечание: Если вы используете Swift Package Manager для управления зависимостями, вы можете пропустить этот шаг, так как зависимости добавляются автоматически.
Откройте ваш `Podfile` и добавьте зависимость для таргета:
```ruby title="Podfile"
# Uncomment the next line to define a global platform for your project
# platform :ios, '9.0'
target 'MyApp' do
# Comment the next line if you don't want to use dynamic frameworks
use_frameworks!
pod 'PushwooshXCFramework'
end
target 'MyAppNotificationExtension' do
use_frameworks!
pod 'PushwooshXCFramework'
end
```
Выполните следующую команду в терминале, чтобы обновить зависимости:
```shell
pod update
```
#### Добавление Pushwoosh SDK в Notification Service Extension
Замените сгенерированный класс `NotificationService` подклассом `PushwooshNotificationServiceExtension`. Pushwoosh затем обрабатывает все, что нужно для push-уведомления — отправку события о доставке, подсчет бейджей, загрузку медиа-вложений и обязательный таймаут `serviceExtensionTimeWillExpire`. Никакого другого кода не требуется.
```swift
import PushwooshFramework
class NotificationService: PushwooshNotificationServiceExtension {}
```
```objective-c
#import
@interface NotificationService : PushwooshNotificationServiceExtension
@end
@implementation NotificationService
@end
```
Примечание: вы можете полностью пропустить исходный файл — установите `NSExtensionPrincipalClass` расширения в `PushwooshNotificationServiceExtension` в его Info.plist и не пишите код вообще.
Чтобы изменить уведомление перед его показом, переопределите `didReceive(_:withContentHandler:)`, вызовите `super` с вашим собственным обработчиком контента, измените контент внутри него, а затем передайте его исходному обработчику. Pushwoosh по-прежнему выполняет отправку события о доставке, обработку бейджа, вложения и таймаута.
```swift
import UserNotifications
import PushwooshFramework
class NotificationService: PushwooshNotificationServiceExtension {
override func didReceive(_ request: UNNotificationRequest,
withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
super.didReceive(request) { content in
let mutable = (content.mutableCopy() as? UNMutableNotificationContent) ?? content
// Измените содержимое уведомления здесь...
contentHandler(mutable)
}
}
}
```
```objective-c
#import
@interface NotificationService : PushwooshNotificationServiceExtension
@end
@implementation NotificationService
- (void)didReceiveNotificationRequest:(UNNotificationRequest *)request
withContentHandler:(void (^)(UNNotificationContent * _Nonnull))contentHandler {
[super didReceiveNotificationRequest:request withContentHandler:^(UNNotificationContent *content) {
UNMutableNotificationContent *mutable = [content mutableCopy];
// Измените содержимое уведомления здесь...
contentHandler(mutable);
}];
}
@end
```
#### Info.plist
Расширение наследует `Pushwoosh_APPID` (и другие ключи `Pushwoosh_*`) от основного приложения, поэтому вам не нужно дублировать их в Info.plist расширения. Добавляйте ключ туда только если хотите переопределить значение хоста.
Для синхронизации счетчика бейджей и настроек обратного прокси с приложением, используйте общую [App Group](/ru/developer/pushwoosh-sdk/ios-sdk/setting-up-badges) для приложения и расширения. Добавьте capability App Groups в оба таргета, затем установите ID App Group в Info.plist **основного приложения**:
- `PW_APP_GROUPS_NAME` - ваш идентификатор App Group (например, `group.com.example.app`).
Расширение наследует это значение от основного приложения, поэтому вам не нужно повторять его в Info.plist расширения — добавляйте его туда только для переопределения. В качестве альтернативы, вы можете указать его в коде, переопределив `pushwooshAppGroupsName`.
### 5. Запуск проекта
1. Соберите и запустите проект.
2. Перейдите в Панель управления Pushwoosh и [отправьте push-уведомление](/ru/product/messaging-channels/push-notifications/send-push-notifications/one-time-push).
3. Вы должны увидеть уведомление в приложении.
## Расширенная интеграция Pushwoosh iOS
На этом этапе вы уже интегрировали SDK и можете отправлять и получать push-уведомления. Теперь давайте рассмотрим основную функциональность.
### Push-уведомления
В Pushwoosh SDK есть два колбэка, предназначенных для обработки push-уведомлений:
- `onMessageReceived`: Этот метод вызывается при получении push-уведомления.
- `onMessageOpened`: Этот метод вызывается, когда пользователь взаимодействует с уведомлением (открывает его).
Эти колбэки позволяют разработчикам управлять получением и взаимодействием пользователя с push-уведомлениями в своих приложениях.
```swift
import PushwooshFramework
class AppDelegate: NSObject, UIApplicationDelegate, PWMessagingDelegate {
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey : Any]? = nil) -> Bool {
Pushwoosh.configure.delegate = self;
}
func pushwoosh(_ pushwoosh: Pushwoosh, onMessageOpened message: PWMessage) {
if let payload = message.payload {
print("onMessageOpened: \(payload)")
}
}
func pushwoosh(_ pushwoosh: Pushwoosh, onMessageReceived message: PWMessage) {
if let payload = message.payload {
print("onMessageReceived: \(payload)")
}
}
}
```
```objective-c
#import
@interface AppDelegate ()
@end
@implementation AppDelegate
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
[[Pushwoosh configure] setDelegate:self];
return YES;
}
- (void)pushwoosh:(Pushwoosh *)pushwoosh onMessageOpened:(PWMessage *)message {
if (message.payload) {
NSLog(@"onMessageOpened: %@", message.payload);
}
}
- (void)pushwoosh:(Pushwoosh *)pushwoosh onMessageReceived:(PWMessage *)message {
if (message.payload) {
NSLog(@"onMessageReceived: %@", message.payload);
}
}
@end
```
### Конфигурация пользователя
Фокусируясь на поведении и предпочтениях отдельных пользователей, вы можете доставлять персонализированный контент, что приводит к повышению удовлетворенности и лояльности пользователей.
```swift
import PushwooshFramework
class Registration {
func afterUserLogin(user: User) {
let pushwoosh = Pushwoosh.configure
// устанавливаем User ID
if let userId = user.userId {
pushwoosh.setUserId(userId)
}
// устанавливаем email пользователя
if let userEmail = user.email {
pushwoosh.setEmail(userEmail)
}
// устанавливаем номер SMS пользователя
if let userSmsNumber = user.SmsNumber {
pushwoosh.registerSmsNumber(userSmsNumber)
}
// устанавливаем номер WhatsApp пользователя
if let userWhatsAppNumber = user.WhatsAppNumber {
pushwoosh.registerSmsNumber(userWhatsAppNumber)
}
// устанавливаем дополнительную информацию о пользователе в виде тегов для Pushwoosh
if let age = user.userDetails.age,
let name = user.userDetails.userName,
let lastLogin = user.userDetails.lastLoginDate {
pushwoosh.setTags([
"age": age,
"name": name,
"last_login": lastLogin
])
}
}
}
```
```objective-c
#import
@implementation Registration
- (void)afterUserLogin:(User *)user {
Pushwoosh *pushwoosh = [Pushwoosh configure];
// устанавливаем User ID
if (user.userId) {
[pushwoosh setUserId:user.userId];
}
// устанавливаем email пользователя
if (user.email) {
[pushwoosh setEmail:user.email];
}
// устанавливаем дополнительную информацию о пользователе в виде тегов для Pushwoosh
if (user.userDetails.age && user.userDetails.userName && user.userDetails.lastLoginDate) {
NSDictionary *tags = @{
@"age": user.userDetails.age,
@"name": user.userDetails.userName,
@"last_login": user.userDetails.lastLoginDate
};
[pushwoosh setTags:tags];
}
}
@end
```
### Теги
Теги — это пары «ключ-значение», присваиваемые пользователям или устройствам, которые позволяют сегментировать аудиторию на основе таких атрибутов, как предпочтения или поведение, для целевых сообщений.
```swift
import PushwooshFramework
class UpdateUser {
func afterUserUpdateProfile(user: User) {
let pushwoosh = Pushwoosh.configure
// устанавливаем список избранных категорий
pushwoosh.setTags(["favorite_categories" : user.getFavoriteCategories()])
// устанавливаем платежную информацию
pushwoosh.setTags([
"is_subscribed": user.isSubscribed(),
"payment_status": user.getPaymentStatus(),
"billing_address": user.getBillingAddress()
])
}
}
```
```objective-c
#import
@implementation UpdateUser
- (void)afterUserUpdateProfile:(User *)user {
Pushwoosh *pushwoosh = [Pushwoosh configure];
// устанавливаем список избранных категорий
[pushwoosh setTags:@{@"favorite_categories" : user.getFavoriteCategories}];
// устанавливаем платежную информацию
NSDictionary *tags = @{
@"is_subscribed": @(user.isSubscribed),
@"payment_status": user.getPaymentStatus,
@"billing_address": user.getBillingAddress
};
[pushwoosh setTags:tags];
}
@end
```
### События
События — это определенные действия пользователя или происшествия в приложении, которые можно отслеживать для анализа поведения и запуска соответствующих сообщений или действий.
```swift
import PushwooshFramework
class Registration {
func afterUserLogin(user: User) {
if let userName = user.getUserName(), let lastLogin = user.getLastLoginDate() {
PWInAppManager.shared().postEvent("login", withAttributes: [
"name": userName,
"last_login": lastLogin
])
}
}
func afterUserPurchase(user: User, product: Product) {
let pushwoosh = Pushwoosh.configure
// Отслеживаем событие покупки
PWInAppManager.shared().postEvent("purchase", withAttributes: [
"product_id": product.getId(),
"product_name": product.getName(),
"price": product.getPrice(),
"quantity": product.getQuantity()
])
// Устанавливаем теги пользователя
let lastPurchaseDate = Date().timeIntervalSince1970
let lifetimeSpend = getCurrentLifetimeSpend() + product.getPrice()
pushwoosh.setTags([
"last_purchase_date": lastPurchaseDate,
"lifetime_spend": lifetimeSpend
])
}
}
```
```objective-c
#import
#import
@implementation Registration
- (void)afterUserLogin:(User *)user {
NSString *userName = [user getUserName];
NSDate *lastLogin = [user getLastLoginDate];
if (userName && lastLogin) {
[[PWInAppManager sharedManager] postEvent:@"login" withAttributes:@{
@"name": userName,
@"last_login": lastLogin
}];
}
}
- (void)afterUserPurchase:(User *)user product:(Product *)product {
Pushwoosh *pushwoosh = [Pushwoosh configure];
// Отслеживаем событие покупки
[[PWInAppManager sharedManager] postEvent:@"purchase" withAttributes:@{
@"product_id": [product getId],
@"product_name": [product getName],
@"price": @([product getPrice]),
@"quantity": @([product getQuantity])
}];
// Устанавливаем теги пользователя
NSTimeInterval lastPurchaseDate = [[NSDate date] timeIntervalSince1970];
double lifetimeSpend = /* fetch current lifetime spend */ + [product getPrice];
NSDictionary *tags = @{
@"last_purchase_date": @(lastPurchaseDate),
@"lifetime_spend": @(lifetimeSpend)
};
[pushwoosh setTags:tags];
}
@end
```
### Rich Media
Rich media — это интерактивный и мультимедийный контент, такой как изображения, видео или HTML, используемый в уведомлениях и in-app сообщениях для повышения вовлеченности пользователей.
```swift
import PushwooshFramework
class ViewController: UIViewController, PWRichMediaPresentingDelegate {
override func viewDidLoad() {
super.viewDidLoad()
let richMediaConfiguration = PWModalWindowConfiguration.shared()
PWRichMediaManager.shared().delegate = self
richMediaConfiguration.configureModalWindow(with: .PWModalWindowPositionBottom,
present: .PWAnimationPresentFromBottom,
dismiss: .PWAnimationDismissDown)
}
func richMediaManager(_ richMediaManager: PWRichMediaManager!, shouldPresent richMedia: PWRichMedia!) -> Bool {
print("Rich media will be presented with: \(richMedia.pushPayload!)")
return true
}
func richMediaManager(_ richMediaManager: PWRichMediaManager!, didPresent richMedia: PWRichMedia!) {
print("Rich media has been presented with: \(richMedia.pushPayload!)")
}
func richMediaManager(_ richMediaManager: PWRichMediaManager!, didClose richMedia: PWRichMedia!) {
print("Rich media has been closed with: \(richMedia.pushPayload!)")
}
func richMediaManager(_ richMediaManager: PWRichMediaManager!, presentingDidFailFor richMedia: PWRichMedia!, withError error: (any Error)!) {
print("Failed to present rich media with: \(richMedia.pushPayload!). Error: \(error.localizedDescription)")
}
}
```
```objective-c
#import "ViewController.h"
#import
#import
#import
@interface ViewController ()
@end
@implementation ViewController
- (void)viewDidLoad {
[super viewDidLoad];
[[PWRichMediaManager sharedManager] setDelegate:self];
[[PWModalWindowConfiguration shared] configureModalWindowWith:PWModalWindowPositionBottom
presentAnimation:PWAnimationPresentFromBottom
dismissAnimation:PWAnimationDismissDown];
}
- (BOOL)richMediaManager:(PWRichMediaManager *)richMediaManager shouldPresentRichMedia:(PWRichMedia *)richMedia {
NSLog(@"Rich media will be presented with: %@", richMedia.pushPayload);
return YES;
}
- (void)richMediaManager:(PWRichMediaManager *)richMediaManager didPresentRichMedia:(PWRichMedia *)richMedia {
NSLog(@"Rich media has been presented with: %@", richMedia.pushPayload);
}
- (void)richMediaManager:(PWRichMediaManager *)richMediaManager didCloseRichMedia:(PWRichMedia *)richMedia {
NSLog(@"Rich media has been closed with:: %@", richMedia.pushPayload);
}
- (void)richMediaManager:(PWRichMediaManager *)richMediaManager presentingDidFailForRichMedia:(PWRichMedia *)richMedia withError:(NSError *)error {
NSLog(@"Failed to present rich media with: %@. Error: %@", richMedia.pushPayload, error.localizedDescription);
}
@end
```
## Устранение неполадок
### Не удалось собрать модуль 'PushwooshFramework'
При сборке проекта вы можете столкнуться с ошибкой, похожей на эту:
```
Failed to build module 'PushwooshFramework'; this SDK is not supported by the compiler
(the SDK is built with 'Apple Swift version 5.10 (swiftlang-5.10.0.13 clang-1500.3.9.4)',
while this compiler is 'Apple Swift version 6.1.2 effective-5.10 (swiftlang-6.1.2.1.2 clang-1700.0.13.5)')
```
**Причина:** Эта ошибка не связана с несовместимостью версий компилятора Swift. Начиная с версии Pushwoosh iOS SDK 6.8.0, SDK разделен на несколько взаимодействующих компонентов. Ошибка возникает, когда в ваш проект добавлены не все необходимые фреймворки.
**Решение:** Убедитесь, что все четыре необходимых фреймворка добавлены в таргет вашего приложения при интеграции через Swift Package Manager:
* ```PushwooshFramework```
* ```PushwooshCore```
* ```PushwooshBridge```
* ```PushwooshLiveActivities```
Чтобы проверить это в Xcode:
1. Выберите ваш проект в Project Navigator
2. Выберите таргет вашего приложения
3. Перейдите в **General** > **Frameworks, Libraries, and Embedded Content**
4. Убедитесь, что все четыре фреймворка перечислены
---
Если у вас возникнут какие-либо проблемы в процессе интеграции, обратитесь к разделу [поддержка и сообщество](/ru/developer/pushwoosh-sdk/support-and-community).