iOS configuration for plain notifications

How to configure my iOS build for plain push notifications?

To send plain notifications to your app users, you must first configure notifications in your app build. The sections below outline the process of configuring plain push notifications on your mobile app:

Step 1: Enable push notifications

  • Navigate to your AppMySite dashboard.

  • Go to the Notification Build Settings section for your app.

  • Turn on the Enable Plain Notifications toggle to activate plain notifications for your app.

Step 2: Set up your Firebase

  • Login to Google Firebase and create a new project if you haven’t already created one. Refer to the guide to learn how to create a Firebase project.

Create Firebase project
  • On the Project Overview screen, click on Add app and select iOS.

  • Next, you will be required to enter your Apple bundle ID. Navigate back to your AppMySite app dashboard and copy your Apple bundle ID.

  • Enter the bundle ID, give your app a nickname, and enter your App Store ID. Then click on "Register app."

  • Download the googleservice-info.plist file.

  • Click "Next" until you reach the “Continue to console” button.

  • Next, click on the gear icon next to Project Overview and select Project settings.

  • Navigate to the “Service accounts” tab.

  • Click on Generate new private key. Make sure node.js is selected.

  • Navigate back to your AppMySite dashboard.

  • Upload the downloaded .plist file to the Google Firebase configuration field in the Notification Build Settings section for your app.

Step 3: Generate Notification Identifier

  • Log in to your Apple developer account.

  • Click on Certificates, Identifiers & Profiles.

  • Select Identifiers from the side bar.

  • Click on + next to the Identifiers.

  • Select App IDs then click on Continue to proceed.

  • Select App & enter a description of the identifier.

  • Copy the Notification Bundle ID from the Build Settings screen from AppMySite.

  • Paste it in the Bundle ID field.

  • Then, click on Continue to proceed.

  • Register to confirm the app identifier that you’ve created.

  • Your Notification Identifier has been created.

Step 4: Obtain and Upload Your Notification Provisioning Profile

  • Navigate to the Certificates, Identifiers & Profiles section in your dashboard.

  • In the sidebar, click on Profiles under the Provisioning Profiles section.

  • Click the + icon in the top-right corner to create a new provisioning profile.

  • In the profile creation screen, select App Store Connect as the distribution type and click Continue.

  • From the list of available App IDs, select your Notification Bundle ID associated with the app and click Continue.

  • Choose the certificate associated with your app's provisioning profile and click Continue.

  • Provide a name for your provisioning profile in the Profile Name field (e.g., "Notification Provisioning Profile").

  • Click Generate to create the profile.

  • Once the profile is generated, click Download to save the file. It will have a .mobileprovision extension.

  • Return to your AppMySite dashboard.

  • Navigate to the Notification Build Settings section for your app.

  • Upload the .mobileprovision file in the Provisioning Profile field.

Step 5: Generate APNS certificate

  • Go back to your Apple developer account.

  • Click on Certificates, Identifiers & Profiles.

  • Navigate to the Certificate screen. Click on the add(+) button to generate a new Certificate.

  • Select Apple Push Notification services SSL (Sandbox & Production).

  • Next, click on Continue.

  • Select the App ID (Bundle ID) corresponding to your app.

  • Upload a Certificate Signing Request. Follow this guide to generate a CSR file.

  • Download the certificate.

  • The downloaded to certificate will be in the CER format, which will need to be converted into p12 using keychain access.

  • Double click .cer file to open Keychain Access window.

  • Click on Login and navigate to the My Certificates tab in the Keychain Access window.

  • Right-click on the .cer file and export it to your system.

  • Give your certificate a unique name and select .p12 File Format.

  • Protecting your certifcate with a password is optional

  • Upload the certificate in the APNS Certificate in your AppMySite account.

  • Submit the password if you protected your certificate.

  • Save the changes to complete the configuration.

Step 6: Upload the APNs certificate in Firebase

  • Go to your Google Firebase account.

  • Select the project you created for your iOS app.

  • In the Project Overview screen, click the gear icon near the top-left and select Project settings from the dropdown menu.

  • In the Settings page, navigate to the Cloud messaging tab.

  • Scroll down to Apple app configuration and expand APNs Certificates section.

  • Upload the certificate in the “No production APNs certificate” field.

Last updated