Seminar AOSP Cuttlefish – AOSP-Builds und Edit-Compile-Run

Im Mittelpunkt steht ein reproduzierbarer Entwicklungszyklus für Android-Plattformcode. Die Teilnehmenden richten eine geeignete Buildumgebung ein, erzeugen passende Cuttlefish-Artefakte, testen Änderungen inkrementell und analysieren Fehler systematisch.

Inhaltsverzeichnis

1. Seminarüberblick
2. Zielgruppe
3. Voraussetzungen
4. Lernziele
5. Seminarinhalte
6. Praxisübungen
7. Kompetenzen

Seminarüberblick

Das Thema wird in einer methodisch aufgebauten Folge aus Einordnung, Demonstration, angeleiteter Umsetzung und eigenständiger Kontrolle bearbeitet. Jeder Arbeitsschritt endet mit einer technischen Verifikation.

Zielgruppe

• Android-Plattformentwickler
• Build- und Release-Engineers
• Systemintegratoren
• Entwickler von kundenspezifischen Android-Images

Voraussetzungen

Sichere Linux-Shell-Kenntnisse, Grundkenntnisse in Git und repo sowie ein grundlegendes Verständnis des AOSP-Buildsystems.

Lernziele

• AOSP-Branches und Cuttlefish-Ziele passend auswählen
• Host- und Geräteartefakte konsistent bauen und verwalten
• Änderungen mit kurzen Build- und Testzyklen validieren
• Build-, Boot- und Laufzeitfehler strukturiert eingrenzen

Seminarinhalte

Tag 1: Buildumgebung und vollständiger Plattform-Build

1. Schritt 1: Rollen von AOSP-Quellbaum, Produktziel, Hostpaket und Geräte-Images einordnen.
2. Schritt 2: Arbeitsverzeichnis, benötigte Werkzeuge, Speicherplanung und Build-Variablen vorbereiten.
3. Schritt 3: Geeigneten Release-Zweig und ein Cuttlefish-Produktziel für x86_64 oder ARM64 auswählen.
4. Schritt 4: Quellen synchronisieren, Buildumgebung initialisieren und einen vollständigen userdebug-Build erzeugen.
5. Schritt 5: Erzeugte Images, Hostwerkzeuge, Target Files und Protokolle identifizieren und versionieren.

Tag 2: Inkrementeller Edit-Compile-Run-Zyklus

1. Schritt 1: Eine überschaubare Framework- oder Systemänderung definieren und im Quellbaum lokalisieren.
2. Schritt 2: Abhängigkeiten bestimmen und nur die erforderlichen Module beziehungsweise Images neu bauen.
3. Schritt 3: Aktualisierte Artefakte in eine kontrollierte Cuttlefish-Laufzeitumgebung übernehmen.
4. Schritt 4: Gerät starten, Änderung über adb, logcat und Systemzustände verifizieren.
5. Schritt 5: Build-Caches, veraltete Ausgaben und inkonsistente Host- und Gastartefakte erkennen.

Tag 3: Reproduzierbarkeit, Debugging und Teamworkflow

1. Schritt 1: Buildparameter, Produktvarianten und Artefaktstände für reproduzierbare Ergebnisse dokumentieren.
2. Schritt 2: Typische Fehler in Soong, Ninja, Image-Erzeugung und Geräte-Start voneinander abgrenzen.
3. Schritt 3: Diagnoseinformationen aus Buildprotokollen, Kernelmeldungen und Android-Logs zusammenführen.
4. Schritt 4: Artefakte für Entwicklungs-, Test- und CI-Umgebungen eindeutig kennzeichnen und bereitstellen.
5. Schritt 5: Einen vollständigen Änderungsauftrag vom Commit bis zur validierten virtuellen Instanz durchführen.

Praxisübungen

• Vollständiger Cuttlefish-Build für ein ausgewähltes Produktziel
• Inkrementelle Framework-Änderung mit anschließendem Geräte-Start
• Analyse eines absichtlich erzeugten Build- oder Bootfehlers
• Erstellung einer kompakten Build- und Artefaktkonvention für ein Team

Kompetenzen

• Eigenständiger Aufbau eines belastbaren AOSP-Entwicklungszyklus
• Sichere Unterscheidung von Host-, System-, Vendor- und Bootartefakten
• Nachvollziehbare Diagnose und Dokumentation von Buildproblemen