Android Alarm Clock Plugin for Flutter

This plugin allows Flutter apps to operate with the default clock application when the platform is Android. Provides a lightweight wrapper around clock app intents. It uses Android intents to communicate with the default clock app.

Currently supported features

Create new Alarms
Create new Timer
Open default Clock app showing Alarms
Open default Clock app showing Timers

Usage

Create an Alarm

Create a new alarm. Function arguments:
'hour' specifies alarm hour
'minutes' specifies alarm minutes
'title' specifies alarm title - optional
'skipUi' specifies whether clock app should open or not - optional

// Create an alarm at 23:59
FlutterAlarmClock.createAlarm(23, 59);

Create a Timer

Create a new timer. Function arguments:
'length' specifies timer length in seconds
'title' specifies timer title - optional
'skipUi' specifies whether clock app should open or not - optional

// Create a timer for 42 seconds
FlutterAlarmClock.createTimer(42);

Show Alarms

Opens default clock app showing alarms.

FlutterAlarmClock.showAlarms();

Show Timers

Opens default clock app showing timers.

FlutterAlarmClock.showTimers();

Feel free to add support for additional functionality.

Note that a similar method does not currently exist for iOS.

Platform Support

Android
✔️

Example App

Screenshot

Code

import 'package:flutter/material.dart';
import 'package:flutter_alarm_clock/flutter_alarm_clock.dart';


void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({Key? key}) : super(key: key);

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Flutter alarm clock example'),
        ),
        body: Center(
            child: Column(children: <Widget>[
          Container(
            margin: const EdgeInsets.all(25),
            child: TextButton(
              child: const Text(
                'Create alarm at 23:59',
                style: TextStyle(fontSize: 20.0),
              ),
              onPressed: () {
                FlutterAlarmClock.createAlarm(23, 59);
              },
            ),
          ),
          Container(
            margin: const EdgeInsets.all(25),
            child: TextButton(
              child: const Text(
                'Show alarms',
                style: TextStyle(fontSize: 20.0),
              ),
              onPressed: () {
                FlutterAlarmClock.showAlarms();
              },
            ),
          ),
          Container(
            margin: const EdgeInsets.all(25),
            child: TextButton(
              child: const Text(
                'Create timer for 42 seconds',
                style: TextStyle(fontSize: 20.0),
              ),
              onPressed: () {
                FlutterAlarmClock.createTimer(42);
              },
            ),
          ),
          Container(
            margin: const EdgeInsets.all(25),
            child: TextButton(
              child: const Text(
                'Show Timers',
                style: TextStyle(fontSize: 20.0),
              ),
              onPressed: () {
                FlutterAlarmClock.showTimers();
              },
            ),
          ),
        ])),
      ),
    );
  }
}

can you tell me what i should do ? please

Reproducible code：

import 'package:flutter/material.dart';
// ignore: depend_on_referenced_packages
import 'package:android_alarm_manager_plus/android_alarm_manager_plus.dart';
import 'package:flutter_alarm_clock/flutter_alarm_clock.dart';

void main() async {
  // initialize AlarmClockManager service

  runApp(const MyApp());
  await AndroidAlarmManager.initialize();
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  // This widget is the root of your application.
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: const MyHomePage(title: 'Flutter Demo Home Page'),
    );
  }
}

class MyHomePage extends StatefulWidget {
  const MyHomePage({super.key, required this.title});

  final String title;

  @override
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  //  定时器任务
  // Future<void> main() async {
  //   final int periodicId = 0;
  //   final int oneshotId = 0;
  //   final int oneshotAtId = 0;

  //   print("main alarm run");

  // }

  bool isOn = false;
  bool edit = true;
  int alarmId = 1;
  TextEditingController hc = TextEditingController();
  TextEditingController mc = TextEditingController();

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(widget.title),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            TextField(
              enabled: edit,
              keyboardType: TextInputType.number,
              decoration: InputDecoration(
                labelText: "Hour",
              ),
              controller: hc,
            ),
            TextField(
              enabled: edit,
              keyboardType: TextInputType.number,
              decoration: InputDecoration(
                labelText: "minutes",
              ),
              controller: mc,
            ),
            Transform.scale(
              scale: 2,
              child: Switch(
                  value: isOn,
                  onChanged: ((value) {
                    setState(() {
                      isOn = value;
                      edit = !edit;
                    });
                    if (isOn == true) {
                      var h = hc.text;
                      var m = mc.text;
                      print("$h $m");
                      AndroidAlarmManager.oneShotAt(
                        DateTime(2022, 09, 26, int.parse(h), int.parse(m), 00),
                        alarmId,
                        setAlarmClock,
                        // () => FlutterAlarmClock.createAlarm(23, 59),
// your code
                      );
                    } else {
                      AndroidAlarmManager.cancel(alarmId);
                      print('Alarm Timer Canceled');
                    }
                  })),
            ),
            TextButton(
                onPressed: () {
                  setAlarmClock();
                  // FlutterAlarmClock.createAlarm(23, 59);
                },
                child: const Text("clock"))
          ],
        ),
      ),
      // This trailing comma makes auto-formatting nicer for build methods.
    );
  }
}

void setAlarmClock() {
  print('Alarm Fired at ${DateTime.now()}');
  FlutterAlarmClock.createAlarm(23, 59);
}

issue：

E/MethodChannel#flutter_alarm_clock(26487): Failed to handle method call E/MethodChannel#flutter_alarm_clock(26487): kotlin.UninitializedPropertyAccessException: lateinit property activity has not been initialized E/MethodChannel#flutter_alarm_clock(26487): at tech.sebastjanmevlja.flutter_alarm_clock.FlutterAlarmClockPlugin.createAlarm(FlutterAlarmClockPlugin.kt:111) E/MethodChannel#flutter_alarm_clock(26487): at tech.sebastjanmevlja.flutter_alarm_clock.FlutterAlarmClockPlugin.onMethodCall(FlutterAlarmClockPlugin.kt:57) E/MethodChannel#flutter_alarm_clock(26487): at io.flutter.plugin.common.MethodChannel$IncomingMethodCallHandler.onMessage(MethodChannel.java:262) E/MethodChannel#flutter_alarm_clock(26487): at io.flutter.embedding.engine.dart.DartMessenger.invokeHandler(DartMessenger.java:295) E/MethodChannel#flutter_alarm_clock(26487): at io.flutter.embedding.engine.dart.DartMessenger.lambda$dispatchMessageToQueue$0$io-flutter-embedding-engine-dart-DartMessenger(DartMessenger.java:319) E/MethodChannel#flutter_alarm_clock(26487): at io.flutter.embedding.engine.dart.DartMessenger$$ExternalSyntheticLambda0.run(Unknown Source:12) E/MethodChannel#flutter_alarm_clock(26487): at android.os.Handler.handleCallback(Handler.java:938) E/MethodChannel#flutter_alarm_clock(26487): at android.os.Handler.dispatchMessage(Handler.java:99) E/MethodChannel#flutter_alarm_clock(26487): at android.os.Looper.loopOnce(Looper.java:233) E/MethodChannel#flutter_alarm_clock(26487): at android.os.Looper.loop(Looper.java:344) E/MethodChannel#flutter_alarm_clock(26487): at android.app.ActivityThread.main(ActivityThread.java:8212) E/MethodChannel#flutter_alarm_clock(26487): at java.lang.reflect.Method.invoke(Native Method) E/MethodChannel#flutter_alarm_clock(26487): at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:584) E/MethodChannel#flutter_alarm_clock(26487): at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1034) E/flutter (26487): [ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: PlatformException(error, lateinit property activity has not been initialized, null, kotlin.UninitializedPropertyAccessException: lateinit property activity has not been initialized E/flutter (26487): at tech.sebastjanmevlja.flutter_alarm_clock.FlutterAlarmClockPlugin.createAlarm(FlutterAlarmClockPlugin.kt:111) E/flutter (26487): at tech.sebastjanmevlja.flutter_alarm_clock.FlutterAlarmClockPlugin.onMethodCall(FlutterAlarmClockPlugin.kt:57) E/flutter (26487): at io.flutter.plugin.common.MethodChannel$IncomingMethodCallHandler.onMessage(MethodChannel.java:262) E/flutter (26487): at io.flutter.embedding.engine.dart.DartMessenger.invokeHandler(DartMessenger.java:295) E/flutter (26487): at io.flutter.embedding.engine.dart.DartMessenger.lambda$dispatchMessageToQueue$0$io-flutter-embedding-engine-dart-DartMessenger(DartMessenger.java:319) E/flutter (26487): at io.flutter.embedding.engine.dart.DartMessenger$$ExternalSyntheticLambda0.run(Unknown Source:12) E/flutter (26487): at android.os.Handler.handleCallback(Handler.java:938) E/flutter (26487): at android.os.Handler.dispatchMessage(Handler.java:99) E/flutter (26487): at android.os.Looper.loopOnce(Looper.java:233) E/flutter (26487): at android.os.Looper.loop(Looper.java:344) E/flutter (26487): at android.app.ActivityThread.main(ActivityThread.java:8212) E/flutter (26487): at java.lang.reflect.Method.invoke(Native Method) E/flutter (26487): at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:584) E/flutter (26487): at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1034) E/flutter (26487): ) E/flutter (26487): #0 StandardMethodCodec.decodeEnvelope (package:flutter/src/services/message_codecs.dart:653:7) E/flutter (26487): #1 MethodChannel._invokeMethod (package:flutter/src/services/platform_channel.dart:296:18) E/flutter (26487): E/flutter (26487):

bug question

LicensesDialog is an open source library to display licenses of third-party libraries in an Android app.

while i am using "android_alarm_manager_plus", I failed it to create "createAlarm" in the callback function
can you tell me what i should do ? please

Reproducible code：

import 'package:flutter/material.dart'; // ignore: depend_on_referenced_packages import 'package:android_alarm_manager_plus/android_alarm_manager_plus.dart'; import 'package:flutter_alarm_clock/flutter_alarm_clock.dart'; void main() async { // initialize AlarmClockManager service runApp(const MyApp()); await AndroidAlarmManager.initialize(); } class MyApp extends StatelessWidget { const MyApp({super.key}); // This widget is the root of your application. @override Widget build(BuildContext context) { return MaterialApp( title: 'Flutter Demo', theme: ThemeData( primarySwatch: Colors.blue, ), home: const MyHomePage(title: 'Flutter Demo Home Page'), ); } } class MyHomePage extends StatefulWidget { const MyHomePage({super.key, required this.title}); final String title; @override State<MyHomePage> createState() => _MyHomePageState(); } class _MyHomePageState extends State<MyHomePage> { // 定时器任务 // Future<void> main() async { // final int periodicId = 0; // final int oneshotId = 0; // final int oneshotAtId = 0; // print("main alarm run"); // } bool isOn = false; bool edit = true; int alarmId = 1; TextEditingController hc = TextEditingController(); TextEditingController mc = TextEditingController(); @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: Text(widget.title), ), body: Center( child: Column( mainAxisAlignment: MainAxisAlignment.center, children: <Widget>[ TextField( enabled: edit, keyboardType: TextInputType.number, decoration: InputDecoration( labelText: "Hour", ), controller: hc, ), TextField( enabled: edit, keyboardType: TextInputType.number, decoration: InputDecoration( labelText: "minutes", ), controller: mc, ), Transform.scale( scale: 2, child: Switch( value: isOn, onChanged: ((value) { setState(() { isOn = value; edit = !edit; }); if (isOn == true) { var h = hc.text; var m = mc.text; print("$h $m"); AndroidAlarmManager.oneShotAt( DateTime(2022, 09, 26, int.parse(h), int.parse(m), 00), alarmId, setAlarmClock, // () => FlutterAlarmClock.createAlarm(23, 59), // your code ); } else { AndroidAlarmManager.cancel(alarmId); print('Alarm Timer Canceled'); } })), ), TextButton( onPressed: () { setAlarmClock(); // FlutterAlarmClock.createAlarm(23, 59); }, child: const Text("clock")) ], ), ), // This trailing comma makes auto-formatting nicer for build methods. ); } } void setAlarmClock() { print('Alarm Fired at ${DateTime.now()}'); FlutterAlarmClock.createAlarm(23, 59); }

issue：

E/MethodChannel#flutter_alarm_clock(26487): Failed to handle method call E/MethodChannel#flutter_alarm_clock(26487): kotlin.UninitializedPropertyAccessException: lateinit property activity has not been initialized E/MethodChannel#flutter_alarm_clock(26487): at tech.sebastjanmevlja.flutter_alarm_clock.FlutterAlarmClockPlugin.createAlarm(FlutterAlarmClockPlugin.kt:111) E/MethodChannel#flutter_alarm_clock(26487): at tech.sebastjanmevlja.flutter_alarm_clock.FlutterAlarmClockPlugin.onMethodCall(FlutterAlarmClockPlugin.kt:57) E/MethodChannel#flutter_alarm_clock(26487): at io.flutter.plugin.common.MethodChannel$IncomingMethodCallHandler.onMessage(MethodChannel.java:262) E/MethodChannel#flutter_alarm_clock(26487): at io.flutter.embedding.engine.dart.DartMessenger.invokeHandler(DartMessenger.java:295) E/MethodChannel#flutter_alarm_clock(26487): at io.flutter.embedding.engine.dart.DartMessenger.lambda$dispatchMessageToQueue$0$io-flutter-embedding-engine-dart-DartMessenger(DartMessenger.java:319) E/MethodChannel#flutter_alarm_clock(26487): at io.flutter.embedding.engine.dart.DartMessenger$$ExternalSyntheticLambda0.run(Unknown Source:12) E/MethodChannel#flutter_alarm_clock(26487): at android.os.Handler.handleCallback(Handler.java:938) E/MethodChannel#flutter_alarm_clock(26487): at android.os.Handler.dispatchMessage(Handler.java:99) E/MethodChannel#flutter_alarm_clock(26487): at android.os.Looper.loopOnce(Looper.java:233) E/MethodChannel#flutter_alarm_clock(26487): at android.os.Looper.loop(Looper.java:344) E/MethodChannel#flutter_alarm_clock(26487): at android.app.ActivityThread.main(ActivityThread.java:8212) E/MethodChannel#flutter_alarm_clock(26487): at java.lang.reflect.Method.invoke(Native Method) E/MethodChannel#flutter_alarm_clock(26487): at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:584) E/MethodChannel#flutter_alarm_clock(26487): at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1034) E/flutter (26487): [ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: PlatformException(error, lateinit property activity has not been initialized, null, kotlin.UninitializedPropertyAccessException: lateinit property activity has not been initialized E/flutter (26487): at tech.sebastjanmevlja.flutter_alarm_clock.FlutterAlarmClockPlugin.createAlarm(FlutterAlarmClockPlugin.kt:111) E/flutter (26487): at tech.sebastjanmevlja.flutter_alarm_clock.FlutterAlarmClockPlugin.onMethodCall(FlutterAlarmClockPlugin.kt:57) E/flutter (26487): at io.flutter.plugin.common.MethodChannel$IncomingMethodCallHandler.onMessage(MethodChannel.java:262) E/flutter (26487): at io.flutter.embedding.engine.dart.DartMessenger.invokeHandler(DartMessenger.java:295) E/flutter (26487): at io.flutter.embedding.engine.dart.DartMessenger.lambda$dispatchMessageToQueue$0$io-flutter-embedding-engine-dart-DartMessenger(DartMessenger.java:319) E/flutter (26487): at io.flutter.embedding.engine.dart.DartMessenger$$ExternalSyntheticLambda0.run(Unknown Source:12) E/flutter (26487): at android.os.Handler.handleCallback(Handler.java:938) E/flutter (26487): at android.os.Handler.dispatchMessage(Handler.java:99) E/flutter (26487): at android.os.Looper.loopOnce(Looper.java:233) E/flutter (26487): at android.os.Looper.loop(Looper.java:344) E/flutter (26487): at android.app.ActivityThread.main(ActivityThread.java:8212) E/flutter (26487): at java.lang.reflect.Method.invoke(Native Method) E/flutter (26487): at com.android.internal.os.RuntimeInit$MethodAndArgsCaller.run(RuntimeInit.java:584) E/flutter (26487): at com.android.internal.os.ZygoteInit.main(ZygoteInit.java:1034) E/flutter (26487): ) E/flutter (26487): #0 StandardMethodCodec.decodeEnvelope (package:flutter/src/services/message_codecs.dart:653:7) E/flutter (26487): #1 MethodChannel._invokeMethod (package:flutter/src/services/platform_channel.dart:296:18) E/flutter (26487): E/flutter (26487):
bug question
opened by boziyoung 2
Alarm does not work when phone is locked

I am calling this function FlutterAlarmClock.createAlarm(16, 39); in my initState() method. The alarm works when the app is open.

But when it is removed from background or the phone is locked, the alarm does not rung.

I am testing it on Android 12.

Any help is highly appreciated. Thank you.

opened by Intihar12 2