Automatisierte CTS-Tests ausführen (Android 11 oder höher)

Es gibt zwei Möglichkeiten, automatisierte CTS-Tests auszuführen:

  • Trade Federation ist ein App- und Test-Framework, mit dem Sie Tests über die Befehlszeile ausführen können. Im Grunde können Sie mit dem Framework Tests mit der @Test-Anmerkung versehen. Die App findet und führt diese Tests dann aus.

  • OmniLab Android Test Station ist eine App, mit der Sie Tests in einer grafischen Benutzeroberfläche ausführen können.

Auf dieser Seite wird erläutert, wie Sie automatisierte Tests mit Trade Federation ausführen. Eine Anleitung zum Ausführen von Tests mit dem OmniLab Android Test Harness finden Sie unter OmniLab Android Test Station.

Alle automatisierten CTS-Tests ausführen

Trade Federation enthält die CTS-Konsole, eine Befehlszeilenschnittstelle zum Ausführen von Tests. So führen Sie die gesamte automatisierte CTS-Testsuite aus:

  1. Folgen Sie der Anleitung unter Automatisierte CTS-Tests einrichten.

  2. Starten Sie auf Ihrer Test-Workstation die CTS-Konsole, indem Sie das cts-tradefed-Script aus dem Ordner ausführen, in dem das CTS-Paket entpackt wurde:

    ./android-cts/tools/cts-tradefed

    In der CTS-Konsole wird ein Cursor angezeigt, über den Sie CTS-Befehle eingeben können (cts-tradefed >).

  3. Der Testplan cts enthält alle automatisierten CTS-Tests. Führen Sie den folgenden Befehl aus, um den cts-Testplan auszuführen:

    run cts

    Die automatisierten CTS-Tests werden ausgeführt. Beachten Sie Folgendes:

    • Android 13 und höher unterstützen Tests auf mehreren Geräten. Diese Tests werden nur dann automatisch ausgeführt, wenn das Sharding verwendet wird. Weitere Informationen zum Sharding finden Sie unter Testausführungszeit verbessern. Wenn Sie diese Tests manuell ausführen möchten, lesen Sie den Hilfeartikel Mehrere Geräte gleichzeitig testen.

    • Wenn Sie CTS ausführen, drücken Sie Strg + C, um die vorhandene CTS-Konsole anzuhalten, und führen Sie die CTS-Konsole dann noch einmal aus.

    • Sie können nicht mehrere CTS-Versionen auf einem einzigen Host ausführen, da jede mit einem vorhandenen OLC-Server (Open Location Code) geöffnet wird.

  4. Testergebnisse ansehen Weitere Informationen finden Sie unter CTS-Ergebnisse auswerten.

  5. Wenn dies Ihr erster Testlauf ist, können Tests aufgrund von Problemen fehlschlagen, die außerhalb Ihrer Kontrolle liegen. Beispielsweise kann eine Netzwerkverbindung langsam oder ein GPS-Signal schwach sein. Wiederholen Sie die Tests so lange, bis alle Testmodule abgeschlossen sind und die Anzahl der Testfehler zwischen den letzten beiden Wiederholungen gleich ist:

    run retry --retry session_number`

  6. Wenn die Tests bei mehreren Wiederholungen immer wieder fehlschlagen, konzentrieren Sie sich auf die Fehlerbehebung für die verbleibenden fehlgeschlagenen Tests. Informationen zur Fehlerbehebung bei Testergebnissen finden Sie unter Fehlerbehebung bei Testausfällen und Fehlerbehebung bei CTS-Tests.

CTS für Multiscreen-Geräte ausführen

Wenn auf Ihrem Gerät Android 11 oder 12 installiert ist und es mehrere Bildschirme hat, müssen Sie den cts-foldable-Testplan separat ausführen:

run cts-foldable

An erfolgreiche oder fehlgeschlagene Testfälle für den alternativen Bildschirmmodus wird der Wert aus display_mode angehängt, z. B. testcase1[display_mode=0].

Mehrgerätetests ausführen

Führen Sie den folgenden Befehl aus, um den cts-multidevice-Testplan auszuführen:

run cts-multidevice

Einzelne Testpläne ausführen

Anstatt alle Testpläne gleichzeitig auszuführen, können Sie auch einzelne Testpläne ausführen. Mit dieser Option können Sie Zeit sparen und sich auf eine bestimmte Gruppe von Tests konzentrieren. So führen Sie einen einzelnen Testplan aus:

  1. Geben Sie den Namen des Testplans an, den Sie ausführen möchten, indem Sie den Befehl list modules ausführen.

  2. Testplan ausführen:

    run cts --plan test_module_or_plan_name

Ausführungszeit des Tests verbessern

Wenn Sie die Ausführungszeit von Tests verbessern möchten, können Sie Tests auf mehrere Geräte aufteilen. Für das Sharding muss der Host mindestens zwei Geräte verbinden. Für eine hohe Effizienz werden jedoch sechs oder mehr Geräte empfohlen.

Wenn Sie Tests unter Android 11 oder höher aufteilen möchten, führen Sie Folgendes aus:

run cts --shard-count number_of_shards

Außerdem können Sie vor dem Ausführen der Tests zur Validierung die Ausführungszeit mit dem CTS-Befehl run cts-dev verbessern. Mit diesem Befehl werden die Voraussetzungen, die Erhebung von Geräteinformationen und alle Prüfungen des Systemstatus übersprungen. Außerdem werden die Tests nur für ein einziges ABI ausgeführt.