onesignal-expo-plugin 2.0.3 → 2.1.0

package/CHANGELOG.md

@@ -1,83 +0,0 @@
-# Changelog
-All notable changes to this project will be documented in this file.
-
-## April 2023
-### `1.3.2` - 04/18/23
-#### Changes
-- Update iOS generation to write xcode project via expo mod rather than directly to file system.
-- Bump qs from 6.5.2 to 6.5.3
-- Bump decode-uri-component from 0.2.0 to 0.2.2 
-- Bump @xmldom/xmldom from 0.7.5 to 0.7.10
-- Bump multiple dependency versions in OneSignal Example App (ua-parser-js, decode-uri-component, @sideway/formula, @xmldom/xmldom)
-
-## March 2023
-### `1.3.1` - 03/03/23
-#### Changes
-- Update monorepo logic to rely on the more reliable `require.resolve` to find the `onesignal-expo-plugin` package.
-
-## November 2022
-### `1.3.0` - 11/30/22
-#### Changes
-- Add `iosNSEFilePath` configuration options to the plugin, which allows an app to specify a custom iOS Notification Service Extension.
-
-## October 2022
-### `1.2.0` - 10/25/22
-#### Changes
-- Add `smallIcons` and `largeIcons` configuration options to the plugin, which allows an app to specify large and small notification icons to package within the Android build.
-- Bump jpeg-js from 0.4.3 to 0.4.4
-- Bump simple-plist from 1.3.0 to 1.3.1
-
-### `1.1.2` - 10/04/22
-#### Fixes
-- Specify `use_frameworks` on `OneSignalNotificationServiceExtension` target in iOS Podfile when applicable (i.e. the app target also specifies `use_frameworks`).
-
-## September 2022
-### `1.1.1` - 09/06/22
-#### Fixes
-- Fix issue where EAS release builds were no longer successfully building due to log statement
-
-### `1.1.0` - 09/01/22
-#### Changes
-- No longer inject the OneSignal Gradle plugin on Android builds
-#### Fixes
-- Fix issue where plugin does not support monorepos
-
-## April 2022
-### `1.0.1` - 04/11/22
-
-#### Changes
-- Add more info regarding the `expo prebuild` command to README.
-#### Fixes
-- Upstream EAS workaround for "Missing Push Capability on iOS" issue. Adds `aps-environment` entitlement to NSE template. Although it is **not** required in normal builds, there is an upstream limitation from EAS that is resolved by including the push entitlement in both target entitlement files. As of 4/8/22, EAS builds will randomly pick an entitlement file if there are multiple in a project without differentiating among targets. This is resulting in flaky builds where half the time they work and half the time they don't. This can be seen as a temporary fix. Note it carries no side-effects / repercussions (i.e: the entitlement is superfluous but not critical to remove in the future).
-
-## March 2022
-### `1.0.0` - 03/28/22
-
-#### Fixes
-- Upgrade dependencies (via dependabot)
-#### Changes
-- Add credentials guide and update README
-- Advance to General Availability
-
-## February 2022
-### `1.0.0-beta11` - 02/18/2022
-#### Added
-- Linting
-- Instead of creating a "WriterManager", we repurpose the ReaderManager class by renaming it to FileManager and adding a synchronized write helper function (synchronous in the sense that it block further execution until complete).
-- iOS constants file
-
-#### Fixes
-- Import cleanups
-- Linting errors
-- Write safety issu. NSE updater helper functions were previously writing to the entitlements & plist files asynchronously. We should await on each to ensure we don't have multiple writes to the same file at once (which is unsafe).
-
-## January 2022
-
-### `1.0.0-beta10` - 01/24/2022
-#### Added
-- ability to configure version numbers used in the NSE target's plist file.
-- `OneSignalLog` class for better console logging.
-- this changelog file.
-
-#### Fixed
-- re-running `expo prebuild` will no longer result in duplicate entitlements and dependencies added to native files.

package/EAS.md

@@ -1,21 +0,0 @@
-# Expo Application Services
-EAS is Expo's cloud-build service.
-
-## [EAS Homepage](https://expo.dev/eas)
-
-## EAS + OneSignal Setup
-To get OneSignal push notifications working in an EAS-built app, see our guide on how to configure your [iOS credentials](IOS_CREDENTIALS_EAS.md).
-
-## How to run an iOS EAS-built app
-### Run in a production environment
-For production builds, your generated ipa file should to be distributed to the App Store or Testflight.
-
-
-### Run in custom development client
-For development/internal distribution builds, you will need to install a [development client](https://docs.expo.dev/development/getting-started/) on your iOS device.
-
-1. Scan the QR code shown in the terminal after EAS build success and install the development client application to your device.
-2. In the terminal, run `expo start --dev-client` to be able to serve the application to the client.
-3. Scan the generated QR code to open the dev client and fetch the app bundle from the running Expo process.
-4. You may be prompted to allow the app to find local area network devices. Approve.
-5. Rescan the QR code & open the app. At this point, you should see the metro bundler working. As soon as the bundle is complete, your working app should open!

package/IOS_CREDENTIALS_EAS.md

@@ -1,170 +0,0 @@
-# iOS Credentials Guide: OneSignal + EAS
-## Overview
-To distribute your iOS application, you must set up all the credentials required by Apple. The 3 primary iOS credentials are:
-* Distribution certificate
-* Provisioning profiles
-* Push notification certificate
-
-If you are using EAS, you may be letting Expo handle all your credentials. This is fine for your distribution and provisioning credentials. However, the push notification certificate *must* be set up separately since you are using OneSignal.
-
-### Push Notification Certificate
-To set up OneSignal on iOS, you will need a [push notification certificate](https://documentation.onesignal.com/docs/generate-an-ios-push-certificate). The push certificate is used to send notifications to devices and has nothing to do with the build process. After you have uploaded the certificate to OneSignal, it should just work.
-
-### Capabilities
-As of eas-cli `v0.52.0`, the previous capabilities issues should now be resolved. See the [release notes](https://github.com/expo/eas-cli/releases/tag/v0.52.0) for details.
-
-You can still view the old instructions by clicking below.
-
-<details>
-  <summary>Click to expand</summary>
-
----
-To receive notifications, you must add the `aps-environment` capability (Push Notifications) to your app at build time. The OneSignal plugin tries to facilitate this as much as possible but there could be complications if you added other capabilities/entitlements or another config plugin did. This is because EAS doesn't currently respect entitlement files on a per-target basis. If there are more than one entitlements files, it simply picks one and applies it to both targets.
-
-Due to this, there are two setup paths:
-1. A **simple setup** is one in which the only [capability](https://docs.expo.dev/build-reference/ios-capabilities/) on your main target is "Push Notifications."
-2. A more **complex setup** is one in which you have other capabilities.
-
-This also affects how you should set up your credentials. Use the following table to know whether to proceed with local or managed credentials:
-| Push Notification capability only |                                                                       |
-|-----------------------------------|-----------------------------------------------------------------------|
-| Local credentials                 | Works but unnecessary to go through extra effort to use local signing |
-| Managed credentials               | Works (simple setup)                                                                 |
-
-| Multiple capabilities |                                  |
-|-----------------------|----------------------------------|
-| Local credentials     | Works but requires complex setup |
-| Managed credentials   | Works unreliably                 |
-
-If you are unsure, run `expo prebuild` and look at the native entitlements file of your main target (in `ios` directory). Other config plugins may be adding capabilities here. Or check the full [capabilities](https://docs.expo.dev/build-reference/ios-capabilities/#supported-capabilities) list supported by Expo.
-
-
-#### Simple setup explanation
-Since there is only one capability (Push Notifications) required by your app, everything should just work. OneSignal will automatically add the capability to your app along with the necessary App Groups and EAS should sync them with your Apple Developer account. You can choose to use managed signing on EAS without a problem. This works because OneSignal will add the capability to both targets' entitlements files.
-
-#### Complex setup explanation
-Having additional capabilities on your app will result in a more complex setup, including having to use local credentials. The following is an explanation of why. It is not imperative to understand but we have included it for context.
-
-The OneSignal plugin will create an additional target: `OneSignalNotificationServiceExtension`. This target is the iOS service extension that adds support for Confirmed Deliveries, badges, media attachments, action buttons, and influenced opens (Firebase Analytics). Learn more [here](https://documentation.onesignal.com/docs/service-extensions). The plugin will automatically add app groups to both targets' entitlements files which are required if you want to make use of these features. They allow your app to execute code when a notification is received, even if your app is not active.
-
-Each target has an entitlement file. If there are multiple entitlements files per project, EAS will randomly pick one and apply it to both targets. To mitigate this, we have added the push capability entilement to both files (even though it's really only necessary in the main target). This can still pose a problem if it picks the NSE's entitlements file since it *could* break any other capabilities in your project, given that file will not have capabilities added to your main target by yourself or other plugins.
-
-The following section details how to mitigate these issues and not break your other capabilities.
-
-## Complex Setup
-
-### 1. Credentials setup
-To build successfully, you will need to create and use local credentials (one for production and development). Add `"credentialsSource": "local"` to your `eas.json` file.
-
-**Example:**
-```json
-{
-  "build": {
-    "release": {
-      "android": {
-        "gradleCommand": ":app:bundleRelease"
-      },
-      "ios": {
-        "credentialsSource": "local",
-        "buildConfiguration": "Release"
-      }
-    },
-    "development": {
-      "developmentClient": true,
-      "distribution": "internal",
-      "credentialsSource": "local"
-    }
-  }
-}
-```
-
-### 2. Identifiers
-In your [Apple developer console](https://developer.apple.com) create two identifiers with the following format:
-   - `<com.example.app>` <-- you likely already have this one
-   - `<com.example.app>.OneSignalNotificationServiceExtension`
-
-#### When modifying your existing main app identifier:
-   - add the App Groups capability like so: `group.<identifier>.onesignal`
-   - keep / add the "Push Notifications" capability
-
-#### When creating a new identifier for `OneSignalNotificationServiceExtension`:
-   - select AppId from the list of identifier types
-   - select App when choosing between App and App Clip
-   - add the App Groups capability like so: `group.<identifier>.onesignal`
-   - do not add the "Push Notifications" capability
-
-#### Note on App Groups at Build Time:
-Make sure to build with both identifiers containing the AppGroup simultaneously. To troubleshoot, remove them both and then rebuild with both identifiers' AppGroup capabilities enabled.
-
-### 3. Provisioning
-Create AdHoc (local development) and AppStore (production) provisioning profiles with both identifiers (four provisioning profiles total). Both provisioning profiles should use the same distribution certificate that is used by your app. Download the profiles.
-
-### 4. Add the profiles to your `credentials.json` file:
-Use the same distribution certificate for the `OneSignalNotificationServiceExtension` as is used for your app (no need to create a new cert).
-
-We recommend creating a `certs` directory in your project with subdirectories for each build type (e.g: `certs/adhoc` & `certs/appstore`). Doing so, you can more easily switch which provisioning profiles get used at build time.
-
-**Directory structure:**
-```
-/certs
-   - /adhoc
-   - /appstore
-```
-
-**Example `credentials.json`:**
-```json
-{
-    "ios": {
-        "<PROJECT>": {
-            "distributionCertificate": {
-                "path": "certs/ios_distribution_certificate.p12",
-                "password": "***"
-            },
-            "provisioningProfilePath": "certs/adhoc/***mobileappprofile.mobileprovision"
-        },
-        "OneSignalNotificationServiceExtension": {
-            "distributionCertificate": {
-                "path": "certs/ios_distribution_certificate.p12",
-                "password": "***"
-            },
-            "provisioningProfilePath": "certs/adhoc/***onesignalprofile.mobileprovision"
-        }
-    }
-}
-```
-
-**Note:** your push certificate (p12) file should not appear anywhere in the `credentials.json` file.
-
-## Build (complex setup continued)
-
-**IMPORTANT**: run the `eas build` command with `EXPO_NO_CAPABILITY_SYNC` if you want to prevent EAS from syncing capabilities (e.g: overwriting the steps you took in the complex setup).
-
-### Release
-If you are ready for a production build, you should use the AppStore provisioning profiles you created. Make sure your `credentials.json` file is using the correct profiles.
-
-### Development
-The development build will use the AdHoc provisioning profiles you created. Make sure your `credentials.json` file is using the correct profiles.
-
----
-</details>
-
-### Expo development client
-If you haven't already, add the expo development client to your project:
-
-```sh
-expo install expo-dev-client
-```
-
-Make sure `"developmentClient": true,` is set in your `eas.json` development build profile.
-
-### Run the EAS build command
-```sh
-eas build --profile <build profile> --platform ios
-```
-where `<build profile>` refers to the build profile in your `eas.json` file (e.g: "development" vs "release").
-
-### Build success
-At this point, your build should succeed. You can check its progress by opening the build link in the terminal.
-
-## How to run on your device
-See our [EAS guide](EAS.md) for instructions.

package/onesignal/withOneSignal.ts

@@ -1,28 +0,0 @@
-/**
- * Expo config plugin for One Signal
- * @see https://documentation.onesignal.com/docs/react-native-sdk-setup#step-4-install-for-ios-using-cocoapods-for-ios-apps
- */
-
-import { ConfigPlugin } from '@expo/config-plugins';
-import { OneSignalPluginProps } from '../types/types';
-import { withOneSignalAndroid } from './withOneSignalAndroid';
-import { withOneSignalIos } from './withOneSignalIos';
-import { validatePluginProps } from '../support/helpers';
-
-const withOneSignal: ConfigPlugin<OneSignalPluginProps> = (config, props) => {
-  // if props are undefined, throw error
-  if (!props) {
-    throw new Error(
-      'You are trying to use the OneSignal plugin without any props. Property "mode" is required. Please see https://github.com/OneSignal/onesignal-expo-plugin for more info.'
-    );
-  }
-
-  validatePluginProps(props);
-
-  config = withOneSignalIos(config, props);
-  config = withOneSignalAndroid(config, props);
-
-  return config;
-};
-
-export default withOneSignal;

package/onesignal/withOneSignalAndroid.ts

@@ -1,147 +0,0 @@
-/**
- * Expo config plugin for OneSignal (Android)
- * @see https://documentation.onesignal.com/docs/react-native-sdk-setup#step-4-install-for-ios-using-cocoapods-for-ios-apps
- */
-
-import { ConfigPlugin, withDangerousMod, withStringsXml } from '@expo/config-plugins';
-import { generateImageAsync } from '@expo/image-utils';
-import { OneSignalLog } from '../support/OneSignalLog';
-import { OneSignalPluginProps } from '../types/types';
-import { resolve, parse } from 'path';
-import { existsSync, mkdirSync, writeFileSync } from 'fs';
-
-const RESOURCE_ROOT_PATH = 'android/app/src/main/res/';
-
-// The name of each small icon folder resource, and the icon size for that folder.
-const SMALL_ICON_DIRS_TO_SIZE: { [name: string]: number } = {
-        'drawable-mdpi': 24,
-        'drawable-hdpi': 36,
-        'drawable-xhdpi': 48,
-        'drawable-xxhdpi': 72,
-        'drawable-xxxhdpi': 96
-  };
-
-// The name of each large icon folder resource, and the icon size for that folder.
-const LARGE_ICON_DIRS_TO_SIZE: { [name: string]: number } = {
-        'drawable-xxxhdpi': 256
-  };
-
-const withSmallIcons: ConfigPlugin<OneSignalPluginProps> = (
-  config,
-  onesignalProps
-) => {
-
-  if(!onesignalProps.smallIcons && !config.notification?.icon) {
-    return config
-  }
-
-  // we are modifying the android build (adding files) without a base mod
-  return withDangerousMod(config, [
-    'android',
-    async (config) => {
-      if(config.notification?.icon) {
-        await saveIconAsync(config.notification.icon, config.modRequest.projectRoot, SMALL_ICON_DIRS_TO_SIZE)
-      }
-
-      if(onesignalProps.smallIcons) {
-        await saveIconsArrayAsync(config.modRequest.projectRoot, onesignalProps.smallIcons, SMALL_ICON_DIRS_TO_SIZE);
-      }
-      return config;
-    },
-  ]);
-};
-
-const withLargeIcons: ConfigPlugin<OneSignalPluginProps> = (
-  config,
-  onesignalProps
-) => {
-
-  if(!onesignalProps.largeIcons) {
-    return config
-  }
-
-  // we are modifying the android build (adding files) without a base mod
-  return withDangerousMod(config, [
-    'android',
-    async (config) => {
-      if(onesignalProps.largeIcons) {
-        await saveIconsArrayAsync(config.modRequest.projectRoot, onesignalProps.largeIcons, LARGE_ICON_DIRS_TO_SIZE);
-      }
-      return config;
-    },
-  ]);
-};
-
-const withSmallIconAccentColor: ConfigPlugin<OneSignalPluginProps> = (config, onesignalProps) => {
-  if(!onesignalProps.smallIconAccentColor) {
-    return config
-  }
-
-  return withStringsXml(config, (config) => {
-    const colorInARGB = `FF${onesignalProps.smallIconAccentColor?.replace('#', '')}`;
-    const strings = config.modResults.resources.string ?? [];
-
-    // Check if the accent color entry already exists
-    const hasAccentColor = strings.some(
-      (stringEntry) =>
-        stringEntry.$?.name === 'onesignal_notification_accent_color' &&
-        stringEntry._ === colorInARGB
-    );
-
-    if (!hasAccentColor) {
-      const accentColorEntry = {
-        $: { name: 'onesignal_notification_accent_color' },
-        _: colorInARGB,
-      };
-
-      config.modResults.resources.string = [...strings, accentColorEntry];
-    }
-
-    return config;
-  });
-}
-
-async function saveIconsArrayAsync(projectRoot: string, icons: string[], dirsToSize: { [name: string]: number }) {
-  for(const icon of icons) {
-    await saveIconAsync(icon, projectRoot, dirsToSize);
-  }
-}
-
-async function saveIconAsync(icon: string, projectRoot: string, dirsToSize: { [name: string]: number }) {
-  const name = parse(icon).name;
-
-  OneSignalLog.log("Saving icon " + icon + " as drawable resource " + name);
-
-  for(const iconResourceDir in dirsToSize) {
-    const path = resolve(projectRoot, RESOURCE_ROOT_PATH, iconResourceDir);
-
-    if(!existsSync(path)) {
-      mkdirSync(path, { recursive: true });
-    }
-
-    const resizedIcon = (
-      await generateImageAsync(
-        { projectRoot, cacheType: 'onesignal-icon' },
-        {
-          src: icon,
-          width: dirsToSize[iconResourceDir],
-          height: dirsToSize[iconResourceDir],
-          resizeMode: 'cover',
-          backgroundColor: 'transparent',
-        }
-      )
-    ).source;
-
-    writeFileSync(resolve(path, name + '.png'), resizedIcon);
-  }
-}
-
-export const withOneSignalAndroid: ConfigPlugin<OneSignalPluginProps> = (
-  config,
-  props,
-) => {
-  config = withSmallIcons(config, props);
-  config = withLargeIcons(config, props);
-  config = withSmallIconAccentColor(config, props);
-  return config;
-};