📘

Expo Managed Workflow

This documentation shows how to use our SDK with your Expo Managed Workflow application.

If you are using the Bare Workflow, please review the React Native + Expo SDK Setup instead.

Step 1. Requirements

• OneSignal Account
• Your OneSignal App Id, available in Settings > Keys & IDs.

iOS Requirements

• An iOS 9+ or iPadOS device (iPhone, iPad, iPod Touch) to test on. The Xcode simulator doesn't support push notifications so you must test on a real device.
• A Mac with Xcode 12+.
• An iOS Push Certificate.
• Your app.json file needs the bundleIdentifier property set.

Android Requirements

• An Android 4.0.3+ device or emulator with "Google Play Store (Services)" installed.
• A Google/Firebase Server API Key.

Amazon & Huawei Requirements

Follow these instructions if your app is distributed on the Amazon AppStore and/or the Huawei AppGallery.

• Generate an Amazon API Key.
• Huawei Unity SDK Setup.

Step 2. Add the OneSignal package to your app

📘

OneSignal Expo Sample App

Sample repo containing the sample app for running OneSignal with Expo.

Make sure you have the Expo CLI installed on your computer.

2.1 Install the OneSignal Expo plugin using the Expo CLI

expo install onesignal-expo-plugin

2.2 Install the SDK using Yarn or NPM

• Yarn: yarn add react-native-onesignal
• NPM npm install --save react-native-onesignal

2.3 Configure your app.json/app.config.js
Add the plugin to the plugin array:

app.json

{
  "plugins": [
    [
      "onesignal-expo-plugin",
      {
        "mode": "development",
      }
    ]
  ]
}

or

app.config.js

export default {
  ...
  plugins: [
    [
      "onesignal-expo-plugin",
      {
        mode: "development",
      }
    ]
  ]
};

Plugin Prop
You can pass props to the plugin config object to configure:

**
2.4 Adding the OneSignal App ID

Add your OneSignal App ID to your Expo constants via the extra param:

{
  "extra": {
    "oneSignalAppId": "<YOUR APP ID HERE>"
  }
}

You can then access the value to pass to the setAppId function:

import OneSignal from 'react-native-onesignal';
import Constants from "expo-constants";
OneSignal.setAppId(Constants.manifest.extra.oneSignalAppId);

Alternatively, pass the OneSignal app ID directly to the function:

OneSignal.setAppId("YOUR-ONESIGNAL-APP-ID");

2.5 Run your Expo app

$ expo prebuild

# Build your native iOS project
$ expo run:ios

# Build your native Android project
$ expo run:android