iOS Push Notifications

​

SDK Surface

​

Parameters

​

1. Configure APNs

1. Open Certificates, Identifiers & Profiles.
2. Select your app’s Bundle ID.
3. Enable Push Notifications.
4. Create the APNs certificate or auth key your release process uses.

1. Select your app target.
2. Open Signing & Capabilities.
3. Add Push Notifications.
4. Add background remote-notification mode only if your app needs background notification handling.

​

2. Request System Registration

import UserNotifications

UNUserNotificationCenter.current().requestAuthorization(options: [.alert, .badge, .sound]) { granted, _ in
    if granted {
        DispatchQueue.main.async {
            UIApplication.shared.registerForRemoteNotifications()
        }
    }
}

​

3. Register the APNs Token

func application(
    _ application: UIApplication,
    didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data
) {
    let token = deviceToken.map { String(format: "%02.2hhx", $0) }.joined()

    Task { @MainActor in
        do {
            try await client.registerPushNotification(withDeviceToken: token)
        } catch {
            handleError(error)
        }
    }
}

​

4. Unregister on Sign-Out

try await client.unregisterPushNotification()

​

Setup Checklist

• Push Notifications capability is enabled for the app target.
• The APNs credential for the app Bundle ID is uploaded in the social.plus Console.
• The app calls UIApplication.shared.registerForRemoteNotifications() after permission is granted.
• The APNs device token is passed to client.registerPushNotification(withDeviceToken:).
• The app calls client.unregisterPushNotification() on sign-out when push should stop for that user.