alarm 4.0.3

A simple Flutter alarm manager plugin for both iOS and Android.

4.0.3

• [Android] Fixed error when rescheduling old version alarm after reboot.

4.0.2

• [iOS] Improve thread safety.
• [Android] Add native backward compatibility with older versions.

4.0.1

• [iOS] Fixed crash on iOS when setting warning notification on kill.

4.0.0

💥 Breaking Changes

• Added notification action stop button.
• Refactored AlarmSettings model.
• Ignore oncoming alarm if another alarm is ringing.
• [Android] Updated kotlin version to 1.8.0.
• [Android] Added customizable notification icon.
• [Android] Reschedule alarms after device reboot.
• [iOS] Removed notification permission request. Must be handled in-app to match Android behaviour.

4.0.0-dev.5

💥 Breaking Changes

• [iOS] Removed notification permission request. Must be handled in-app to match Android behaviour.

4.0.0-dev.4

• [Android] Reschedule alarms after device reboot.

4.0.0-dev.3

💥 Breaking Changes

• Refactored AlarmSettings model.
• Ignore oncoming alarm if another alarm is ringing.
• [Android] Add customizable notification icon.
• [Android] Update kotlin version to 1.8.0.

4.0.0-dev.2

• [Android] Fix native GSON parsing error.
• Update flutter_fgbg dependency.

4.0.0-dev.1

• Add notification action stop button.

3.1.7

• [Android] Update kotlin version to 1.7.10.

3.1.6

• Update flutter_fgbg dependency to 0.6.0.
• Update shared_preferences dependency to 2.3.2.

3.1.5

• [Android] Fix volume/focus post-alarm.
• Export AlarmSettings class in Alarm class.

3.1.4

• [Android] Add more type safety.

3.1.3

🔧 Android installation steps were updated here.

• [Android] Remove notification large icon.

3.1.2

• [Android] Fix alarm stop on app open.

3.1.1

• [Android] Fix notifications icon for some OEM.

3.1.0

• [Android] Fix ring stream issue.
• [Android] Increment compileSdkVersion to 34.
• [Android] Update installation steps & documentation.

3.0.14

• [Android] Update PendingIntent flags in AlarmReceiver.

3.0.13

• [iOS] Fix EXC_BAD_ACCESS errors.
• [Android] Improve error handling.
• Improve Dart code quality: apply very_good_analysis lint rules.
• Add minor updates in documentation.

3.0.12

• [Android] Fix BackgroundServiceStartNotAllowedException.
• [Android] Fix alarm ring on app launch.

3.0.11

• Improve alarm reschedule on init.

3.0.10

• [Android] Add relative audio path support.

3.0.9

• [iOS] Add concurrency handling.
• [iOS] Make iOS notification show in foreground.

3.0.8

• Fix alarm id verification.

3.0.7

• Prevent if integer overflow.
• [Android] Improve error handling. Add exceptions with better messages.
• [iOS] Add support for subfolder local audio path.

3.0.6

• [Android] Add notification large icon.
• [Android] Add Gradle 8 support.
• [Android] Fix delay integer overflow when delay is more than a month.

3.0.5

• Keep notification when audio's over.

3.0.4

• [Android] Add FOREGROUND_SERVICE_MEDIA_PLAYBACK permission.
• [Android] Fix vibrations for versions below API 26.

3.0.3

• [Android] Fix errors with specific Android versions.
• Call stopAlarm when loopAudio is false and audio ends.

3.0.2

• [Android] Fix local audio file playback. Add READ_EXTERNAL_STORAGE permission in the manifest and request it at runtime to prevent access errors.

3.0.1

• Only override an existing alarm if it's scheduled for the identical second.

3.0.0

💥 Breaking Changes 🔧 Android installation steps were updated here.

• [Android] Alarm will work even if app was killed.
• [Android] Notification are now mandatory so foreground services can be used.
• [iOS] Notifications are now native. flutter_local_notifications dependency was removed.
• Remove [stopOnNotificationOpen] property.
• Replace [volumeMax] with [volume] double property.

3.0.0-dev.8

• [Android] Fix notification delay for Android 12 and above.
• [Android] Abandon audio focus + stop vibrating when loopAudio is false and audio is over.

3.0.0-dev.7

• [Android] Fix notification delay and sound.

3.0.0-dev.6

• [Android] Fix alarms for Android API 31 and above.
• [iOS] Fix audio player fade duration.
• [iOS] Fix on-app-kill notification.

3.0.0-dev.5

• Improve README and installation guides.
• [iOS] Add more error handling.
• [Android] Fix alarm for Android 12 and above.

3.0.0-dev.4

• [iOS] Remove notification sound.
• Throw exception if alarm settings are invalid.
• Improve README.

3.0.0-dev.3

• Update README.
• Add minor improvements.

3.0.0-dev.2

• [iOS] Make native iOS notifications to remove flutter_local_notifications dependency.

3.0.0-dev.1

💥 Breaking Changes 🔧 Android installation steps were updated here.

• Remove [stopOnNotificationOpen] property.
• Make notification mandatory so android foreground services can be used.
• [Android] Refactor alarm to native android services.
• Replace [volumeMax] with [volume] double property.

2.2.0

• [Android] Move alarm service to native code.

2.1.1

• Fix AlarmSettings.fromJson method with missing [androidFullScreenIntent].

2.1.0

🔧 Android installation steps were updated here.

• [Android] Add parameter [androidFullScreenIntent] that turns screen on when alarm notification is triggered.
• [Android] Fix 'ring now' alarm delay.
• [Android] Fix fadeDuration cast error.
• Disable [stopOnNotificationOpen] by default.

2.0.1

• Update README.
• Fix example app's ring now button.
• Refactor set alarm methods.

2.0.0

💥 Breaking Changes

• Installation steps were updated in the README. Please make sure to follow them.
• [iOS] Add Background Fetch to periodically make sure alarms are still active in the background.

2.0.0-release-candidate-1

• Add minor improvements.

2.0.0-dev.5

• [iOS] Move background fetch to native.
• [Android] Fix build errors.

2.0.0-dev.4

• [iOS] Improve background fetch & audio interruptions

2.0.0-dev.3

• [iOS] Improve alarm reliability.

2.0.0-dev.2

• [iOS] Improve silent audio interruption handling.
• Add a shortcut button in example app.

2.0.0-dev.1

• [iOS] Play silent audio until alarm rings to keep app active.
• [iOS] Add Background Fetch to periodically check if app is still active.
• [iOS] Add new installation steps.

1.2.2

• Upgrade plugin's dependencies.
• Prove plugin ownership for winning OnePub competition: 961eace7-3bbb-11ee-ade6-42010ab60008

1.2.1

• Fix fromJson error on plugin init.

1.2.0

• Add [volumeMax] parameter.
• [iOS] Keep app active in background by playing silent sound in a loop.

1.1.8

• [Android] Add missing isRinging method.

1.1.7

• [iOS] Fix alarm stop.

1.1.6

• Improve error handling and coding style.

1.1.5

• [Android] Fix null isolate SendPort error on stop.

1.1.4

• Add Flutter audio asset import from Swift. It's no longer needed to import your assets in Xcode too.

1.1.3

• Remove unecessary exception on init.

1.1.2

• Fix notification schedule date.

1.1.1

• Update plugin's dependencies.
• Increment Android minimum version to API 19 (4.4).

1.1.0

• Add support for downloaded audio local files.
• Remove support for network audio files, which was unstable.

1.0.5

• Update plugin's dependencies.

1.0.4

• Add a FAQ item in README

1.0.3

• Add optional [stopOnNotificationOpen] parameter to stop alarm when notification is opened.

1.0.2

• Add getAlarm(id) method.
• [Android] Fix isolate unfound port error.

1.0.1

• [iOS] Fix alarm sound from background mode.

1.0.0

• Alarm plugin is now ready for production. Breaking changes will be released in major version releases from now.
• Add some minor improvements.
• Update README.md

0.2.9

• Add custom debug print method.

0.2.8

• [iOS] Prevent unnecessary callbacks when alarm is stopped.

0.2.7

• If [loopAudio] is set to false, stop vibrations when audio ends.
• [iOS] Avoid crash if provided audio url is wrong.

0.2.6

• [Android] Fix vibrations which were triggered even when disabled.

0.2.5

• [iOS] Fix vibrations: cancel callback if alarm is stopped.

0.2.4

• Fix zoned notification schedule date shift

0.2.3

• [Android] Fix [NotificationOnKillService] for API 31+

0.2.2

• Improve documentation.
• Add [showDebugLogs] optional parameter to [Alarm.init] method.

0.2.1

• Add optional [vibrate] parameter, to toggle vibrations when alarm rings.

0.2.0

• 💥 Breaking changes: Add multiple alarm management. Now, you have to provide a unique [id] to [AlarmSettings].
• Update example application.
• [Android] Fix potential delay between notification and alarm sound.

0.1.5

• Schedule notification with precision to the given second.

0.1.4

• [Android] Fix notification permission for Android 13.

0.1.3

• Add optional [fadeDuration] parameter, which is the duration, in seconds, over which to fade the alarm volume.

0.1.2

• Add more Android installation steps in the README.
• Add alarm behaviour details in the README.
• [Android] Fix alarm while screen is locked.

0.1.1

• Add [Alarm.hasAlarm] method.
• Fix: cancel on-application-kill notification warning when alarm starts ringing, instead of when user stops alarm.
• Export [AlarmSettings] model in [Alarm] service so it's not necessary to import it separately anymore.

0.1.0

• 💥 Breaking changes: [Alarm.set] method now takes a [AlarmSettings] as only parameter.
• 💥 Breaking changes: You will have to create a StreamSubscription attached to [Alarm.ringStream.stream] in order to listen to the alarm ringing state now. This way, even if your app was previously killed, your custom callback can still be triggered.
• By default, if an alarm was set and the app is killed, a notification will be shown to warn the user that the alarm may not ring, with the possibility to reopen the app and automatically reschedule the alarm. To disable this feature, you can call the method [Alarm.toggleNotificationOnAppKill(false)].
• Add notification on kill notification switch button in example app.
• Add some minor fixes and improvements.

0.0.5

• Add a Gist in the README.md to explain how to import assets on Xcode without adding weight to your app.

0.0.4

• [Android] Fix notification parameters.

0.0.3

• Add more documentation.
• Add plugin description in pubspec.yaml.
• Refactor some Swift code.

0.0.2

• Update links in the README.md.

0.0.1

• Initial development release.