Harden repo setup and Wear tile launch

Author: FredApps

.gitattributes

@@ -0,0 +1,10 @@
+* text=auto
+
+*.bat text eol=crlf
+*.gradle text eol=lf
+*.kts text eol=lf
+*.kt text eol=lf
+*.md text eol=lf
+*.xml text eol=lf
+*.yml text eol=lf
+*.toml text eol=lf

.github/dependabot.yml

@@ -0,0 +1,11 @@
+version: 2
+updates:
+  - package-ecosystem: gradle
+    directory: /
+    schedule:
+      interval: weekly
+
+  - package-ecosystem: github-actions
+    directory: /
+    schedule:
+      interval: weekly

.github/workflows/android.yml

@@ -0,0 +1,41 @@
+name: Android
+
+on:
+  push:
+    branches:
+      - main
+  pull_request:
+    branches:
+      - main
+
+concurrency:
+  group: android-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Set up JDK 21
+        uses: actions/setup-java@v4
+        with:
+          distribution: temurin
+          java-version: "21"
+
+      - name: Set up Android SDK
+        uses: android-actions/setup-android@v3
+        with:
+          packages: "platforms;android-36 build-tools;36.0.0 platform-tools"
+
+      - name: Set up Gradle
+        uses: gradle/actions/setup-gradle@v4
+
+      - name: Grant gradlew execute permission
+        run: chmod +x ./gradlew
+
+      - name: Build
+        run: ./gradlew --no-daemon build

.gitignore

@@ -11,3 +11,4 @@ captures/
 *.apk
 *.aab
 *.keystore
+*.jks

README.md

@@ -1,12 +1,12 @@
 # WatchDevTools
 
-Quick-access Wear OS tile for developer settings. Provides shortcut buttons to Developer options, Bluetooth settings, and Wi-Fi settings — all one swipe away without navigating through the full settings menu.
+Quick-access Wear OS tile for developer settings. Provides shortcut buttons to Developer options, Bluetooth settings, and Wi-Fi settings - all one swipe away without navigating through the full settings menu.
 
 ## Features
 
-- **Dev Options Shortcut** — Jump directly to Android Developer settings (for wireless debugging, USB debugging, etc.)
-- **Bluetooth Settings** — One-tap access to Bluetooth configuration
-- **Wi-Fi Settings** — Quick navigation to Wi-Fi setup
+- **Dev Options Shortcut** - Jump directly to Android Developer settings (for wireless debugging, USB debugging, etc.)
+- **Bluetooth Settings** - One-tap access to Bluetooth configuration
+- **Wi-Fi Settings** - Quick navigation to Wi-Fi setup
 
 ## Installation
 
@@ -17,7 +17,7 @@ Add the tile to your Wear OS device manually:
 3. Find and select **DevTools**
 4. The tile is now in your carousel
 
-No app drawer icon—this is purely a tile-based utility.
+No app drawer icon - this is purely a tile-based utility.
 
 ## Building
 
@@ -31,25 +31,36 @@ To build and install directly to a connected watch:
 ./gradlew installDebug
 ```
 
+## Release Builds
+
+Release APKs/AABs must be signed with your private Android signing key. Keep signing properties and keystores outside git; the repository ignores `local.properties`, `*.keystore`, `*.jks`, `*.apk`, and `*.aab`.
+
+Before publishing a release:
+
+1. Update `versionCode` and `versionName` in `app/build.gradle.kts`
+2. Build the release artifact with `./gradlew assembleRelease`
+3. Sign the artifact using your local signing configuration
+
 ## Configuration
 
 - **Min SDK:** 30 (Wear OS 7.0)
 - **Compile SDK:** 36
 - **Target SDK:** 35
 - **Language:** Kotlin
 - **Architecture:** Wear OS Protolayout (tile-based UI)
+- **Tested on:** Samsung Galaxy Watch6 Classic LTE SM-R965F
 
 ## Development Notes
 
 - The app uses `androidx.wear.tiles` and Protolayout for tile rendering
 - Resource caching is managed via `RESOURCES_VERSION`; bump this constant when layout schema changes
 - Tile buttons invoke `LaunchDevOptionsActivity`, which routes the appropriate Settings intent and immediately finishes
-- No UI is painted (NoDisplay theme)—the launcher activity exists only to bridge tile clicks to system intents
+- No UI is painted (NoDisplay theme) - the launcher activity exists only to bridge tile clicks to system intents
 
 ## Package
 
 - **Application ID:** `com.fredapps.watchdevtools`
-- **Version:** 0.1.0
+- **Version:** 1.0.0
 - **Namespace:** fredapps
 
 ## License

app/src/main/AndroidManifest.xml

@@ -9,8 +9,12 @@
         android:roundIcon="@drawable/ic_devtools"
         android:theme="@android:style/Theme.DeviceDefault">
 
+        <meta-data
+            android:name="com.google.android.wearable.standalone"
+            android:value="true" />
+
         <!--
-            Hidden activity. Tile-only app — this activity is not listed in the
+            Hidden activity. Tile-only app - this activity is not listed in the
             launcher, but it's triggered by the tile's buttons to fire the
             Developer options intent and finish immediately.
         -->
@@ -23,7 +27,7 @@
 
         <!--
             Tile carousel shortcut. The user adds this manually via long-press on
-            an existing tile → Add → DevTools (Wear OS doesn't allow third-party
+            an existing tile -> Add -> DevTools (Wear OS doesn't allow third-party
             apps to programmatically place tiles in the carousel).
         -->
         <service

app/src/main/kotlin/com/fredapps/watchdevtools/DevOptionsTileService.kt

@@ -1,8 +1,12 @@
+/*
+ * SPDX-License-Identifier: GPL-3.0-only
+ */
+
 package com.fredapps.watchdevtools
 
 import android.provider.Settings
 import android.util.Log
-import androidx.concurrent.futures.ResolvableFuture
+import androidx.concurrent.futures.CallbackToFutureAdapter
 import androidx.wear.protolayout.ActionBuilders
 import androidx.wear.protolayout.ColorBuilders.argb
 import androidx.wear.protolayout.DimensionBuilders.dp
@@ -18,7 +22,7 @@ import androidx.wear.tiles.TileBuilders.Tile
 import androidx.wear.tiles.TileService
 import com.google.common.util.concurrent.ListenableFuture
 
-// Bump this string whenever the layout schema changes — it forces the Wear OS
+// Bump this string whenever the layout schema changes - it forces the Wear OS
 // renderer to discard cached visuals and re-fetch from us.
 private const val RESOURCES_VERSION = "4"
 private const val TAG = "DevOptionsTile"
@@ -30,8 +34,8 @@ private const val WHITE = 0xFFFFFFFF.toInt()
 /**
  * Tile with three quick-toggle shortcuts: Dev options (for wireless debugging),
  * Bluetooth settings, and Wi-Fi settings. None of these can actually flip the
- * toggle from a third-party app on modern Android — Bluetooth and Wi-Fi both
- * require user consent — but landing on the right settings page is one tap
+ * toggle from a third-party app on modern Android - Bluetooth and Wi-Fi both
+ * require user consent - but landing on the right settings page is one tap
  * away from the toggle.
  *
  * Each button's [ActionBuilders.LaunchAction] points at the same
@@ -44,8 +48,13 @@ class DevOptionsTileService : TileService() {
         requestParams: RequestBuilders.ResourcesRequest
     ): ListenableFuture<ResourceBuilders.Resources> {
         Log.i(TAG, "onTileResourcesRequest version=${requestParams.version}")
-        return ResolvableFuture.create<ResourceBuilders.Resources>().apply {
-            set(ResourceBuilders.Resources.Builder().setVersion(RESOURCES_VERSION).build())
+        val resources = ResourceBuilders.Resources.Builder()
+            .setVersion(RESOURCES_VERSION)
+            .build()
+
+        return CallbackToFutureAdapter.getFuture { completer ->
+            completer.set(resources)
+            "DevOptionsTileService#onTileResourcesRequest"
         }
     }
 
@@ -101,7 +110,10 @@ class DevOptionsTileService : TileService() {
             )
             .build()
 
-        return ResolvableFuture.create<Tile>().apply { set(tile) }
+        return CallbackToFutureAdapter.getFuture { completer ->
+            completer.set(tile)
+            "DevOptionsTileService#onTileRequest"
+        }
     }
 
     /**

app/src/main/kotlin/com/fredapps/watchdevtools/LaunchDevOptionsActivity.kt

@@ -1,3 +1,7 @@
+/*
+ * SPDX-License-Identifier: GPL-3.0-only
+ */
+
 package com.fredapps.watchdevtools
 
 import android.app.Activity
@@ -9,9 +13,9 @@ import androidx.wear.tiles.TileService
 
 /**
  * No-UI launcher. Fires the Developer options intent and immediately finishes
- * so the user lands directly in Settings → Developer options, where Wireless
+ * so the user lands directly in Settings -> Developer options, where Wireless
  * debugging is one swipe away. Falls back to the top-level Settings activity if
- * Developer options haven't been unlocked yet (build-number tap × 7).
+ * Developer options haven't been unlocked yet (build-number tap x 7).
  *
  * As a side effect, asks the system to re-fetch our tile's content. The Wear
  * OS tile carousel aggressively caches tile layouts; without an explicit
@@ -22,8 +26,7 @@ class LaunchDevOptionsActivity : Activity() {
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         TileService.getUpdater(this).requestUpdate(DevOptionsTileService::class.java)
-        val action = intent.getStringExtra(EXTRA_SETTINGS_ACTION)
-            ?: Settings.ACTION_APPLICATION_DEVELOPMENT_SETTINGS
+        val action = supportedSettingsAction(intent.getStringExtra(EXTRA_SETTINGS_ACTION))
         try {
             startActivity(Intent(action).addFlags(Intent.FLAG_ACTIVITY_NEW_TASK))
         } catch (_: ActivityNotFoundException) {
@@ -37,5 +40,16 @@ class LaunchDevOptionsActivity : Activity() {
     companion object {
         /** Tile buttons pass the settings action to launch via this extra. */
         const val EXTRA_SETTINGS_ACTION = "settings_action"
+
+        private val SUPPORTED_SETTINGS_ACTIONS = setOf(
+            Settings.ACTION_APPLICATION_DEVELOPMENT_SETTINGS,
+            Settings.ACTION_BLUETOOTH_SETTINGS,
+            Settings.ACTION_WIFI_SETTINGS,
+        )
+
+        private fun supportedSettingsAction(action: String?): String =
+            action
+                ?.takeIf { it in SUPPORTED_SETTINGS_ACTIONS }
+                ?: Settings.ACTION_APPLICATION_DEVELOPMENT_SETTINGS
     }
 }