docs(android-agent): README-Build-Abschnitt praezisiert; Version 0.2.0
Ehrlicher Bau-Weg (nur Docker noetig, dist/aria-android-agent.apk, Debug-Key, Installieren, Erst-Build-Kosten/Stolperer). release.sh klar als M4 geplant markiert statt als vorhandener Befehl. versionCode 2 / versionName 0.2.0 (M1+M2). Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
@@ -116,16 +116,59 @@ identisch, nur der Wecker ändert sich.
|
|||||||
4. **Feinschliff** — `info`/`app_list`/`notify`, Build-Härtung, `release.sh`
|
4. **Feinschliff** — `info`/`app_list`/`notify`, Build-Härtung, `release.sh`
|
||||||
(Version-Param → Gitea-Release-Asset, wie die App).
|
(Version-Param → Gitea-Release-Asset, wie die App).
|
||||||
|
|
||||||
## Build & Release (geplant)
|
## Bauen
|
||||||
|
|
||||||
|
APK-Builds laufen **nur unter Linux** — deshalb im Docker-Container. Du brauchst
|
||||||
|
nichts Android-spezifisches installiert, **nur Docker**. Android-SDK, Gradle und
|
||||||
|
Build-Tools zieht der Container selbst (`Dockerfile.build`).
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd host-agent/android
|
cd host-agent/android
|
||||||
./build.sh # Docker (Android-SDK+Gradle) -> aria-android-agent.apk
|
./build.sh
|
||||||
./release.sh 0.1.0 # baut, taggt, laedt APK als Gitea-Release-Asset hoch
|
|
||||||
```
|
```
|
||||||
|
|
||||||
APK wird manuell aufs Zielgerät kopiert + installiert (unbekannte Quellen
|
`build.sh` baut das Image `aria-android-agent-build` und lässt darin
|
||||||
erlauben). Gitea-Release macht den Download einfach (wie die Haupt-App).
|
`gradle assembleDebug` laufen. Ergebnis:
|
||||||
|
|
||||||
|
```
|
||||||
|
host-agent/android/dist/aria-android-agent.apk
|
||||||
|
```
|
||||||
|
|
||||||
|
Das ist ein **Debug-APK**: auto-signiert mit dem Android-Debug-Key, also direkt
|
||||||
|
installierbar — ohne eigenen Keystore, ohne Play Store.
|
||||||
|
|
||||||
|
### Auf dem Handy installieren
|
||||||
|
|
||||||
|
1. `dist/aria-android-agent.apk` aufs Zielgerät kopieren (USB, Cloud, `adb install
|
||||||
|
dist/aria-android-agent.apk`, …).
|
||||||
|
2. Antippen → Android fragt nach **„Unbekannte Quellen / Aus dieser Quelle
|
||||||
|
installieren erlauben"** → erlauben.
|
||||||
|
3. App öffnen → verbinden (QR/manuell), „Steuerung erlauben" an, für M2 zusätzlich
|
||||||
|
„Bildschirm-Zugriff erlauben" + „Bedienungshilfe öffnen".
|
||||||
|
|
||||||
|
### Was der erste Build kostet
|
||||||
|
|
||||||
|
Der **erste** Lauf lädt viel (JDK-Image, Gradle, Android-SDK, Dependencies) und
|
||||||
|
dauert entsprechend — mehrere Minuten. Folge-Builds sind schnell (Docker-Layer +
|
||||||
|
Gradle-Cache im Image). Häufige Stolperer:
|
||||||
|
|
||||||
|
- **Docker fehlt / kein Zugriff** → `docker`-Rechte prüfen (`docker ps`).
|
||||||
|
- **Overlay-on-Overlay auf einem Live-ISO** („invalid argument" beim Image-Bau) —
|
||||||
|
gleiches Problem wie beim Desktop-Agent auf dem Mint-Live-System; von einer
|
||||||
|
installierten Linux-Kiste bauen.
|
||||||
|
- **Kotlin-/Manifest-Fehler** beim allerersten Bau eines neuen Meilensteins: den
|
||||||
|
Gradle-Fehler posten, das glätten wir schnell.
|
||||||
|
|
||||||
|
### Version setzen
|
||||||
|
|
||||||
|
Bis es `release.sh` gibt, wird die Version in `app/build.gradle` gepflegt
|
||||||
|
(`versionCode` / `versionName`). Aktuell `1` / `0.2.0` (M1+M2).
|
||||||
|
|
||||||
|
## Release (geplant — Meilenstein 4)
|
||||||
|
|
||||||
|
`release.sh <version>` — wie die `release.sh` der Haupt-App: nimmt die
|
||||||
|
Versionsnummer als Parameter, baut das APK, taggt und lädt es als
|
||||||
|
**Gitea-Release-Asset** hoch, damit der Download einfach ist. Noch nicht gebaut.
|
||||||
|
|
||||||
> Status: **M1 + M2 fertig** (verbinden, `info`, `screenshot`, `ui_dump`).
|
> Status: **M1 + M2 fertig** (verbinden, `info`, `screenshot`, `ui_dump`).
|
||||||
> Als Nächstes Meilenstein 3 (Steuern).
|
> Als Nächstes Meilenstein 3 (Steuern), Release-Skript in M4.
|
||||||
|
|||||||
@@ -11,8 +11,8 @@ android {
|
|||||||
applicationId 'de.hackersoft.ariaagent'
|
applicationId 'de.hackersoft.ariaagent'
|
||||||
minSdk 26
|
minSdk 26
|
||||||
targetSdk 33 // 33 vermeidet die Foreground-Service-Typ-Pflicht von 34
|
targetSdk 33 // 33 vermeidet die Foreground-Service-Typ-Pflicht von 34
|
||||||
versionCode 1
|
versionCode 2
|
||||||
versionName '0.1.0'
|
versionName '0.2.0'
|
||||||
}
|
}
|
||||||
|
|
||||||
buildTypes {
|
buildTypes {
|
||||||
|
|||||||
Reference in New Issue
Block a user