Seminar Waydroid Image-Build mit LineageOS und Android-Generic

Das Seminar behandelt den Aufbau eigener Waydroid-System- und Vendor-Images aus einem vorbereiteten Quellstand. Build-Host, Repo-Workflow, LineageOS-basierter Build, Android-Generic-Optionen, Patchkonflikte, Artefaktprüfung, Installation und Reproduzierbarkeit werden als zusammenhängende Build-Pipeline umgesetzt.

Seminarziel

Ziel ist eine dokumentierte Build- und Teststrecke für eigene Waydroid-Images mit kontrolliertem Patch- und Artefaktmanagement.

Zielgruppe

Android-Plattformentwickler, Linux- und Build-Administratoren, Integratoren und DevOps-Fachkräfte

Voraussetzungen

Sehr gute Linux- und Git-Kenntnisse, Shell-Scripting, Android-Grundlagen und ausreichend leistungsfähige Build-Hardware

Inhaltsverzeichnis

1. 1. Build-Architektur und Ressourcenplanung
2. 2. Werkzeuge und Repo-Workflow vorbereiten
3. 3. Quellstand initialisieren und synchronisieren
4. 4. Waydroid-Patches und Vendor-Inhalte integrieren
5. 5. LineageOS-basierten Build konfigurieren
6. 6. Android-Generic-Buildoptionen nutzen
7. 7. Build ausführen und überwachen
8. 8. Patchkonflikte manuell lösen
9. 9. Artefakte prüfen und paketieren
10. 10. Images installieren und testen
11. 11. Reproduzierbarkeit und Pflege sichern

Seminarinhalte

1. Build-Architektur und Ressourcenplanung

Der Build wird hinsichtlich Quellumfang, CPU, RAM, Speicher und Zeit realistisch geplant.

1. Schritt 1: Zielarchitektur und gewünschte Android-Basis festlegen.
2. Schritt 2: Build-Host auf CPU, Arbeitsspeicher und freien Speicher prüfen.
3. Schritt 3: Verzeichnisstruktur für Quellen, Caches, Artefakte und Logs definieren.
4. Schritt 4: Wiederanlaufstrategie für unterbrochene Builds festlegen.

2. Werkzeuge und Repo-Workflow vorbereiten

Die Quellverwaltung wird reproduzierbar eingerichtet.

1. Schritt 1: Erforderliche Compiler-, Java-, Python- und Android-Buildwerkzeuge installieren.
2. Schritt 2: Git-Identität und Repo-Werkzeug konfigurieren.
3. Schritt 3: Manifest-Zweig und Zielprodukt dokumentieren.
4. Schritt 4: Lokale Caches und Parallelisierung passend zum Host einstellen.

3. Quellstand initialisieren und synchronisieren

Der vollständige Quellbaum wird kontrolliert aufgebaut.

1. Schritt 1: Arbeitsverzeichnis erstellen und Repo-Initialisierung ausführen.
2. Schritt 2: Manifest und Revisionen sichern.
3. Schritt 3: Quellen synchronisieren und Abbrüche gezielt fortsetzen.
4. Schritt 4: Vollständigkeit und verfügbaren Speicher nach dem Sync prüfen.

4. Waydroid-Patches und Vendor-Inhalte integrieren

Plattformspezifische Änderungen werden nachvollziehbar angewendet.

1. Schritt 1: Waydroid-Vendor- und Hardwarequellen in den Buildbaum einordnen.
2. Schritt 2: Patchsatz auswählen und automatisiert anwenden.
3. Schritt 3: Ergebnislisten nach angewendet, bereits vorhanden und Konflikt auswerten.
4. Schritt 4: Lokale Anpassungen in separaten Commits sichern.

5. LineageOS-basierten Build konfigurieren

Produkt, Variante und Architektur werden für die gewünschte Ausgabe gesetzt.

1. Schritt 1: Build-Umgebung initialisieren.
2. Schritt 2: Waydroid-Zielprodukt auswählen.
3. Schritt 3: Userdebug- oder andere Variante begründet festlegen.
4. Schritt 4: Buildparameter und Umgebungsvariablen protokollieren.

6. Android-Generic-Buildoptionen nutzen

Alternative Buildpfade und App-Varianten werden vergleichbar konfiguriert.

1. Schritt 1: Buildskript und verfügbare Optionen prüfen.
2. Schritt 2: Zielgerät, Variante und App-Typ auswählen.
3. Schritt 3: Desktop-Mode-Integration und Zusatzoptionen festlegen.
4. Schritt 4: Konfiguration vor dem Start als Buildprofil sichern.

7. Build ausführen und überwachen

Lange Buildläufe werden mit aussagekräftigen Logs und klarer Fehlerbehandlung betrieben.

1. Schritt 1: Build mit angemessener Parallelisierung starten.
2. Schritt 2: Logausgabe und Systemressourcen überwachen.
3. Schritt 3: Fehlerstelle auf erstes relevantes Ereignis zurückführen.
4. Schritt 4: Nach Korrektur gezielt fortsetzen statt unnötig vollständig neu zu bauen.

8. Patchkonflikte manuell lösen

Konflikte werden in Git nachvollziehbar behoben und als wiederverwendbarer Patch gesichert.

1. Schritt 1: Tatsächlichen Konflikt von alternativer, bereits angewendeter Patchvariante unterscheiden.
2. Schritt 2: Patchversuch mit Git und anschließend mit Patchwerkzeug reproduzieren.
3. Schritt 3: Reject-Dateien auswerten und Quellcode fachlich korrigieren.
4. Schritt 4: Änderung committen und neuen Konfliktlösungs-Patch erzeugen.

9. Artefakte prüfen und paketieren

System- und Vendor-Images werden vor der Installation technisch abgenommen.

1. Schritt 1: Erzeugte Images und Begleitdateien lokalisieren.
2. Schritt 2: Dateigröße, Zeitstempel und Prüfsummen erfassen.
3. Schritt 3: Buildprofil, Manifestrevision und Patchstand beilegen.
4. Schritt 4: Freigabepaket mit eindeutiger Versionskennung erstellen.

10. Images installieren und testen

Der Build wird in einer getrennten Waydroid-Testinstanz validiert.

1. Schritt 1: Aktuelle Testinstanz und Daten sichern.
2. Schritt 2: Custom Images in der vorgesehenen Ablage installieren.
3. Schritt 3: Waydroid neu initialisieren und Erststart überwachen.
4. Schritt 4: Boot, Grafik, Netzwerk, Apps, Eingabe und Persistenz mit einer Testmatrix prüfen.

11. Reproduzierbarkeit und Pflege sichern

Ein erfolgreicher Einzelbuild wird zu einem wartbaren Prozess.

1. Schritt 1: Buildskripte und Konfigurationsprofile versionieren.
2. Schritt 2: Abhängigkeiten, Quellrevisionen und Patchreihenfolge festhalten.
3. Schritt 3: Clean-Build und inkrementellen Build vergleichen.
4. Schritt 4: Update-, Regressionstest- und Rollbackverfahren definieren.

Praxisorganisation

Die Buildläufe arbeiten mit vorbereiteten Quellständen und Caches, damit Konfiguration, Patchen, Artefakterzeugung und Installation innerhalb der Seminardauer praktisch abgeschlossen werden können.