Set up Amplify Push Notifications

The Push Notifications category allows you to integrate push notifications in your app with Amazon Pinpoint targeting, campaign, and journey management support. You can segment your users, trigger push notifications to your app, and record metrics in Pinpoint when users receive or open notifications. Amazon Pinpoint helps you to create messaging campaigns and journeys targeted to specific user segments or demographics and collect interaction metrics with push notifications.

Prerequisites

An application with Amplify libraries integrated and a minimum target of any of the following:

• iOS 13.0, using Xcode 14.1 or later.
• macOS 10.15, using Xcode 14.1 or later.
• tvOS 13.0, using Xcode 14.3 or later.
• watchOS 9.0, using Xcode 14.3 or later.
• visionOS 1.0, using Xcode 15 beta 2 or later. (Preview support - see below for more details.)

For a full example, please follow the project setup walkthrough.

Push Notifications are delivered via the Apple Push Notification service (APNs). In order to use APNs, you need to setup credentials (keys or certificates) and export your credentials to a p12 file. See Setting up push notification services for more information.

Set Entitlements

Using Amazon Pinpoint with APNs requires the following capabilities

• Push Notifications
• Background Processing -> Remote Notifications (iOS/tvOS/watchOS)
• App Sandbox -> Outgoing Connections (macOS only)

To add these capabilities:

Application Delegate

APNs requires an application delegate to handle push notifications functionality via delegate methods. If your app does not already have an application delegate, you will need to create one:

1. Create a class that subclasses NSObject and implements the UIApplicationDelegate (iOS/tvOS), WKApplicationDelegate (watchOS), or NSApplicationDelegate (macOS) protocol.

1class AppDelegate: NSObject, UIApplicationDelegate {
2
3}

1class AppDelegate: NSObject, NSApplicationDelegate {
2
3}

1class AppDelegate: NSObject, WKApplicationDelegate {
2
3}

2. Add a property to your main app struct that identifies your application delegate.

1@main
2struct <YOUR_APP_NAME>App: App {
3    @UIApplicationDelegateAdaptor private var appDelegate: AppDelegate
4    // ...
5}

1@main
2struct <YOUR_APP_NAME>App: App {
3    @NSApplicationDelegateAdaptor private var appDelegate: AppDelegate
4    // ...
5}

1@main
2struct <YOUR_APP_NAME>App: App {
3    @WKApplicationDelegateAdaptor private var appDelegate: AppDelegate
4    // ...
5}

Set up backend resources

To use Push Notifications with Amplify, you have the option to either have the Amplify CLI setup resources for you, or you can use an existing Amazon Pinpoint resource in your AWS account.

1amplify add notifications

1? Choose the push notification channel to enable.
2❯ APNS |  Apple Push Notifications
3  FCM  | » Firebase Push Notifications
4  In-App Messaging
5  Email
6  SMS

1? Provide your pinpoint resource name: › [pinpoint_resource_name]
2? Apps need authorization to send analytics events. Do you want to allow guests
3 and unauthenticated users to send analytics events? (we recommend you allow this 
4 when getting started) (Y/n)

1? Choose authentication method used for APNs
2> Certificate
3Key

1🛑 Command failed: openssl pkcs12 -in [path_to_your_cert].p12 -out [output_path].pem -nodes -passin pass:
2Error outputting keys and certificates

1"notifications": {
2    "plugins": {
3        "awsPinpointPushNotificationsPlugin": {
4            "appId": "[APP ID]",
5            "region": "[REGION]"
6        }
7    }
8}

Install Amplify Libraries

Swift Package Manager

1. To install Amplify Libraries in your application, open your project in Xcode and select File > Add Packages....

2. Enter the Amplify Library for Swift GitHub repo URL (https://github.com/aws-amplify/amplify-swift) into the search bar and click Add Package.

3. Lastly, choose AWSPinpointPushNotificationsPlugin, AWSCognitoAuthPlugin, and Amplify. Then click Add Package.

Initialize Amplify Push Notifications

To initialize the Amplify Push Notifications, you will use the Amplify.addPlugin() method to add the AWSPinpointPushNotificationsPlugin and then call Amplify.configure() to finish configuring Amplify.

Open the main file of the application - AppDelegate.swift or <YOUR_APP_NAME>App.swift depending on the app's life cycle - and add the following import statements at the top of the file:

1import Amplify
2import AWSCognitoAuthPlugin
3import AWSPinpointPushNotificationsPlugin

In the same file, create a function to configure Amplify:

1func configureAmplify() {
2    do {
3        try Amplify.add(plugin: AWSCognitoAuthPlugin())
4        try Amplify.add(plugin: AWSPinpointPushNotificationsPlugin())
5        try Amplify.configure()
6        print("Initialized Amplify");
7    } catch {
8        print("Could not initialize Amplify: \(error)")
9    }
10}

Now call the configureAmplify() function in the starting point of your application.

1@main
2struct <YOUR_APP_NAME>App: App {
3    // add a default initializer and configure Amplify
4    public init() {
5        configureAmplify()
6    }
7    // ...
8}

1@UIApplicationMain
2class AppDelegate: UIResponder, UIApplicationDelegate {
3    func application(_: UIApplication,
4                     didFinishLaunchingWithOptions _: [UIApplication.LaunchOptionsKey: Any]?
5    ) -> Bool {
6        configureAmplify()
7        return true
8    }
9    // ...
10}

Upon building and running this application you should see the following in your console window:

1Initialized Amplify