feat: multi-flavor APK build from dashboards.yaml
build / build (push) Failing after 3m29s

Dashboard URL and label configured in dashboards.yaml; each entry
becomes a product flavor with BuildConfig.DASHBOARD_URL injected
at build time. APKs output as <flavor>-release.apk.
This commit is contained in:
Arnie via Claude
2026-06-12 18:15:21 +02:00
parent 5af5b4513d
commit 4982af9df4
7 changed files with 89 additions and 24 deletions
+11 -7
View File
@@ -1,6 +1,7 @@
# android-webview-kiosk
Android TV app: fullscreen WebView showing one hardcoded Grafana dashboard.
Android TV app: fullscreen WebView showing a configurable Grafana dashboard.
Multiple APK flavors built from `dashboards.yaml` (repo root) — one APK per entry.
Runs on the living-room Sony Bravia KD-65XE9305 (Android 8.0, API 26;
Android System WebView updates independently via Play Store — currently v138).
Launched remotely through the Bravia REST IP-control API by Control4
@@ -27,19 +28,22 @@ replaces it before any gradle command runs.
## Commands (user-run, from repo root)
- Tests: `nix develop --command gradle --no-daemon :app:testReleaseUnitTest`
- Release APK: `nix develop --command gradle --no-daemon :app:assembleRelease`
`app/build/outputs/apk/release/app-release.apk`
- Tests: `nix develop --command gradle --no-daemon :app:testWeatherReleaseUnitTest`
- All APKs: `nix develop --command gradle --no-daemon :app:assembleRelease`
`app/build/outputs/apk/<flavor>/release/<flavor>-release.apk`
- Single APK: `nix develop --command gradle --no-daemon :app:assembleWeatherRelease`
- Sideload: `adb connect <tv-ip>:5555 && adb install -r <apk>`
(bump `versionCode` in app/build.gradle.kts first for upgrades)
- Fresh install: `adb uninstall cz.c3c.webviewkiosk && adb install <apk>`
## Key facts
- Package/applicationId: `cz.c3c.webviewkiosk`; repo name keeps the
`android-` prefix, the package can't (hyphens illegal).
- Dashboard URL hardcoded in `MainActivity.DASHBOARD_URL` — changing it
means rebuild + sideload. Intentional: keeps Control4 integration to a
single parameterless launch call.
- Dashboard URL + label configured in `dashboards.yaml` (repo root). Each
entry becomes a product flavor; `BuildConfig.DASHBOARD_URL` is injected
at build time. Changing a URL means editing the YAML, rebuilding, resideloading.
Intentional: keeps Control4 integration to a single parameterless launch call.
- `signing/release.keystore` is committed on purpose (private repo,
LAN-only kiosk) so every build is upgrade-compatible. Don't reuse the key.
- minSdk 26 is a hard floor — the TV never gets newer Android.
+30 -6
View File
@@ -1,23 +1,47 @@
# android-webview-kiosk
Fullscreen WebView kiosk for Android TV. Shows the house Grafana dashboard:
<https://grafana.c3c.cz/public-dashboards/381fe3e71e164eb99dd0b10e246a36e2>
Fullscreen WebView kiosk for Android TV. Shows configurable Grafana dashboards
defined in `dashboards.yaml`. Target device: Sony Bravia KD-65XE9305 (Android 8.0).
Built for remote launch via the Bravia REST IP-control API, driven by Control4.
Target device: Sony Bravia KD-65XE9305 (Android 8.0). Built for remote
launch via the Bravia REST IP-control API, driven by Control4.
## Dashboards
Defined in `dashboards.yaml` at repo root:
```yaml
weather:
url: https://grafana.c3c.cz/public-dashboards/...
label: Weather # shown in Bravia launcher
house_condition:
url: http://grafana.c3c.cz/public-dashboards/...
label: House Condition
```
Each entry produces a separate APK. Names must be valid Gradle identifiers
(letters, digits, underscores — no hyphens).
## Build
# all flavors
nix develop --command gradle --no-daemon :app:assembleRelease
APK: `app/build/outputs/apk/release/app-release.apk`
# single flavor
nix develop --command gradle --no-daemon :app:assembleWeatherRelease
APKs: `app/build/outputs/apk/<flavor>/release/<flavor>-release.apk`
## Sideload
1. TV one-time: Settings → About → press *Build* 7× → Developer options →
enable ADB debugging.
2. `adb connect <tv-ip>:5555`
3. `adb install -r app/build/outputs/apk/release/app-release.apk`
3. `adb install -r app/build/outputs/apk/weather/release/weather-release.apk`
Fresh install (removing old app first):
adb uninstall cz.c3c.webviewkiosk
adb install app/build/outputs/apk/<flavor>/release/<flavor>-release.apk
Upgrades: bump `versionCode` in `app/build.gradle.kts`, rebuild, reinstall
with `-r`. Same committed keystore = no uninstall needed.
+32 -3
View File
@@ -1,8 +1,14 @@
import org.yaml.snakeyaml.Yaml
plugins {
id("com.android.application")
id("org.jetbrains.kotlin.android")
}
@Suppress("UNCHECKED_CAST")
val dashboards: Map<String, Map<String, String>> =
Yaml().load(rootProject.file("dashboards.yaml").inputStream())
android {
namespace = "cz.c3c.webviewkiosk"
compileSdk = 34
@@ -15,11 +21,12 @@ android {
versionName = "0.1.0"
}
buildFeatures {
buildConfig = true
}
signingConfigs {
create("release") {
// Keystore is committed (private repo, LAN kiosk app) so every
// machine/CI produces the same signature and `adb install -r`
// upgrades work without uninstalling. Created in Task 6.
storeFile = rootProject.file("signing/release.keystore")
storePassword = "android-webview-kiosk"
keyAlias = "kiosk"
@@ -34,6 +41,28 @@ android {
}
}
flavorDimensions += "dashboard"
productFlavors {
dashboards.forEach { (name, config) ->
create(name) {
dimension = "dashboard"
buildConfigField("String", "DASHBOARD_URL", "\"${config["url"]}\"")
resValue("string", "app_name", config["label"] ?: name)
}
}
}
@Suppress("DEPRECATION")
applicationVariants.all {
val flavor = productFlavors.first().name
val type = buildType.name
outputs.all {
(this as com.android.build.gradle.internal.api.BaseVariantOutputImpl)
.outputFileName = "$flavor-$type.apk"
}
}
compileOptions {
sourceCompatibility = JavaVersion.VERSION_17
targetCompatibility = JavaVersion.VERSION_17
+1 -1
View File
@@ -15,7 +15,7 @@
android:allowBackup="false"
android:banner="@drawable/banner"
android:icon="@drawable/icon"
android:label="Grafana Kiosk"
android:label="@string/app_name"
android:usesCleartextTraffic="true"
android:theme="@android:style/Theme.NoTitleBar.Fullscreen">
@@ -15,11 +15,6 @@ import android.webkit.WebViewClient
class MainActivity : Activity() {
companion object {
const val DASHBOARD_URL =
"https://grafana.c3c.cz/public-dashboards/381fe3e71e164eb99dd0b10e246a36e2"
}
private lateinit var webView: WebView
private val handler = Handler(Looper.getMainLooper())
private val backoff = BackoffPolicy(initialDelayMs = 2_000, maxDelayMs = 60_000)
@@ -55,7 +50,7 @@ class MainActivity : Activity() {
if (!request.isForMainFrame) return
lastLoadFailed = true
handler.postDelayed(
{ view.loadUrl(DASHBOARD_URL) },
{ view.loadUrl(BuildConfig.DASHBOARD_URL) },
backoff.nextDelayMs(),
)
}
@@ -63,7 +58,7 @@ class MainActivity : Activity() {
setContentView(webView)
hideSystemUi()
webView.loadUrl(DASHBOARD_URL)
webView.loadUrl(BuildConfig.DASHBOARD_URL)
}
override fun onResume() {
+6
View File
@@ -1,3 +1,9 @@
buildscript {
dependencies {
classpath("org.yaml:snakeyaml:2.2")
}
}
plugins {
id("com.android.application") version "8.7.3" apply false
id("org.jetbrains.kotlin.android") version "2.0.21" apply false
+7
View File
@@ -0,0 +1,7 @@
weather:
url: https://grafana.c3c.cz/public-dashboards/381fe3e71e164eb99dd0b10e246a36e2
label: Weather
house_condition:
url: http://grafana.c3c.cz/public-dashboards/7d94ddc4493741debf49d0a301e1a757
label: House Condition