Build a sample app for the Campaign React Native SDK

To install and run the Sample iOS App, you will need the following:

• Xcode 15 with Command Line Tools
• Node.js 18 or later
• React Native 0.64 or later
• Apple Developer Program membership (free accounts do not support push notifications).

1. In Xcode, go to Account preferences and enter your Apple ID there (if you haven't done it yet).
2. In your Apple Developer Account, register an explicit App ID with the push notification service enabled.
3. Create a development provisioning profile for the new App ID.

1. Clone the public repo Acoustic-Mobile-Push-React-Native.
2. In your terminal emulator, switch to the SampleApp directory.

cd SampleApp

3. Install dependencies for the project.

yarn install

Xcode project configuration

1. Open the project in Xcode, select the Sample App target and enter the Bundle ID associated with the App ID you created for the Sample App.

2. On the Signing & Capabilities tab, assign the Sample App to your team and enable automatic signing.

3. Enable the Push Notifications capability. For instructions, see Adding capabilities to your app in the Xcode guide.
4. Register the Sample App with Apple Push Notification service (APNs). You can use either of the following authentication methods to secure connection to APNs: token-based (p8) (recommended by Apple) or certificate-based (p12).

What to prepare for the next step depending on the selected authentication type:

Step A: get an app key in Acoustic Campaign

To activate the Campaign SDK within the Sample iOS app, you must generate an app key for it and upload the app's push certificate to Acoustic Campaign.

1. Log in to Acoustic Campaign under a developer account.
2. In the navigation menu, select Administration > Push developer resources.

3. Under Apps, click to add a new app.
4. In the Push Service field, select APNs. Then select the type of authentication to use: P8 or P12. Provide required credentials for the selected authentication type.

5. Set the Type setting to Development.
6. Fill out the remaining settings and save the changes.
7. Copy your app key and keep it handy for the next step.

Step B: update the configuration file

1. In the root directory of the Sample App, open the CampaignConfig.json file. Use this file to customize the SDK configuration.
2. Make sure you are using the right build. During testing, set useRelease to false. For production, use true.

  "useRelease": true,

3. Check the version of Campaign SDK for the Sample App. You can enter a number or remove the value to use the latest version.

 "iOSVersion": "",

4. In the iOS section, enter the app key you generated at step A and and the base URL provided by your account team.

{
  "baseUrl": "https://mobile-sdk-lib-XX-Y.brilliantcollector.com",
  "appKey": {
    "dev": "INSERT YOUR DEV APPKEY HERE",
    "prod": "INSERT YOUR PROD APPKEY HERE"
  }
}

5. Important: to apply the changes, run the following Node.js command from the project folder.

node node_modules/react-native-acoustic-mobile-push/postinstall.js ./

When done, run the following commands in your terminal emulator.

1. Change to the app's ios directory.

cd ios

2. Install dependencies.

pod install

3. Start the Sample App.

cd ..
npx react-native run-ios

Run the Sample App on a smartphone paired with Xcode. You can also use a simulated device with limited capabilities.