Added GitHub actions for automated releases

.github/workflows/publish.yml

@@ -0,0 +1,24 @@
+name: Publish
+on:
+  release:
+    types: [released]
+jobs:
+  publish:
+    name: Release build and publish
+    runs-on: ubuntu-latest
+    steps:
+      - name: Check out code
+        uses: actions/checkout@v4
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          distribution: 'zulu'
+          java-version: 21
+      - name: Publish to MavenCentral
+        run: ./gradlew publishToMavenCentral --no-configuration-cache
+        env:
+          ORG_GRADLE_PROJECT_mavenCentralUsername: ${{ secrets.MAVEN_CENTRAL_USERNAME }}
+          ORG_GRADLE_PROJECT_mavenCentralPassword: ${{ secrets.MAVEN_CENTRAL_PASSWORD }}
+          ORG_GRADLE_PROJECT_signingInMemoryKeyId: ${{ secrets.SIGNING_KEY_ID }}
+          ORG_GRADLE_PROJECT_signingInMemoryKeyPassword: ${{ secrets.SIGNING_PASSWORD }}
+          ORG_GRADLE_PROJECT_signingInMemoryKey: ${{ secrets.GPG_KEY_CONTENTS }}

.github/workflows/release.yaml

@@ -7,7 +7,7 @@ on:
       - main
 
 env:
-  VERSION_NAME: 0.0.8  # Update this value for each release
+  VERSION_NAME: 0.0.9  # Update this value for each release
 
 jobs:
   release:
@@ -16,7 +16,7 @@ jobs:
 
     steps:
       - name: Checkout Repository
-        uses: actions/checkout@v3
+        uses: actions/checkout@v4
         with:
           token: ${{ secrets.TOKEN }}
           persist-credentials: true

.gitignore

@@ -13,4 +13,3 @@
 .externalNativeBuild
 .cxx
 local.properties
-/gradle.properties

gradle.properties

@@ -0,0 +1,7 @@
+
+org.gradle.jvmargs=-Xmx2048m -Dfile.encoding=UTF-8
+
+android.useAndroidX=true
+kotlin.code.style=official
+android.nonTransitiveRClass=true
+

gradle/libs.versions.toml

@@ -6,13 +6,13 @@ coreKtx = "1.16.0"
 junit = "4.13.2"
 junitVersion = "1.2.1"
 espressoCore = "3.6.1"
-lifecycleRuntimeKtx = "2.9.1"
+lifecycleRuntimeKtx = "2.9.2"
 activityCompose = "1.10.1"
-composeBom = "2025.06.01"
+composeBom = "2025.07.00"
 appcompat = "1.7.1"
 kotlinSerialization = "2.1.21"
 hiltNavigation = "1.2.0"
-hilt = "2.56.2"
+hilt = "2.56.1"
 ksp = "2.1.21-2.0.1"
 spotless = "7.0.4"
 

gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
-#Tue Jun 03 22:26:27 IST 2025
+#Thu Jul 10 22:22:40 IST 2025
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-8.13-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.11.1-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

triggerx/build.gradle.kts

@@ -18,7 +18,7 @@ plugins {
     alias(libs.plugins.kotlin.android)
     alias(libs.plugins.kotlin.compose)
     alias(libs.plugins.spotless)
-    id("com.vanniktech.maven.publish") version "0.32.0"
+    id("com.vanniktech.maven.publish") version "0.34.0"
 }
 
 android {
@@ -92,4 +92,41 @@ dependencies {
     implementation(libs.androidx.ui.graphics)
     implementation(libs.androidx.ui.tooling.preview)
     implementation(libs.androidx.material3)
+}
+
+mavenPublishing {
+    publishToMavenCentral()
+
+    signAllPublications()
+
+
+    coordinates("com.meticha", "triggerx", "0.0.9")
+
+    pom {
+        name = "triggerx"
+        description =
+            "A lightweight Android library for scheduling exact alarms with custom UIs. No foreground services or wake-lock hassle."
+        inceptionYear = "2025"
+        version = "0.0.9"
+        url = "https://github.com/meticha/triggerx.git"
+        licenses {
+            license {
+                name = "The Apache License, Version 2.0"
+                url = "https://www.apache.org/licenses/LICENSE-2.0.txt"
+                distribution = "https://www.apache.org/licenses/LICENSE-2.0.txt"
+            }
+        }
+        developers {
+            developer {
+                id = "Cavin"
+                name = "Cavin Macwan"
+                url = "https://github.com/cavin-macwan/"
+            }
+        }
+        scm {
+            url = "https://github.com/meticha/triggerx.git"
+            connection = "scm:git:git://github.com/meticha/triggerx.git"
+            developerConnection = "scm:git:ssh://[email protected]/meticha/triggerx.git"
+        }
+    }
 }

triggerx/src/main/java/com/meticha/triggerx/permission/PermissionLifeCycleCheckEffect.kt

@@ -26,7 +26,7 @@ import kotlinx.coroutines.launch
 
 
 /**
- * A Composable side-effect that observes lifecycle events to re-evaluate and request permissions.
+ * A Composable side effect that observes lifecycle events to re-evaluate and request permissions.
  *
  * This is primarily used to detect when the user returns to the app after potentially changing
  * permissions in the system settings. When the specified [lifecycleEvent] (defaulting to `ON_RESUME`)
@@ -35,7 +35,7 @@ import kotlinx.coroutines.launch
  *
  * @param permissionState The current [PermissionState] to be monitored and updated.
  * @param lifecycleEvent The [Lifecycle.Event] to observe for triggering the permission check.
- *                       Defaults to [Lifecycle.Event.ON_RESUME].
+ * Defaults to [Lifecycle.Event.ON_RESUME].
  */
 @Composable
 internal fun PermissionLifeCycleCheckEffect(

triggerx/src/main/java/com/meticha/triggerx/permission/TriggerXPermissionComposable.kt

@@ -98,9 +98,7 @@ fun rememberAppPermissionState(): PermissionState {
                     permissionState.next()
                 }
 
-                else                                                    -> handlePermissionDenial(
-                    permissionState
-                )
+                else -> handlePermissionDenial(permissionState)
             }
         }
     }
@@ -117,16 +115,14 @@ fun rememberAppPermissionState(): PermissionState {
                 )
             }
 
-            permissionState.showRationalePopUp                                                -> {
+            permissionState.showRationalePopUp -> {
                 ShowPopup(
                     message = "Permissions are required to proceed further",
                     onConfirm = {
                         permissionState.showRationalePopUp = false
                         coroutineScope.launch { permissionState.requestPermission() }
                     },
-                    onDismiss = {
-                        permissionState.showRationalePopUp = false
-                    }
+                    onDismiss = { permissionState.showRationalePopUp = false }
                 )
             }
 
@@ -150,11 +146,11 @@ private fun ShowPermissionGuidanceDialog(
                 remember { context.applicationInfo.loadLabel(context.packageManager).toString() }
             ShowManualPermissionDialog(
                 message = "For alarms to reliably appear when the app is in the background, " +
-                          "'$appName' needs an additional permission on some phones (like Xiaomi, Oppo, Vivo, etc.).\n\n" +
-                          "Please go to your phone's Settings -> Apps -> Manage Apps (or similar) -> Find '$appName' -> " +
-                          "Other permissions (or App permissions) -> And ensure 'Display pop-up windows while running in the background' " +
-                          "(or a similar sounding option like 'Start in background') is ENABLED.\n\n" +
-                          "This reminder is shown once if you click 'Acknowledge'.",
+                        "'$appName' needs an additional permission on some phones (like Xiaomi, Oppo, Vivo, etc.).\n\n" +
+                        "Please go to your phone's Settings -> Apps -> Manage Apps (or similar) -> Find '$appName' -> " +
+                        "Other permissions (or App permissions) -> And ensure 'Display pop-up windows while running in the background' " +
+                        "(or a similar sounding option like 'Start in background') is ENABLED.\n\n" +
+                        "This reminder is shown once if you click 'Acknowledge'.",
                 onDismiss = {
                     permissionState.showPermissionGuidanceDialog = false
                     coroutineScope.launch {
@@ -179,7 +175,7 @@ private fun ShowPermissionGuidanceDialog(
             )
         }
 
-        else                                    -> {}
+        else -> {}
     }
 }
 
@@ -229,8 +225,8 @@ internal fun ShowManualPermissionDialog(
  * or to inform them about the necessity of a permission if it has been denied.
  *
  * @param message The main message to be displayed in the dialog.
- * @param onConfirm A lambda function to be executed when the confirm button (e.g., "Grant") is clicked.
- * @param onDismiss A lambda function to be executed when the dismiss button (e.g., "Cancel") is clicked
+ * @param onConfirm A lambda function to be executed when the confirmation button (e.g., "Grant") is clicked.
+ * @param onDismiss A lambda function to be executed when the dismissed button (e.g., "Cancel") is clicked
  *                  or when the dialog is dismissed by tapping outside or pressing the back button.
  */
 @Composable
@@ -242,7 +238,7 @@ internal fun ShowPopup(
     AlertDialog(
         onDismissRequest = { onDismiss() },
         title = {
-            Text(text = "Permission")
+            Text(text = "Permission is required")
         },
         text = {
             Text(text = message)
@@ -258,7 +254,7 @@ internal fun ShowPopup(
             Button(onClick = {
                 onConfirm()
             }) {
-                Text(text = "Grant")
+                Text(text = "Grant Permission")
             }
         }
     )

triggerx/src/main/java/com/meticha/triggerx/permission/TriggerXPermissionManager.kt

@@ -142,11 +142,11 @@ internal object AlarmPermissionManager {
      */
     suspend fun isGranted(context: Context, permission: PermissionType): Boolean {
         return when (permission) {
-            PermissionType.ALARM                    -> hasExactAlarmPermission(context)
-            PermissionType.OVERLAY                  -> hasOverlayPermission(context)
-            PermissionType.BATTERY_OPTIMIZATION     -> hasBatteryOptimizationPermission(context)
-            PermissionType.LOCK_SCREEN              -> isShowOnLockScreenPermissionEnable(context)
-            PermissionType.NOTIFICATION             -> isNotificationPermissionEnabled(context)
+            PermissionType.ALARM -> hasExactAlarmPermission(context)
+            PermissionType.OVERLAY -> hasOverlayPermission(context)
+            PermissionType.BATTERY_OPTIMIZATION -> hasBatteryOptimizationPermission(context)
+            PermissionType.LOCK_SCREEN -> isShowOnLockScreenPermissionEnable(context)
+            PermissionType.NOTIFICATION -> isNotificationPermissionEnabled(context)
             PermissionType.OVERLAY_WHILE_BACKGROUND -> isOverlayBackgroundPermissionEnabled(context)
         }
     }
@@ -163,7 +163,7 @@ internal object AlarmPermissionManager {
      */
     fun createPermissionIntent(context: Context, permissionType: PermissionType): Intent? {
         when (permissionType) {
-            PermissionType.ALARM                -> {
+            PermissionType.ALARM -> {
                 return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
                     Intent(Settings.ACTION_REQUEST_SCHEDULE_EXACT_ALARM).apply {
                         data = "package:${context.packageName}".toUri()
@@ -173,7 +173,7 @@ internal object AlarmPermissionManager {
                 }
             }
 
-            PermissionType.OVERLAY              -> {
+            PermissionType.OVERLAY -> {
                 return Intent(Settings.ACTION_MANAGE_OVERLAY_PERMISSION).apply {
                     data = "package:${context.packageName}".toUri()
                 }
@@ -185,7 +185,7 @@ internal object AlarmPermissionManager {
                 }
             }
 
-            PermissionType.LOCK_SCREEN          -> {
+            PermissionType.LOCK_SCREEN -> {
                 // This intent is specific to MIUI and might not work on other devices.
                 return Intent("miui.intent.action.APP_PERM_EDITOR").apply {
                     setClassName(
@@ -196,7 +196,7 @@ internal object AlarmPermissionManager {
                 }
             }
 
-            PermissionType.NOTIFICATION         -> {
+            PermissionType.NOTIFICATION -> {
                 return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
                     Intent(Settings.ACTION_APP_NOTIFICATION_SETTINGS).apply {
                         putExtra(Settings.EXTRA_APP_PACKAGE, context.packageName)
@@ -206,7 +206,7 @@ internal object AlarmPermissionManager {
                 }
             }
 
-            else                                -> {
+            else -> {
                 return null
             }
         }
@@ -240,7 +240,7 @@ enum class PermissionType(val isManualPermissionType: Boolean = false) {
 }
 
 /**
- * Manages the state of permission requests and their UI flows, particularly for a list
+ * Manages the state of permission requests, and their UI flows, particularly for a list
  * of required permissions. This class is typically used in conjunction with Jetpack Compose.
  *
  * @param permissionList The initial list of [PermissionType]s that this state manager will handle.

triggerx/src/main/java/com/meticha/triggerx/preference/TriggerXPreference.kt

@@ -56,7 +56,7 @@ internal object TriggerXPreferences {
 
     /**
      * Saves the provided [TriggerXConfig] to DataStore.
-     * This includes the activity class name, and optionally the notification title and message.
+     * This includes the activity class name and optionally the notification title and message.
      *
      * @param context The [Context] used to access DataStore.
      * @param config The [TriggerXConfig] instance containing the settings to save.

triggerx/src/main/java/com/meticha/triggerx/services/TriggerXForegroundService.kt

@@ -182,7 +182,7 @@ internal class TriggerXForegroundService : Service() {
             channelName,
             NotificationManager.IMPORTANCE_DEFAULT
         ).apply {
-            description = "Notifications for TriggerX alarms"
+            description = "Notifications for scheduling alarms"
         }
         val nm = getSystemService(Context.NOTIFICATION_SERVICE) as NotificationManager
         nm.createNotificationChannel(channel)