From 6c734b731530c042c1e0a83bf9a91c804cb43268 Mon Sep 17 00:00:00 2001 From: Rangel Reale Date: Thu, 12 Nov 2026 07:29:03 -0300 Subject: [PATCH 1/5] Scaffold Gradle project and settings layer with unit tests Gradle 8.14.3 wrapper, AGP 8.13.2, Kotlin 2.2.21, version catalog. DevSettingsRepository reads and writes Settings.Global through a SettingsStore interface; tests use an in-memory fake. Co-Authored-By: Claude Opus 5.5 --- .gitignore | 8 + app/build.gradle.kts | 58 ++++ app/src/main/AndroidManifest.xml | 104 ++++++++ .../devsettings/data/AndroidSettingsStore.kt | 31 +++ .../devsettings/data/DevSetting.kt | 32 +++ .../devsettings/data/DevSettingsRepository.kt | 24 ++ .../devsettings/data/SettingsStore.kt | 17 ++ .../keepon/KeepScreenOnDuration.kt | 41 +++ .../devsettings/keepon/KeepScreenOnState.kt | 15 ++ .../res/drawable/ic_launcher_foreground.xml | 15 ++ app/src/main/res/drawable/ic_power.xml | 9 + app/src/main/res/drawable/ic_screen.xml | 9 + app/src/main/res/drawable/ic_stop.xml | 9 + app/src/main/res/drawable/ic_usb.xml | 9 + app/src/main/res/drawable/ic_wifi.xml | 9 + .../res/mipmap-anydpi-v26/ic_launcher.xml | 6 + app/src/main/res/values/colors.xml | 4 + app/src/main/res/values/strings.xml | 59 ++++ app/src/main/res/values/themes.xml | 4 + .../data/DevSettingsRepositoryTest.kt | 105 ++++++++ .../devsettings/data/FakeSettingsStore.kt | 28 ++ .../keepon/KeepScreenOnDurationTest.kt | 51 ++++ build.gradle.kts | 5 + gradle.properties | 4 + gradle/libs.versions.toml | 27 ++ gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 43764 bytes gradle/wrapper/gradle-wrapper.properties | 7 + gradlew | 251 ++++++++++++++++++ gradlew.bat | 94 +++++++ settings.gradle.kts | 18 ++ 30 files changed, 1053 insertions(+) create mode 100644 .gitignore create mode 100644 app/build.gradle.kts create mode 100644 app/src/main/AndroidManifest.xml create mode 100644 app/src/main/java/com/rangelreale/devsettings/data/AndroidSettingsStore.kt create mode 100644 app/src/main/java/com/rangelreale/devsettings/data/DevSetting.kt create mode 100644 app/src/main/java/com/rangelreale/devsettings/data/DevSettingsRepository.kt create mode 100644 app/src/main/java/com/rangelreale/devsettings/data/SettingsStore.kt create mode 100644 app/src/main/java/com/rangelreale/devsettings/keepon/KeepScreenOnDuration.kt create mode 100644 app/src/main/java/com/rangelreale/devsettings/keepon/KeepScreenOnState.kt create mode 100644 app/src/main/res/drawable/ic_launcher_foreground.xml create mode 100644 app/src/main/res/drawable/ic_power.xml create mode 100644 app/src/main/res/drawable/ic_screen.xml create mode 100644 app/src/main/res/drawable/ic_stop.xml create mode 100644 app/src/main/res/drawable/ic_usb.xml create mode 100644 app/src/main/res/drawable/ic_wifi.xml create mode 100644 app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml create mode 100644 app/src/main/res/values/colors.xml create mode 100644 app/src/main/res/values/strings.xml create mode 100644 app/src/main/res/values/themes.xml create mode 100644 app/src/test/java/com/rangelreale/devsettings/data/DevSettingsRepositoryTest.kt create mode 100644 app/src/test/java/com/rangelreale/devsettings/data/FakeSettingsStore.kt create mode 100644 app/src/test/java/com/rangelreale/devsettings/keepon/KeepScreenOnDurationTest.kt create mode 100644 build.gradle.kts create mode 100644 gradle.properties create mode 100644 gradle/libs.versions.toml create mode 100644 gradle/wrapper/gradle-wrapper.jar create mode 100644 gradle/wrapper/gradle-wrapper.properties create mode 100644 gradlew create mode 100644 gradlew.bat create mode 100644 settings.gradle.kts diff --git a/.gitignore b/.gitignore new file mode 100644 index 0000000..919975f --- /dev/null +++ b/.gitignore @@ -0,0 +1,8 @@ +.gradle/ +build/ +local.properties +.idea/ +*.iml +.kotlin/ +captures/ +.cxx/ diff --git a/app/build.gradle.kts b/app/build.gradle.kts new file mode 100644 index 0000000..6125b42 --- /dev/null +++ b/app/build.gradle.kts @@ -0,0 +1,58 @@ +import org.jetbrains.kotlin.gradle.dsl.JvmTarget + +plugins { + alias(libs.plugins.android.application) + alias(libs.plugins.kotlin.android) + alias(libs.plugins.kotlin.compose) +} + +android { + namespace = "com.rangelreale.devsettings" + compileSdk = 36 + + defaultConfig { + applicationId = "com.rangelreale.devsettings" + minSdk = 30 + targetSdk = 36 + versionCode = 1 + versionName = "1.0.0" + } + + buildTypes { + release { + isMinifyEnabled = false + // Personal sideloaded build: sign with the debug key so `assembleRelease` installs directly. + signingConfig = signingConfigs.getByName("debug") + } + } + + compileOptions { + sourceCompatibility = JavaVersion.VERSION_17 + targetCompatibility = JavaVersion.VERSION_17 + } + + buildFeatures { + compose = true + } +} + +kotlin { + compilerOptions { + jvmTarget.set(JvmTarget.JVM_17) + } +} + +dependencies { + implementation(libs.androidx.core.ktx) + implementation(libs.androidx.lifecycle.runtime.ktx) + implementation(libs.androidx.lifecycle.runtime.compose) + implementation(libs.androidx.activity.compose) + implementation(libs.kotlinx.coroutines.android) + implementation(platform(libs.androidx.compose.bom)) + implementation(libs.androidx.compose.ui) + implementation(libs.androidx.compose.ui.tooling.preview) + implementation(libs.androidx.compose.material3) + debugImplementation(libs.androidx.compose.ui.tooling) + + testImplementation(libs.junit) +} diff --git a/app/src/main/AndroidManifest.xml b/app/src/main/AndroidManifest.xml new file mode 100644 index 0000000..22e849c --- /dev/null +++ b/app/src/main/AndroidManifest.xml @@ -0,0 +1,104 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/app/src/main/java/com/rangelreale/devsettings/data/AndroidSettingsStore.kt b/app/src/main/java/com/rangelreale/devsettings/data/AndroidSettingsStore.kt new file mode 100644 index 0000000..1b74510 --- /dev/null +++ b/app/src/main/java/com/rangelreale/devsettings/data/AndroidSettingsStore.kt @@ -0,0 +1,31 @@ +package com.rangelreale.devsettings.data + +import android.Manifest +import android.content.Context +import android.content.pm.PackageManager +import android.provider.Settings + +/** [SettingsStore] backed by the real `Settings.Global` table. */ +class AndroidSettingsStore(context: Context) : SettingsStore { + private val context = context.applicationContext + + override fun getGlobalInt(key: String, default: Int): Int = + try { + Settings.Global.getInt(context.contentResolver, key, default) + } catch (e: SecurityException) { + default + } + + override fun putGlobalInt(key: String, value: Int): Boolean = + try { + Settings.Global.putInt(context.contentResolver, key, value) + } catch (e: SecurityException) { + false + } catch (e: IllegalArgumentException) { + false + } + + override fun hasWriteSecureSettings(): Boolean = + context.checkSelfPermission(Manifest.permission.WRITE_SECURE_SETTINGS) == + PackageManager.PERMISSION_GRANTED +} diff --git a/app/src/main/java/com/rangelreale/devsettings/data/DevSetting.kt b/app/src/main/java/com/rangelreale/devsettings/data/DevSetting.kt new file mode 100644 index 0000000..08112a3 --- /dev/null +++ b/app/src/main/java/com/rangelreale/devsettings/data/DevSetting.kt @@ -0,0 +1,32 @@ +package com.rangelreale.devsettings.data + +/** + * A developer setting stored as an integer in `Settings.Global`. + * + * The keys are literal strings so the logic runs in plain JVM unit tests. + * They match the `Settings.Global` constants named in each comment. + */ +enum class DevSetting(val key: String, val onValue: Int) { + /** `Settings.Global.ADB_ENABLED`. */ + USB_DEBUGGING("adb_enabled", 1), + + /** `adb_wifi_enabled` (hidden constant `Settings.Global.ADB_WIFI_ENABLED`). */ + WIRELESS_DEBUGGING("adb_wifi_enabled", 1), + + /** + * `Settings.Global.STAY_ON_WHILE_PLUGGED_IN`. The value is a bit mask: + * 1 = AC, 2 = USB, 4 = wireless. "On" sets all three (7). + */ + STAY_AWAKE("stay_on_while_plugged_in", 7), +} + +object GlobalKeys { + /** `Settings.Global.DEVELOPMENT_SETTINGS_ENABLED`. */ + const val DEVELOPMENT_SETTINGS_ENABLED = "development_settings_enabled" +} + +const val WRITE_SECURE_SETTINGS = "android.permission.WRITE_SECURE_SETTINGS" + +/** The command that grants the permission from a computer. */ +fun grantCommand(packageName: String): String = + "adb shell pm grant $packageName $WRITE_SECURE_SETTINGS" diff --git a/app/src/main/java/com/rangelreale/devsettings/data/DevSettingsRepository.kt b/app/src/main/java/com/rangelreale/devsettings/data/DevSettingsRepository.kt new file mode 100644 index 0000000..77c9f08 --- /dev/null +++ b/app/src/main/java/com/rangelreale/devsettings/data/DevSettingsRepository.kt @@ -0,0 +1,24 @@ +package com.rangelreale.devsettings.data + +enum class WriteResult { SUCCESS, MISSING_PERMISSION, FAILED } + +/** Reads and writes the developer settings. Every read goes to the store; nothing is cached. */ +class DevSettingsRepository(private val store: SettingsStore) { + + fun hasPermission(): Boolean = store.hasWriteSecureSettings() + + fun developerOptionsEnabled(): Boolean = + store.getGlobalInt(GlobalKeys.DEVELOPMENT_SETTINGS_ENABLED, 0) != 0 + + /** Any non-zero value counts as on. For stay awake, this includes partial masks such as 1 (AC only). */ + fun isEnabled(setting: DevSetting): Boolean = store.getGlobalInt(setting.key, 0) != 0 + + fun setEnabled(setting: DevSetting, enabled: Boolean): WriteResult { + if (!hasPermission()) return WriteResult.MISSING_PERMISSION + val value = if (enabled) setting.onValue else 0 + if (!store.putGlobalInt(setting.key, value)) return WriteResult.FAILED + return if (store.getGlobalInt(setting.key, -1) == value) WriteResult.SUCCESS else WriteResult.FAILED + } + + fun toggle(setting: DevSetting): WriteResult = setEnabled(setting, !isEnabled(setting)) +} diff --git a/app/src/main/java/com/rangelreale/devsettings/data/SettingsStore.kt b/app/src/main/java/com/rangelreale/devsettings/data/SettingsStore.kt new file mode 100644 index 0000000..615b945 --- /dev/null +++ b/app/src/main/java/com/rangelreale/devsettings/data/SettingsStore.kt @@ -0,0 +1,17 @@ +package com.rangelreale.devsettings.data + +/** + * Minimal view of `Settings.Global` and the permission check. + * + * The production implementation is [AndroidSettingsStore]. Unit tests use a fake. + */ +interface SettingsStore { + /** Returns the integer value of a global setting, or [default] when it is missing or unreadable. */ + fun getGlobalInt(key: String, default: Int): Int + + /** Writes a global setting. Returns false when the system rejects the write. */ + fun putGlobalInt(key: String, value: Int): Boolean + + /** True when the app holds `android.permission.WRITE_SECURE_SETTINGS`. */ + fun hasWriteSecureSettings(): Boolean +} diff --git a/app/src/main/java/com/rangelreale/devsettings/keepon/KeepScreenOnDuration.kt b/app/src/main/java/com/rangelreale/devsettings/keepon/KeepScreenOnDuration.kt new file mode 100644 index 0000000..b64cff6 --- /dev/null +++ b/app/src/main/java/com/rangelreale/devsettings/keepon/KeepScreenOnDuration.kt @@ -0,0 +1,41 @@ +package com.rangelreale.devsettings.keepon + +import java.util.concurrent.TimeUnit + +/** The fixed durations offered for "Keep screen on". [minutes] is null for "indefinitely". */ +enum class KeepScreenOnDuration(val minutes: Long?) { + MIN_5(5), + MIN_15(15), + MIN_30(30), + HOUR_1(60), + INDEFINITE(null); + + val millis: Long? get() = minutes?.let { TimeUnit.MINUTES.toMillis(it) } + + companion object { + /** + * The next step of the tile cycle: off, 5 min, 15 min, 30 min, 1 hour, indefinitely, off. + * Null means off. + */ + fun next(current: KeepScreenOnDuration?): KeepScreenOnDuration? = when (current) { + null -> entries.first() + entries.last() -> null + else -> entries[current.ordinal + 1] + } + } +} + +/** A running keep-screen-on session. [endsAtMillis] is wall-clock time, null when indefinite. */ +data class KeepScreenOnStatus(val duration: KeepScreenOnDuration, val endsAtMillis: Long?) { + fun remainingMillis(nowMillis: Long): Long? = endsAtMillis?.let { (it - nowMillis).coerceAtLeast(0) } +} + +/** Formats a remaining time as `h:mm:ss` or `m:ss`. */ +fun formatRemaining(millis: Long): String { + val totalSeconds = (millis + 999) / 1000 + val hours = totalSeconds / 3600 + val minutes = (totalSeconds % 3600) / 60 + val seconds = totalSeconds % 60 + return if (hours > 0) "%d:%02d:%02d".format(hours, minutes, seconds) + else "%d:%02d".format(minutes, seconds) +} diff --git a/app/src/main/java/com/rangelreale/devsettings/keepon/KeepScreenOnState.kt b/app/src/main/java/com/rangelreale/devsettings/keepon/KeepScreenOnState.kt new file mode 100644 index 0000000..9c4d3a3 --- /dev/null +++ b/app/src/main/java/com/rangelreale/devsettings/keepon/KeepScreenOnState.kt @@ -0,0 +1,15 @@ +package com.rangelreale.devsettings.keepon + +import kotlinx.coroutines.flow.MutableStateFlow +import kotlinx.coroutines.flow.StateFlow +import kotlinx.coroutines.flow.asStateFlow + +/** Live state of [KeepScreenOnService]. Null when the service is not running. */ +object KeepScreenOnState { + private val mutable = MutableStateFlow(null) + val status: StateFlow = mutable.asStateFlow() + + internal fun set(value: KeepScreenOnStatus?) { + mutable.value = value + } +} diff --git a/app/src/main/res/drawable/ic_launcher_foreground.xml b/app/src/main/res/drawable/ic_launcher_foreground.xml new file mode 100644 index 0000000..37e8959 --- /dev/null +++ b/app/src/main/res/drawable/ic_launcher_foreground.xml @@ -0,0 +1,15 @@ + + + + + diff --git a/app/src/main/res/drawable/ic_power.xml b/app/src/main/res/drawable/ic_power.xml new file mode 100644 index 0000000..84c1c4d --- /dev/null +++ b/app/src/main/res/drawable/ic_power.xml @@ -0,0 +1,9 @@ + + + diff --git a/app/src/main/res/drawable/ic_screen.xml b/app/src/main/res/drawable/ic_screen.xml new file mode 100644 index 0000000..cea9953 --- /dev/null +++ b/app/src/main/res/drawable/ic_screen.xml @@ -0,0 +1,9 @@ + + + diff --git a/app/src/main/res/drawable/ic_stop.xml b/app/src/main/res/drawable/ic_stop.xml new file mode 100644 index 0000000..02e24a3 --- /dev/null +++ b/app/src/main/res/drawable/ic_stop.xml @@ -0,0 +1,9 @@ + + + diff --git a/app/src/main/res/drawable/ic_usb.xml b/app/src/main/res/drawable/ic_usb.xml new file mode 100644 index 0000000..460211b --- /dev/null +++ b/app/src/main/res/drawable/ic_usb.xml @@ -0,0 +1,9 @@ + + + diff --git a/app/src/main/res/drawable/ic_wifi.xml b/app/src/main/res/drawable/ic_wifi.xml new file mode 100644 index 0000000..8160088 --- /dev/null +++ b/app/src/main/res/drawable/ic_wifi.xml @@ -0,0 +1,9 @@ + + + diff --git a/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml b/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml new file mode 100644 index 0000000..5c84730 --- /dev/null +++ b/app/src/main/res/mipmap-anydpi-v26/ic_launcher.xml @@ -0,0 +1,6 @@ + + + + + + diff --git a/app/src/main/res/values/colors.xml b/app/src/main/res/values/colors.xml new file mode 100644 index 0000000..5c3c853 --- /dev/null +++ b/app/src/main/res/values/colors.xml @@ -0,0 +1,4 @@ + + + #FF2E7D32 + diff --git a/app/src/main/res/values/strings.xml b/app/src/main/res/values/strings.xml new file mode 100644 index 0000000..3a75c23 --- /dev/null +++ b/app/src/main/res/values/strings.xml @@ -0,0 +1,59 @@ + + + Dev Settings + + USB debugging + Wireless debugging + Stay awake + Stay awake while charging + Keep screen on + + On + Off + On until stopped + On, %1$s left + On for AC, USB and wireless charging + Setup needed + %1$s left + + 5 min + 15 min + 30 min + 1 hour + Until stopped + + One-time setup + This app needs the WRITE_SECURE_SETTINGS permission. Only a computer can grant it. + 1. Turn on USB debugging in Developer options, then connect the phone to a computer. + 2. On the computer, run this command: + 3. Come back here. The switches turn on within a few seconds. + Copy command + Copied + + Developer options are off + These settings have no effect until Developer options are on. Open About phone and tap Build number seven times. On some phones, Build number is under Software information. + Open About phone + + Open Developer options + Open wireless debugging (pairing) + Address: %1$s + Looking for the debugging port… + Port not found. The wireless debugging screen shows it. + No Wi-Fi address. Wireless debugging needs Wi-Fi. + Copy adb connect + + Turn off %1$s? + A computer connected through %1$s loses its connection. + Turn off + Cancel + + Android rejected the change to %1$s. + Permission missing. Complete the setup first. + Could not start keep screen on. + + Keep screen on + Keeping the screen on + Until you stop it + Stop + Holds the screen on, charging or not. + diff --git a/app/src/main/res/values/themes.xml b/app/src/main/res/values/themes.xml new file mode 100644 index 0000000..30a7a7a --- /dev/null +++ b/app/src/main/res/values/themes.xml @@ -0,0 +1,4 @@ + + +