This is not an official Expo SDK package. Alarm library to use with expo bare workflow. Tested in versions 0.64 to 0.73 of RN.
npm install expo-alarm-module
yarn add expo-alarm-module
NOTE: For Android, you will still have to manually update the AndroidManifest.xml (as below) in order to use Scheduled Notifications.
In your android/app/src/main/AndroidManifest.xml
.....
<uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM" />
<uses-permission android:name="android.permission.VIBRATE" />
<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission
android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"
android:minSdkVersion="34"
/>
<uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
<application ....>
<receiver
android:name="com.expoalarmmodule.receivers.AlarmReceiver"
android:enabled="true"
android:exported="true"
/>
<receiver
android:name="com.expoalarmmodule.receivers.BootReceiver"
android:exported="true"
>
<intent-filter>
<action android:name="android.intent.action.BOOT_COMPLETED" />
</intent-filter>
</receiver>
<receiver
android:name="com.expoalarmmodule.receivers.NotificationActionReceiver"
android:enabled="true"
android:exported="true">
<intent-filter>
<action android:name="DISMISS_ACTION" />
<action android:name="SNOOZE_ACTION" />
</intent-filter>
</receiver>
<service
android:name="com.expoalarmmodule.AlarmService"
android:foregroundServiceType="mediaPlayback"
/>
.....In your info.plist, you need to add background mode for sound and remote notifications capabilities. You also need to obtain permissions for notifications beforehand (the library asks permission when setting the notification for the first time, but if you get permission before it is better).
Since this library has a config plugin for expo, you only need to install it with expo install expo-alarm-module for it to work and add the config plugin to the plugins array of your app.json or app.config.js:
{
"expo": {
"plugins": ["expo-alarm-module"]
}
}Next, rebuild your app as described in the "Adding custom native code" guide.
For a more detailed example of usage, clone this repository and run the example application, installing the dependencies of this native module using "yarn" in the root folder and running "yarn example android" or "yarn example ios" according to your OS. Don't forget to run "pod install" in the example/ios folder for configuring the ios files.
// App.js
import React, { useEffect } from 'react';
import { View, Text, Button } from 'react-native';
import AlarmModule, { removeAlarm, scheduleAlarm, stopAlarm } from "expo-alarm-module";
const App = () => {
const alarmIn60 = () => {
var newDate = new Date();
newDate.setSeconds(newDate.getSeconds() + 60);
scheduleAlarm(
{
uid: "alarm1",
day: newDate,
title: "Title of alarm",
description: "Alarm Description",
showDismiss: true,
showSnooze: true,
snoozeInterval: 5,
repeating: true,
active: true
} as any
);
};
/* Create a new alarm 60 seconds after the current date.*/
const onStopAlarmButton = () => {
// Stops any alarm that is playing
stopAlarm();
// Removes the alarm. Also stops any alarm that is playing, so the above function stopAlarm is redundant.
removeAlarm("alarm1");
};
return (
<View style={{ flex: 1, justifyContent: 'center', alignItems: 'center' }}>
<Text>React Native Alarm Test</Text>
<Button title="Alarm in 60 seconds" onPress={alarmIn60} />
<Button title="Stop Alarm" onPress={onStopAlarmButton} />
</View>
);
};
export default App;See the contributing guide to learn how to contribute to the repository and the development workflow.
MIT
Made with create-react-native-library
To build, it is necessary to run .\gradlew clean & .\gradlew build in the android folder. Afterwards, run "npx bob build" in the root directory. After that, just publish the app with npm publish.