Jens Reinemann 6116a6c6ef docs: Android-Skills und Dev-Skript hinzufügen

Drei Copilot-Skills für den Android-Workflow:
- android-build: Gradle-Build, bekannte Issues (OneDrive, stderr)
- android-emulator: AVD-Verwaltung, Boot-Handling, S24Ultra_API35
- android-device: Physisches Gerät (Samsung S24 Ultra), USB/Wireless ADB

Zentrales PowerShell-Skript android-dev.ps1 mit 13 Aktionen:
build, clean, clean-build, emulator-start/stop, install-emulator/device,
launch, deploy-emulator/device, logcat, devices, screenshot.
Getestet: build, deploy-emulator, screenshot, emulator-stop.

2026-05-13 16:57:24 +02:00

4.1 KiB

Raw Blame History

name	description
android-device	App auf echtes Android-Handy (Samsung S24 Ultra) deployen, USB-Debugging, Wireless ADB, Logcat auf physischem Gerät. Trigger-Phrasen: 'echtes Handy', 'physisches Gerät', 'USB Debugging', 'Samsung', 'S24', 'auf dem Handy testen', 'Wireless ADB', 'Device'.

Skill: Android Device (Samsung S24 Ultra)

Deployt die Krisenvorrat-App auf das physische Samsung Galaxy S24 Ultra.

Gerätedaten

Eigenschaft	Wert
Modell	Samsung Galaxy S24 Ultra
Display	6.8" QHD+ (3120 × 1440), 505 PPI
Android-Version	Android 14+ (API 34+)
SoC	Snapdragon 8 Gen 3
RAM	12 GB

Ersteinrichtung (einmalig)

1. USB-Debugging aktivieren

Auf dem Samsung S24 Ultra:

Einstellungen → Über das Telefon → Softwareinformationen
Buildnummer 7× tippen → Entwickleroptionen werden aktiviert
Einstellungen → Entwickleroptionen:
- USB-Debugging aktivieren
- USB-Debugging-Autorisierungen widerrufen (falls Probleme)
- Optional: Bildschirm beim Laden aktiv lassen aktivieren

2. USB-Verbindung

Samsung mit USB-C-Kabel an PC anschließen
Auf dem Handy: USB-Debugging zulassen? → Immer von diesem Computer zulassen → OK
Prüfen:

C:\Users\JensR\AppData\Local\Android\Sdk\platform-tools\adb.exe devices -l

Erwartete Ausgabe:

XXXXXXXXXXXXXXXX   device product:dm3q model:SM_S928B device:dm3q transport_id:N

3. Wireless ADB (optional, kabellos)

$adb = "C:\Users\JensR\AppData\Local\Android\Sdk\platform-tools\adb.exe"

# Bei verbundenem USB: Wireless Pairing starten
& $adb tcpip 5555

# IP-Adresse des Handys finden (Einstellungen → Über das Telefon → Status → IP-Adresse)
& $adb connect 192.168.X.X:5555

# USB-Kabel kann jetzt entfernt werden

Operationen via Skript

# App bauen + auf Gerät installieren + starten
& ".github/skills/android-build/android-dev.ps1" -Action deploy-device

# Nur installieren (ohne Build)
& ".github/skills/android-build/android-dev.ps1" -Action install-device

# App starten
& ".github/skills/android-build/android-dev.ps1" -Action launch -Target device

# Logcat vom Gerät
& ".github/skills/android-build/android-dev.ps1" -Action logcat -Target device

Manuelle Kommandos (Fallback)

App installieren

$adb = "C:\Users\JensR\AppData\Local\Android\Sdk\platform-tools\adb.exe"
& $adb -d install -r "app\build\outputs\apk\debug\app-debug.apk"

-d = nur physisches Gerät (nicht Emulator), -r = Reinstall.

App starten

& $adb -d shell am start -n de.krisenvorrat.app/.MainActivity

Logcat (gefiltert)

& $adb -d logcat --pid=$(& $adb -d shell pidof de.krisenvorrat.app) -v time

Screenshot vom Gerät

& $adb -d exec-out screencap -p > device-screenshot.png

App deinstallieren

& $adb -d uninstall de.krisenvorrat.app

Bekannte Probleme

1. `unauthorized` in `adb devices`

Das Handy fragt nach USB-Debugging-Berechtigung, die noch nicht bestätigt wurde.

Lösung:

Display entsperren
Dialog USB-Debugging zulassen? bestätigen
Falls kein Dialog: Entwickleroptionen → USB-Debugging-Autorisierungen widerrufen → USB neu anschließen

2. `no devices/emulators found`

Checkliste:

USB-Kabel prüfen (manche Kabel sind nur zum Laden)
USB-Debugging aktiviert?
ADB-Daemon neu starten: & $adb kill-server; & $adb start-server
Samsung-USB-Treiber installiert?

3. `INSTALL_FAILED_UPDATE_INCOMPATIBLE`

Die App ist mit einem anderen Signaturschlüssel installiert.