Vollständige Autotests in der Verpackung

Complete Automotive Tests in a Box (CATBox) ist ein Open-Source-Paket, das die Frameworks und Tools zur Optimierung und Ausführung von Automotive-Tests mit minimaler Konfiguration bereitstellt. CATBox ist skalierbar und kompatibel mit den Tools, der Infrastruktur und den Tests, die Sie zum Testen und Validieren Ihrer Android Automotive OS-Implementierungen (AAOS) verwenden. So können Sie dem Marktplatz hochwertige Produkte anbieten.

CATBox-Design und -Implementierung

Die CATBox-Testsuite bietet die Tools, Frameworks und Tests, die für die Durchführung von Funktions- und Leistungstests auf einem Automotive-Zielgerät und unter Verwendung eines Companion-Geräts erforderlich sind.

Das folgende Bild zeigt ein allgemeines Design eines CATBox-Pakets.

Abbildung 1: CATBox-Paket

Tradefed

Tradefed ist ein Open-Source-Framework für kontinuierliche Tests, mit dem Tests auf Android-Geräten ausgeführt werden. Weitere Informationen finden Sie unter Trade Federation – Übersicht.

Testframework für die Automobilbranche

CATBox basiert auf einem Automotive-Test-Framework namens Spectatio, das APIs zum Testen verschiedener Apps auf Automotive-Geräten bereitstellt. Es basiert auf UI Automator, einem Open-Source-Test-Framework, das eine Reihe von APIs zum Erstellen von UI-Tests bietet, die mit Nutzer- und Systemanwendungen interagieren.

Downloads der CATBox-Testsuite

Android 14

Android Automotive 14 ist die Version des Entwicklungsmeilensteins mit dem Codenamen „U“. Über die folgenden Links können Sie CATBox-Testsuites für Android 14 herunterladen:

• Android 14 (arm64)
• Android 14 (x86_64)

Android 12

Android 12 ist die Version des Entwicklungsmeilensteins mit dem Codenamen „S“. Über die folgenden Links können Sie CATBox-Testsuites für Android 12 herunterladen:

• Android 12 (arm64)
• Android 12 (x86_64)

Android 11

Android 11 ist die Version des Entwicklungsmeilensteins mit dem Codenamen „R“. Über die folgenden Links können Sie CATBox-Testsuites für Android 11 herunterladen:

• Android 11 (arm64)
• Android 11 (x86_64)

CATBox erstellen

Verwenden Sie den Befehl catbox build, sobald der Android-AOSP-Code auf der lokalen Workstation verfügbar ist.

So erstellen Sie das CATBox-Paket lokal:

1. Wählen Sie das Geräteziel basierend auf der Gerätearchitektur aus und führen Sie den folgenden Befehl aus:

   lunch <target>

2. Führen Sie zum Erstellen von CATBox den folgenden Befehl aus:

   make catbox

   Mit diesem Befehl wird die Datei android-catbox.zip im Verzeichnis /out/host/linux-x86/catbox erstellt, die dann zum Ausführen von Tests verwendet werden kann.

Umgebung einrichten

Die Einrichtung der Umgebung, die zum Ausführen von CATBox-Tests erforderlich ist, ähnelt der Einrichtung der CTS. Führen Sie die folgenden Aufgaben aus, um die Umgebung einzurichten:

• Installieren Sie ADB und AAPT.

• Installieren Sie das JDK. Weitere Informationen finden Sie unter Java Development Kit für Ubuntu.

• Erhöhen Sie das Speicherlimit. Weitere Informationen zu den Speicheranforderungen

CATBox einrichten und ausführen

Verwenden Sie das Tradefed-Testframework, um die Tests auf Android-Geräten auszuführen. Lesen Sie vor der Einrichtung von CATBox die Trade Federation-Übersicht.

Informationen zum Einrichten und Ausführen von CATBox finden Sie in den folgenden Abschnitten.

Gerät einrichten

Bevor Sie einen Testplan ausführen, müssen Sie Ihr Gerät so einrichten:

1. Sie müssen die neuesten Versionen von Android Debug Bridge (adb) und Android Asset Packaging Tool (AAPT) installiert haben und den Speicherort dieser Tools dem Systempfad Ihres Computers hinzugefügt haben. Weitere Informationen finden Sie unter ADB und AAPT.

2. Schließen Sie mindestens ein Gerät an und bereiten Sie das Testgerät (Device Under Test, DUT) so vor:

   1. Wenn Sie das Autogerät auf die Werkseinstellungen zurücksetzen möchten, gehen Sie zu Einstellungen > System > Optionen zum Zurücksetzen > Alle Daten löschen.

   2. Warten Sie, bis das Gerät automatisch neu gestartet wird.

   3. Prüfen Sie, ob ADB aktiviert ist. Führen Sie den folgenden Befehl aus, um zu prüfen, ob das Gerät verfügbar ist:

      adb devices

   4. Führen Sie den folgenden Befehl aus, um den Root-Benutzer zu aktivieren:

      adb -s DEVICE_SERIAL root

      Ersetzen Sie DEVICE_SERIAL durch die Seriennummer des Auto-Geräts.

   5. Stellen Sie eine Verbindung zum WLAN her.

CATBox-Paket extrahieren

Entpacken Sie nach der Einrichtung des Geräts das CATBox-Paket und rufen Sie den extrahierten Ordner auf:

unzip android-catbox.zip
cd android-catbox

Tests in CATBox ausführen

So führen Sie CATBox mit den Testplänen im CATBox-Paket aus:

./tools/catbox-tradefed run commandAndExit TEST_PLAN_NAME --serial DEVICE_SERIAL

Ersetzen Sie DEVICE_SERIAL durch die Seriennummer des Auto-Geräts. Wenn mehrere Geräte mit dem Hostcomputer verbunden sind, verwenden Sie DEVICE_SERIAL, um sie voneinander zu unterscheiden. Ersetzen Sie TEST_PLAN_NAME durch den Namen des Testplans, den Sie ausführen möchten.

Die vollständigste Liste der verfügbaren Tarife erhalten Sie über die Befehlszeile:

./tools/catbox-tradefed list plans | grep -i catbox

Arten von Testplänen

In der folgenden Tabelle sind die verfügbaren funktionalen Testpläne aufgeführt.

In der folgenden Tabelle sind die Leistungstestpläne für CATBox aufgeführt.

Hostseitigen Test für mehrere Geräte ausführen

Bei der Ausführung von hostseitigen Tests mit mehreren Geräten wird CATBox verwendet, um den Test in einer Sitzung auszuführen. Beispiel: BTDiscoveryTest:

make catbox
./tools/catbox-tradefed run commandAndExit catbox-functional-bluetooth-tests --{phone}serial <serial> --{auto}serial <serial> --mobly-host:mobly-par-file-name BTDiscoveryTest

CATBox installiert die apk und führt den Test dann in der richtigen Python-Ausführungsumgebung aus.

CATBox-Testergebnisse prüfen

Die Ergebnisse von Funktions- und Leistungstests werden in android-catbox/results/latest gespeichert.