feat(android): Expose api to handle Android 12 REQUIRE_EXACT_ALARM pe…

…rmission (#332)

android/src/main/AndroidManifest.xml

@@ -30,7 +30,7 @@
       android:name=".ForegroundService"
       android:exported="false" />
 
-      <receiver
+    <receiver
         android:name=".RebootBroadcastReceiver"
         android:exported="false">
         <intent-filter>
@@ -40,6 +40,13 @@
         </intent-filter>
     </receiver>
 
+    <receiver
+      android:name=".AlarmPermissionBroadcastReceiver"
+      android:exported="true">
+      <intent-filter>
+        <action android:name="android.app.action.SCHEDULE_EXACT_ALARM_PERMISSION_STATE_CHANGED" />
+      </intent-filter>
+    </receiver>
 
     <receiver
       android:name=".NotificationAlarmReceiver"

android/src/main/java/app/notifee/core/AlarmPermissionBroadcastReceiver.java

@@ -0,0 +1,19 @@
+package app.notifee.core;
+
+import static android.app.AlarmManager.ACTION_SCHEDULE_EXACT_ALARM_PERMISSION_STATE_CHANGED;
+
+import android.content.BroadcastReceiver;
+import android.content.Context;
+import android.content.Intent;
+import android.util.Log;
+
+public class AlarmPermissionBroadcastReceiver extends BroadcastReceiver {
+  @Override
+  public void onReceive(Context context, Intent intent) {
+
+    if (intent.getAction().equals(ACTION_SCHEDULE_EXACT_ALARM_PERMISSION_STATE_CHANGED)) {
+      Log.i("AlarmPermissionReceiver", "Received alarm permission state changed event");
+      new NotifeeAlarmManager().rescheduleNotifications();
+    }
+  }
+}

android/src/main/java/app/notifee/core/Notifee.java

@@ -34,6 +34,7 @@
 import app.notifee.core.model.ChannelGroupModel;
 import app.notifee.core.model.ChannelModel;
 import app.notifee.core.model.NotificationModel;
+import app.notifee.core.utility.AlarmUtils;
 import app.notifee.core.utility.PowerManagerUtils;
 import java.util.ArrayList;
 import java.util.List;
@@ -119,6 +120,12 @@ public void cancelAllNotificationsWithIds(
             });
   }
 
+  @KeepForSdk
+  public void openAlarmPermissionSettings(Activity activity, MethodCallResult<Void> result) {
+    AlarmUtils.openAlarmPermissionSettings(activity);
+    result.onComplete(null, null);
+  }
+
   @KeepForSdk
   public void createChannel(Bundle channelMap, MethodCallResult<Void> result) {
     ChannelModel channelModel = ChannelModel.fromBundle(channelMap);
@@ -392,6 +399,17 @@ public void getNotificationSettings(MethodCallResult<Bundle> result) {
     } else {
       notificationSettingsBundle.putInt("authorizationStatus", 0);
     }
+
+    boolean canScheduleExactAlarms = AlarmUtils.canScheduleExactAlarms();
+    Bundle androidSettingsBundle = new Bundle();
+
+    if (canScheduleExactAlarms) {
+      androidSettingsBundle.putInt("alarm", 1);
+    } else {
+      androidSettingsBundle.putInt("alarm", 0);
+    }
+
+    notificationSettingsBundle.putBundle("android", androidSettingsBundle);
     result.onComplete(null, notificationSettingsBundle);
   }
 

android/src/main/java/app/notifee/core/NotifeeAlarmManager.java

@@ -30,6 +30,7 @@
 import app.notifee.core.database.WorkDataRepository;
 import app.notifee.core.model.NotificationModel;
 import app.notifee.core.model.TimestampTriggerModel;
+import app.notifee.core.utility.AlarmUtils;
 import app.notifee.core.utility.ObjectUtils;
 import com.google.android.gms.tasks.Continuation;
 import com.google.android.gms.tasks.Task;
@@ -118,10 +119,6 @@ static void displayScheduledNotification(Bundle alarmManagerNotification) {
             });
   }
 
-  private static AlarmManager getAlarmManager() {
-    return (AlarmManager) getApplicationContext().getSystemService(Context.ALARM_SERVICE);
-  }
-
   public static PendingIntent getAlarmManagerIntentForNotification(String notificationId) {
     try {
       Context context = getApplicationContext();
@@ -145,13 +142,14 @@ static void scheduleTimestampTriggerNotification(
 
     PendingIntent pendingIntent = getAlarmManagerIntentForNotification(notificationModel.getId());
 
-    AlarmManager alarmManager = getAlarmManager();
+    AlarmManager alarmManager = AlarmUtils.getAlarmManager();
 
     // Verify we can call setExact APIs to avoid a crash, but it requires an Android S+ symbol
     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
       if (!alarmManager.canScheduleExactAlarms()) {
         System.err.println(
-            "Missing SCHEDULE_EXACT_ALARM permission. Trigger not scheduled. Issue #239");
+            "Missing SCHEDULE_EXACT_ALARM permission. Trigger not scheduled. See:"
+                + " https://notifee.app/react-native/docs/triggers#android-12-limitations");
         return;
       }
     }
@@ -172,7 +170,7 @@ Task<List<WorkDataEntity>> getScheduledNotifications() {
 
   public static void cancelNotification(String notificationId) {
     PendingIntent pendingIntent = getAlarmManagerIntentForNotification(notificationId);
-    AlarmManager alarmManager = getAlarmManager();
+    AlarmManager alarmManager = AlarmUtils.getAlarmManager();
     if (pendingIntent != null) {
       alarmManager.cancel(pendingIntent);
     }

android/src/main/java/app/notifee/core/utility/AlarmUtils.java

@@ -0,0 +1,52 @@
+package app.notifee.core.utility;
+
+import static app.notifee.core.ContextHolder.getApplicationContext;
+
+import android.app.Activity;
+import android.app.AlarmManager;
+import android.content.Context;
+import android.content.Intent;
+import android.net.Uri;
+import android.os.Build;
+import android.provider.Settings;
+import app.notifee.core.ContextHolder;
+import app.notifee.core.Logger;
+
+public class AlarmUtils {
+  private static final String TAG = "AlarmUtils";
+
+  public static AlarmManager getAlarmManager() {
+    return (AlarmManager) getApplicationContext().getSystemService(Context.ALARM_SERVICE);
+  }
+
+  /**
+   * Attempts to open the device's alarm special access settings
+   *
+   * @param activity
+   */
+  public static void openAlarmPermissionSettings(Activity activity) {
+    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.S) {
+      return;
+    }
+
+    try {
+      Intent intent = new Intent();
+      intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
+      intent.setAction(Settings.ACTION_REQUEST_SCHEDULE_EXACT_ALARM);
+      Context context = ContextHolder.getApplicationContext();
+      String packageName = context.getPackageName();
+      intent.setData(Uri.parse("package:" + packageName));
+
+      IntentUtils.startActivityOnUiThread(activity, intent);
+    } catch (Exception e) {
+      Logger.e(TAG, "An error occurred whilst trying to open alarm permission settings", e);
+    }
+  }
+
+  public static boolean canScheduleExactAlarms() {
+    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
+      return getAlarmManager().canScheduleExactAlarms();
+    }
+    return true;
+  }
+}

docs/navigator.json

@@ -46,6 +46,7 @@
           ["/react-native/docs/android/foreground-service", "Foreground Service"],
           ["/react-native/docs/android/grouping-and-sorting", "Grouping & Sorting"],
           ["/react-native/docs/android/interaction", "Interaction"],
+          ["/react-native/docs/android/permissions", "Permissions"],
           ["/react-native/docs/android/progress-indicators", "Progress Indicators"],
           ["/react-native/docs/android/styles", "Styles"],
           ["/react-native/docs/android/timers", "Timers"],

docs/react-native/docs/triggers.md

@@ -69,15 +69,15 @@ Let's update our trigger we created previously to occur weekly.
 import notifee, { TimestampTrigger, TriggerType } from '@notifee/react-native';
 
 async function onCreateTriggerNotification() {
-    const date = new Date(Date.now());
-    date.setHours(11);
-    date.setMinutes(10);
+  const date = new Date(Date.now());
+  date.setHours(11);
+  date.setMinutes(10);
 
-    const trigger: TimestampTrigger = {
-      type: TriggerType.TIMESTAMP,
-      timestamp: date.getTime(),
-      repeatFrequency: RepeatFrequency.WEEKLY
-    };
+  const trigger: TimestampTrigger = {
+    type: TriggerType.TIMESTAMP,
+    timestamp: date.getTime(),
+    repeatFrequency: RepeatFrequency.WEEKLY,
+  };
 
   await notifee.createTriggerNotification(
     {
@@ -132,7 +132,7 @@ On Android, you have the option to create your trigger notification with Android
 ```js
 const trigger: TimestampTrigger = {
   //...
-  alarmManager: true
+  alarmManager: true,
 };
 ```
 
@@ -143,16 +143,34 @@ const trigger: TimestampTrigger = {
   //...
   alarmManager: {
     allowWhileIdle: true,
-  }
+  },
 };
 ```
 
 Please note, for iOS, a repeating trigger does not work the same as Android - the initial trigger cannot be delayed:
+
 - `HOURLY`: the starting date and hour will be ignored, and only the minutes and seconds will be taken into the account. If the timestamp is set to trigger in 3 hours and repeat every 5th minute of the hour, the alert will not fire in 3 hours, but will instead fire immediately on the next 5th minute of the hour.
 - `DAILY`: the starting day will be ignored, and only the time will be taken into account. If it is January 1 at 10 AM and you schedule a daily recurring notification for January 2 at 11 AM, it will fire on January 1 at 11 AM and every day thereafter.
 - `WEEKLY`: the starting week will be ignored, and only the day and time will be taken into account.
 
->  For more details, please see the discussion [here](https://github.com/notifee/react-native-notifee/issues/241).
+> For more details, please see the discussion [here](https://github.com/notifee/react-native-notifee/issues/241).
+
+### Android 12 Limitations
+
+Starting from Android 12, timestamp triggers cannot be created unless user specfically allow the [exact alarm permission](https://developer.android.com/reference/android/Manifest.permission#SCHEDULE_EXACT_ALARM). Before you create a timestamp trigger, check whether `SCHEDULE_EXACT_ALARM` permission is allowed by making a call to `getNotificationSettings`. If ` alarm` is `DISABLED`, you should educate the user on this permission and ask to enable scheduling alarms. You can then use `openAlarmPermissionSettings` function to display the Alarms & Reminder settings of your app.
+
+```js
+const settings = Notifee.getNotificationSettings();
+if (settings.android.alarm == AndroidNotificationSetting.ENABLED) {
+  //Create timestamp trigger
+} else {
+  // Show some user information to educate them on what exact alarm permission is,
+  // and why it is necessary for your app functionality, then send them to system preferences:
+  await Notifee.openAlarmPermissionSettings();
+}
+```
+
+Please note that if the user revokes the permission via system preferences, all of the timestamp triggers will be deleted by the system. However, if you check for the permission, notice it is missing, educate the user and they grant permission again, notifee will automatically reschedule the triggers when the user allows the alarm permission again with no need for additional code.
 
 ## Interval Trigger
 

packages/react-native/android/src/main/java/io/invertase/notifee/NotifeeApiModule.java

@@ -156,6 +156,13 @@ public void displayNotification(ReadableMap notificationMap, Promise promise) {
             (e, aVoid) -> NotifeeReactUtils.promiseResolver(promise, e));
   }
 
+  @ReactMethod
+  public void openAlarmPermissionSettings(Promise promise) {
+    Notifee.getInstance()
+        .openAlarmPermissionSettings(
+            getCurrentActivity(), (e, avoid) -> NotifeeReactUtils.promiseResolver(promise, e));
+  }
+
   @ReactMethod
   public void createTriggerNotification(
       ReadableMap notificationMap, ReadableMap triggerMap, Promise promise) {