Inhalt der Doku
Weelikeit F83W Home Assistant Kiosk · Doku
Image bauen
Wie tools/build_image.py das System-Image aus Original-GSI und src/ baut und wie der Workflow „Build image“ Releases veröffentlicht.
Das System-Image liegt nicht im Repository. Es entsteht reproduzierbar aus dem Original-GSI, der Home-Assistant-App
und den Dateien in src/. Das erledigt
tools/build_image.py,
normalerweise in GitHub Actions.
Quellen
build/sources.json legt
fest, woraus gebaut wird, jeweils mit Download-Adresse und SHA-256:
| Quelle | Stand |
|---|---|
| GSI | LineageOS 20 a64_bvS von AndyYan, Build vom 21.10.2025 |
| Home Assistant | Companion for Android, Variante „minimal“, Version 2026.8.4 |
Stimmt eine Prüfsumme nicht, bricht der Build ab.
Ablauf
Das Skript braucht weder Root noch Loop-Mounts, es arbeitet direkt auf der Image-Datei:
- GSI und App laden (mit Cache in
.cache/) und die Prüfsummen vergleichen. - Das GSI entpacken, das ext4-Image um 200 MB vergrößern und
shared_blocksauflösen, sonst ist es nicht beschreibbar. - Mit
debugfsin einem Durchgang ändern:- die Apps aus
src/removed-apps.txtentfernen - die App als System-App unter
/system/app/HomeAssistantablegen, ihrearmeabi-v7a-Bibliotheken entpackt - die Dateien aus
src/system-files.txtschreiben, mit Rechten, Besitzer und SELinux-Label rw-system.shmitsrc/system/bin/rw-system.sh.patchanpassensrc/product/build.prop.appendan/system/product/etc/build.propanhängen
- die Apps aus
- Das Dateisystem prüfen und auf die kleinstmögliche Größe schrumpfen.
- Optional mit
xzpacken undSHA256SUMSschreiben.
Lokal bauen
Das geht nur unter Linux mit e2fsprogs, patch und xz:
sudo apt-get install e2fsprogs patch xz-utils
python3 tools/build_image.py --version v9 --xz| Option | Standard | Beschreibung |
|---|---|---|
--version |
Pflicht | Version im Dateinamen, z. B. v9 |
--out |
out/ |
Zielordner |
--cache |
.cache/ |
Ordner für GSI und App |
--xz |
aus | zusätzlich .img.xz erzeugen |
Workflow „Build image“
.github/workflows/build-image.yml
baut das Image in drei Fällen:
| Auslöser | Ergebnis |
|---|---|
Pull Request mit Änderungen an src/, build/ oder am Build-Skript |
Image als Artefakt, 3 Tage aufbewahrt |
Tag v* gepusht |
Image als GitHub-Release |
| Manuell (Actions → Build image → Run workflow) | mit Version, wahlweise als Release |
Die Release-Notizen nennen den Commit, das GSI, die App-Version und die Prüfsummen.
Neue Version veröffentlichen
- Änderungen in
src/oderbuild/sources.jsonper Pull Request einbringen. Der Workflow baut das Image zur Probe. - Nach dem Merge den Tag setzen:
git tag v9
git push origin v9- Ist das Release fertig,
IMAGE_VERSIONinflash.shauf die neue Version setzen.
Tipp
Für eine neue Version der Home-Assistant-App reicht es, version, url und sha256 in build/sources.json zu
ändern.