Merge pull request '0.1.2' (#1) from dev into main

Reviewed-on: #1

.gitignore

@@ -153,3 +153,6 @@ google-services.json
 # Android Profiling
 *.hprof
 
+# Staged build files for distribution.
+*.linux-bundle.zip
+release/*

android/app/build.gradle.kts

@@ -1,15 +1,15 @@
+import org.jetbrains.kotlin.gradle.dsl.JvmTarget
+
 plugins {
     id("com.android.application")
 
-    // This will need removed in Gradle/AGP 9.
+    // This supposedly needs removed in Gradle/AGP 9 but works fine.
     id("org.jetbrains.kotlin.android") // id("kotlin-android")
 
     // The Flutter Gradle Plugin must be applied after the Android and Kotlin Gradle plugins.
     id("dev.flutter.flutter-gradle-plugin")
 }
 
-import org.jetbrains.kotlin.gradle.dsl.JvmTarget
-
 android {
     namespace = "com.hyperling.sunset_alarm"
     compileSdk = flutter.compileSdkVersion
@@ -21,7 +21,7 @@ android {
         sourceCompatibility = JavaVersion.VERSION_17
     }
 
-    // This will need removed in Gradle/AGP 9.
+    // This supposedly needs removed in Gradle/AGP 9, but then uses 21 and fails to build.
     kotlin {
         compilerOptions {
             jvmTarget.set(JvmTarget.JVM_17)
@@ -49,7 +49,7 @@ android {
 }
 
 dependencies {
-    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.4")
+    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.5")
 }
 
 flutter {

android/app/src/main/AndroidManifest.xml

@@ -1,4 +1,32 @@
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+<manifest
+    xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
+    >
+
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+    <uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM"/>
+    <uses-permission android:name="android.permission.USE_EXACT_ALARM"/>
+
+    <!--
+    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
+    <uses-permission android:name="android.permission.WAKE_LOCK"/>
+    <uses-permission android:name="android.permission.VIBRATE"/>
+    <uses-permission android:name="android.permission.USE_FULL_SCREEN_INTENT"/>
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE"/>
+    <uses-permission android:name="android.permission.ACCESS_NOTIFICATION_POLICY"/>
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
+    <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>
+    <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"/>
+    <uses-permission android:name="android.permission.USE_EXACT_ALARM"/>
+    <uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM"/>
+
+    <uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
+    <uses-permission android:name="android.permission.WAKE_LOCK"/>
+    <uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM"/>
+    -->
+
     <application
         android:label="sunset_alarm"
         android:name="${applicationName}"
@@ -30,6 +58,60 @@
         <meta-data
             android:name="flutterEmbedding"
             android:value="2" />
+
+        <receiver
+            android:name="com.dexterous.flutterlocalnotifications.ScheduledNotificationReceiver"
+            android:enabled="true" />
+        <receiver
+            android:name="com.dexterous.flutterlocalnotifications.ScheduledNotificationBootReceiver"
+            android:enabled="true"
+            android:exported="false">
+            <intent-filter>
+                <action android:name="android.intent.action.BOOT_COMPLETED" />
+                <action android:name="android.intent.action.MY_PACKAGE_REPLACED" />
+                <action android:name="android.intent.action.QUICKBOOT_POWERON" />
+                <action android:name="com.htc.intent.action.QUICKBOOT_POWERON" />
+            </intent-filter>
+        </receiver>
+
+        <!--
+        <service
+            android:name="com.gdelataillade.alarm.AlarmService"
+            android:foregroundServiceType="mediaPlayback"
+            android:exported="false" />
+
+        <receiver
+            android:name="com.gdelataillade.alarm.AlarmBroadcastReceiver"
+            android:exported="false" />
+
+        <receiver
+            android:name="com.gdelataillade.alarm.BootBroadcastReceiver"
+            android:enabled="false"
+            android:exported="false">
+            <intent-filter>
+                <action android:name="android.intent.action.BOOT_COMPLETED" />
+            </intent-filter>
+        </receiver>
+
+        <service
+            android:name="dev.fluttercommunity.plus.androidalarmmanager.AlarmService"
+            android:permission="android.permission.BIND_JOB_SERVICE"
+            android:exported="false"
+            tools:ignore="MissingClass"/>
+        <receiver
+            android:name="dev.fluttercommunity.plus.androidalarmmanager.AlarmBroadcastReceiver"
+            android:exported="false"
+            tools:ignore="MissingClass"/>
+        <receiver
+            android:name="dev.fluttercommunity.plus.androidalarmmanager.RebootBroadcastReceiver"
+            android:enabled="false"
+            android:exported="false"
+            tools:ignore="MissingClass">
+            <intent-filter>
+                <action android:name="android.intent.action.BOOT_COMPLETED" />
+            </intent-filter>
+        </receiver>
+        -->
     </application>
     <!-- Required to query activities that can process text, see:
          https://developer.android.com/training/package-visibility and
@@ -42,9 +124,4 @@
             <data android:mimeType="text/plain"/>
         </intent>
     </queries>
-
-    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION"/>
-    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION"/>
-    <uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
-    <uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM"/>
 </manifest>

android/app/src/main/res/drawable/ic_launcher_background.xml

@@ -0,0 +1,74 @@
+<?xml version="1.0" encoding="utf-8"?>
+<vector
+    android:height="108dp"
+    android:width="108dp"
+    android:viewportHeight="108"
+    android:viewportWidth="108"
+    xmlns:android="http://schemas.android.com/apk/res/android">
+    <path android:fillColor="#3DDC84"
+          android:pathData="M0,0h108v108h-108z"/>
+    <path android:fillColor="#00000000" android:pathData="M9,0L9,108"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M19,0L19,108"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M29,0L29,108"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M39,0L39,108"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M49,0L49,108"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M59,0L59,108"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M69,0L69,108"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M79,0L79,108"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M89,0L89,108"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M99,0L99,108"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M0,9L108,9"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M0,19L108,19"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M0,29L108,29"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M0,39L108,39"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M0,49L108,49"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M0,59L108,59"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M0,69L108,69"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M0,79L108,79"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M0,89L108,89"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M0,99L108,99"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M19,29L89,29"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M19,39L89,39"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M19,49L89,49"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M19,59L89,59"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M19,69L89,69"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M19,79L89,79"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M29,19L29,89"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M39,19L39,89"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M49,19L49,89"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M59,19L59,89"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M69,19L69,89"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+    <path android:fillColor="#00000000" android:pathData="M79,19L79,89"
+          android:strokeColor="#33FFFFFF" android:strokeWidth="0.8"/>
+</vector>

android/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background"/>
+    <foreground android:drawable="@mipmap/ic_launcher_foreground"/>
+    <monochrome android:drawable="@mipmap/ic_launcher_foreground"/>
+</adaptive-icon>

android/app/src/main/res/mipmap-anydpi-v26/ic_launcher_round.xml

@@ -0,0 +1,6 @@
+<?xml version="1.0" encoding="utf-8"?>
+<adaptive-icon xmlns:android="http://schemas.android.com/apk/res/android">
+    <background android:drawable="@drawable/ic_launcher_background"/>
+    <foreground android:drawable="@mipmap/ic_launcher_foreground"/>
+    <monochrome android:drawable="@mipmap/ic_launcher_foreground"/>
+</adaptive-icon>

android/gradle/wrapper/gradle-wrapper.properties

@@ -1,7 +1,7 @@
 #Sat Sep 12 19:36:23 MST 2026
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-9.6.0-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-9.7.1-bin.zip
 #distributionUrl=https\://services.gradle.org/distributions/gradle-9.1.0-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

android/settings.gradle.kts

@@ -19,10 +19,11 @@ pluginManagement {
 plugins {
     id("dev.flutter.flutter-plugin-loader") version "1.0.0"
 
-    id("com.android.application") version "9.4.0" apply false
+    id("com.android.application") version "9.4.1" apply false
     //id("com.android.application") version "9.0.1" apply false
 
-    // This will need removed in Gradle/AGP 9.
+    // This will need removed in Gradle/AGP 9. JK - needs to exist otherwiese:
+    // "Error: Your project's Kotlin version (2.2.10) is lower than Flutter's minimum supported version of 2.2.20."
     id("org.jetbrains.kotlin.android") version "2.4.20" apply false
 }
 

compile.sh

@@ -0,0 +1,70 @@
+#!/usr/bin/env bash
+# 20260913 - Hyperling
+# Build the project and add the output to a releases folder.
+
+## Setup ##
+
+DIR="$(cd "$(dirname -- "${BASH_SOURCE[0]}")" &>/dev/null && pwd)"
+
+## Functions ##
+
+function log {
+	echo -e "\n $@ \n"
+}
+
+function clean_flutter {
+	log "Cleaning..."
+	flutter clean
+}
+
+## Variables ##
+
+app_details="$DIR/pubspec.yaml"
+
+name=""
+for i in `grep name $app_details`; do
+	name="$i"
+done
+name="${name// /_}"
+
+version=""
+for i in `grep version $app_details`; do
+	version="$i"
+done
+version="v${version// /_}"
+
+if [[ -z $name || -z $version ]]; then
+	echo "ERROR: Could not retrieve name or version. name='$name' version='$version'"
+	exit 1
+fi
+
+RELEASE="release/$name-$version"
+echo "Running for '$RELEASE'."
+
+## Main ##
+
+clean_flutter
+
+log "Building Linux Bundle..."
+flutter build linux
+
+log "Saving Linux Bundle..."
+filename=$RELEASE.linux-bundle.zip
+if [[ -e $filename ]]; then
+	rm -v $filename
+fi
+zip -r $filename build/linux/x64/release/bundle/*
+ls -sh $filename
+
+clean_flutter
+
+log "Building APK..."
+flutter build apk
+
+log "Saving APK..."
+filename=$RELEASE.apk
+if [[ -e $filename ]]; then
+	rm -v $filename
+fi
+cp -v build/app/outputs/flutter-apk/app-release.apk $filename
+ls -sh $filename

lib/main.dart

@@ -1,5 +1,6 @@
 import 'dart:io';
 import 'dart:async';
+
 import 'package:flutter/material.dart';
 import 'package:geolocator/geolocator.dart';
 import 'package:shared_preferences/shared_preferences.dart';
@@ -7,11 +8,14 @@ import 'package:flutter_local_notifications/flutter_local_notifications.dart';
 import 'package:timezone/data/latest_all.dart' as tz;
 import 'package:timezone/timezone.dart' as tz;
 import 'package:http/http.dart' as http;
+//import 'package:alarm/alarm.dart';
+
 import 'dart:convert';
 
 void main() async {
   WidgetsFlutterBinding.ensureInitialized();
   tz.initializeTimeZones();
+  //await Alarm.init();
   runApp(const SunsetAlarmApp());
 }
 
@@ -67,7 +71,7 @@ class _HomeScreenState extends State<HomeScreen> {
       defaultActionName: 'Sunset Alarm',
     );
     await _notifications.initialize(
-      const InitializationSettings(
+      settings: const InitializationSettings(
         android: androidInit,
         iOS: iosInit,
         linux: linuxInit,
@@ -171,6 +175,21 @@ class _HomeScreenState extends State<HomeScreen> {
   Timer? _alarmTimer;
 
   Future<void> _scheduleAlarm() async {
+    // Get the Notifications permission:
+    final android =
+        _notifications
+            .resolvePlatformSpecificImplementation<
+              AndroidFlutterLocalNotificationsPlugin
+            >();
+    await android?.requestNotificationsPermission();
+
+    // Ensure that Android has the correct alarm permissions.
+    final canSchedule = await android?.canScheduleExactNotifications();
+    if (canSchedule != true) {
+      _showSnack('Permissions not yet granted, requesting...');
+      await android?.requestExactAlarmsPermission();
+    }
+
     final sunsetText = _sunsetController.text.trim();
     if (sunsetText.isEmpty) return;
 
@@ -203,16 +222,17 @@ class _HomeScreenState extends State<HomeScreen> {
           timeout: LinuxNotificationTimeout.expiresNever(),
         );
         _notifications.show(
-          _alarmId,
-          'Sunset in ${_minutesBefore} min',
-          'The sun sets at $sunsetText. Time to get ready!',
-          const NotificationDetails(linux: linuxDetails),
+          id: _alarmId,
+          title: 'Sunset in ${_minutesBefore} min',
+          body: 'The sun sets at $sunsetText. Time to get ready!',
+          notificationDetails: const NotificationDetails(linux: linuxDetails),
         );
       });
       _showSnack(
         'Alarm set for ${alarmTime.hour.toString().padLeft(2, '0')}:${alarmTime.minute.toString().padLeft(2, '0')} (app must stay open)',
       );
-    } else {
+    } else if (Platform.isAndroid) {
+      /*** Notifcation Method - Works ***/
       // Android: use zonedSchedule (works in background)
       final tzAlarm = tz.TZDateTime.from(alarmTime, tz.local);
       const androidDetails = AndroidNotificationDetails(
@@ -225,16 +245,42 @@ class _HomeScreenState extends State<HomeScreen> {
         category: AndroidNotificationCategory.alarm,
       );
       await _notifications.zonedSchedule(
-        _alarmId,
-        'Sunset in ${_minutesBefore} min',
-        'The sun sets at $sunsetText. Time to get ready!',
-        tzAlarm,
-        const NotificationDetails(android: androidDetails),
+        id: _alarmId,
+        title: 'Sunset in ${_minutesBefore} min',
+        body: 'The sun sets at $sunsetText. Time to get ready!',
+        scheduledDate: tzAlarm,
+        notificationDetails: const NotificationDetails(android: androidDetails),
         androidScheduleMode: AndroidScheduleMode.alarmClock,
-        uiLocalNotificationDateInterpretation:
-            UILocalNotificationDateInterpretation.absoluteTime,
       );
-      _showSnack('Alarm scheduled.');
+      _showSnack('Alarm scheduled!');
+      debugPrint('DEBUG: Alarm time:   ${tzAlarm.toString()}');
+      debugPrint('DEBUG: Current time: ${DateTime.now().toUtc().toString()}');
+      debugPrint('DEBUG: ${_notifications.toString()}');
+      // End Notification Method ***/
+
+      /*** Alarm Method - WIP *** /
+      // Schedule:
+      final settings = AlarmSettings(
+        id: 42,
+        dateTime: alarmTime, // your computed sunset time
+        assetAudioPath: 'assets/alarm.mp3', // put an alarm sound in assets/
+        loopAudio: true, // keeps ringing until dismissed
+        vibrate: true,
+        androidFullScreenIntent: true, // wakes screen like clock app
+        volumeSettings: VolumeSettings.fade(
+          volume: 0.8,
+          fadeDuration: Duration(seconds: 5),
+        ),
+        notificationSettings: const NotificationSettings(
+          title: 'Sunset Alarm',
+          body: 'The sun sets now. Time to get ready!',
+          stopButton: 'Dismiss',
+        ),
+      );
+      await Alarm.set(alarmSettings: settings);
+      // End Alarm Method ***/
+    } else {
+      _showSnack('Platform not detected, unsure how to show alarm.');
     }
   }
 
@@ -246,7 +292,7 @@ class _HomeScreenState extends State<HomeScreen> {
     } else {
       _alarmTimer?.cancel();
       if (!Platform.isLinux) {
-        await _notifications.cancel(_alarmId);
+        await _notifications.cancel(id: _alarmId);
       }
       _showSnack('Alarm cancelled.');
     }
@@ -375,8 +421,10 @@ class _HomeScreenState extends State<HomeScreen> {
                     ),
                     onChanged: (v) {
                       final val = int.tryParse(v);
-                      if (val != null && val > 0) {
+                      if (val != null && val >= 0) {
                         _minutesBefore = val;
+                      } else {
+                        _showSnack('Invalid Minute Value');
                       }
                     },
                   ),
@@ -417,3 +465,27 @@ class _HomeScreenState extends State<HomeScreen> {
     return '${dh.toString().padLeft(2, '0')}:${dm.toString().padLeft(2, '0')}';
   }
 }
+
+final _plugin = FlutterLocalNotificationsPlugin();
+
+Future<void> requestPermissions() async {
+  if (Platform.isAndroid) {
+    final android =
+        _plugin
+            .resolvePlatformSpecificImplementation<
+              AndroidFlutterLocalNotificationsPlugin
+            >();
+
+    // Android 13+ — standard notification permission (shows a dialog)
+    await android?.requestNotificationsPermission();
+
+    // Android 12+ — exact alarm special access (opens system settings page)
+    await android?.requestExactAlarmsPermission();
+  }
+}
+
+final android =
+    _plugin
+        .resolvePlatformSpecificImplementation<
+          AndroidFlutterLocalNotificationsPlugin
+        >();

media/README.md

@@ -0,0 +1 @@
+Images, audio, and anything else used to support the app.

media/icons/README.md

@@ -0,0 +1 @@
+Images for use as app icons.

media/screenshots/README.md

@@ -0,0 +1 @@
+Images for use in app stores.

pubspec.yaml

@@ -1,7 +1,7 @@
 name: sunset_alarm
 description: "Set an alarm to go off a specified time before sunset."
 publish_to: 'none'
-version: 0.1.1
+version: 0.1.2
 
 environment:
   sdk: ^3.7.2
@@ -9,16 +9,17 @@ environment:
 dependencies:
   flutter:
     sdk: flutter
-  geolocator: ^13.0.0
-  shared_preferences: ^2.3.0
-  flutter_local_notifications: ^18.0.0
-  timezone: ^0.9.0
-  http: ^1.2.0   
+  geolocator: ^14.1.1
+  shared_preferences: ^2.5.5
+  flutter_local_notifications: ^22.3.1
+  timezone: ^0.11.1
+  http: ^1.6.0
+  alarm: ^5.13.2
 
 dev_dependencies:
   flutter_test:
     sdk: flutter
-  flutter_lints: ^5.0.0
+  flutter_lints: ^6.0.0
 
 flutter:
   uses-material-design: true