Seminar Cuttlefish – ADB, Fastboot und Fehleranalyse

Die technische Analyse virtueller Android-Geräte erfordert ein reproduzierbares Vorgehen über Gerätezustand, Protokolle, Prozesse, Dateisysteme und Bootphasen hinweg. Das Seminar verbindet die tägliche Arbeit mit ADB und Fastboot mit einer systematischen Diagnose von Start-, Verbindungs-, Leistungs- und Testfehlern.

Inhaltsübersicht

• Zielsetzung
• Zielgruppe
• Voraussetzungen
• Seminarinhalte
• Praxisübungen
• Methodik
• Einordnung

Zielsetzung

• ADB-Verbindungen zu einer oder mehreren Instanzen eindeutig aufbauen und verwalten
• Systemzustände mit Shell, logcat, dumpsys, bugreport und Prozesswerkzeugen untersuchen
• Boot-, Recovery- und Fastboot-Abläufe kontrolliert prüfen
• Fehlerbilder reproduzieren, eingrenzen, dokumentieren und für automatisierte Tests nutzbar machen

Zielgruppe

Android-Entwicklung, AOSP-Entwicklung, Testautomatisierung, Plattformbetrieb, DevOps, Qualitätssicherung und technischer Support.

Voraussetzungen

Grundkenntnisse von Linux und Android; ein bereits installierter Cuttlefish-Host oder Teilnahme am Installationsseminar.

Seminarinhalte

1. Schritt 1: Diagnoseumgebung vorbereiten

   Host, Instanznamen, Seriennummern, Ports und Berechtigungen werden geprüft. Für parallele Geräte entsteht eine eindeutige Zuordnung zwischen Testlauf, CVD-Instanz und ADB-Ziel.

2. Schritt 2: ADB-Verbindungen stabilisieren

   Verbindungsaufbau, Gerätezustände, Serverneustart, TCP-Verbindungen und gezielte Geräteauswahl werden schrittweise ausgeführt. Typische Ursachen für offline-, unauthorized- und mehrfach belegte Ziele werden getrennt behandelt.

3. Schritt 3: Systeminformationen erfassen

   Shell-Kommandos, Eigenschaften, Mounts, Speicher, Prozesse und Dienste werden zu einem reproduzierbaren Diagnoseprofil zusammengeführt. Die Erfassung wird so strukturiert, dass Vergleiche zwischen funktionierender und fehlerhafter Instanz möglich sind.

4. Schritt 4: Protokolle und Dienste analysieren

   logcat-Puffer, Kernelmeldungen, dumpsys-Ausgaben und Servicezustände werden gefiltert und zeitlich korreliert. Aus Symptomen entstehen prüfbare Hypothesen statt unsystematischer Einzelmaßnahmen.

5. Schritt 5: Boot- und Fastboot-Pfade prüfen

   Neustartvarianten, Bootloader- und fastbootd-Zustände, Partitionsinformationen und temporäre Image-Tests werden kontrolliert durchgeführt. Sicherheitsgrenzen zwischen Testsystem und produktionsnaher Konfiguration bleiben nachvollziehbar.

6. Schritt 6: Fehler reproduzierbar eingrenzen

   Ein Diagnosebaum verbindet Netzwerk, Hostvirtualisierung, Images, Gerätekonfiguration, Android-Dienste und Testwerkzeuge. Jeder Schritt erhält einen erwarteten Zustand und ein Abbruchkriterium.

7. Schritt 7: Diagnose in Automatisierung überführen

   ADB-Kommandos, Logsammlung, Artefakte und Rückgabecodes werden in skriptfähige Prüfungen überführt. Die Ergebnisse lassen sich anschließend in CI/CD-Läufe und Testberichte einbinden.

Praxisübungen

• Mehrere Instanzen starten, korrekt adressieren und eine vertauschte Seriennummernzuordnung beheben
• Einen absichtlich gestörten Android-Dienst anhand von logcat, dumpsys und Prozesszustand diagnostizieren
• Einen fehlgeschlagenen Bootvorgang dokumentieren und ein wiederholbares Diagnosepaket erzeugen

Methodik

Kurze Theorieblöcke werden unmittelbar mit Shell- und Geräteübungen verbunden. Diagnoseaufträge folgen einer festen Reihenfolge aus Beobachtung, Hypothese, Prüfung, Korrektur und erneuter Validierung.

Einordnung

Zwei Tage sind erforderlich, weil Bedienung und Datenerfassung am ersten Tag von Bootanalyse, Fastboot, strukturierter Fehlerisolation und Automatisierung am zweiten Tag getrennt geübt werden müssen.