In diesem Dokument finden Sie eine detaillierte Anleitung zum Erstellen von Modulen für mehrere Geräte. Außerdem werden aktuelle Einschränkungen genannt, sofern bekannt.
Die Stichprobe
Es wird ein CTS-WLAN-fähiges Multi-Device-Modul bereitgestellt. Es sendet eine Nachricht von einem Gerät über WLAN und überprüft, ob das andere Gerät sie empfängt.
Die Quelle für das Modul befindet sich unter packages/modules/Wifi/tests/hostsidetests/multidevices/test/aware/.
Wir haben das Beispiel mit so vielen Kommentaren versehen, wie wir es für nützlich halten.
Schritt 1: Modulordner erstellen
Es empfiehlt sich, einen Ordner für das Modul mit mehreren Geräten in dem Suiteprojekt zu erstellen, zu dem es gehört. Beispiel: cts/hostsidetests/multidevices/. Wir empfehlen dies, damit alle Module mit mehreren Geräten zumindest am selben Standort verbleiben, sodass Beispiele leichter gefunden werden können.
Alle Dateien für dieses Modul sollten sich in einem eigenen Modulordner befinden. Beispiel: wifi_aware.
Schritt 2: Test erstellen
Hier implementieren Sie Ihre Testlogik. Das hängt stark davon ab, was getestet wird.
Erstellen Sie die Mobly-Testquelle, z. B. wifi_aware_test.py.
Schritt 3: Build-Datei erstellen: Android.bp
Fügen Sie eine Android.bp-Datei wie packages/modules/Wifi/tests/hostsidetests/multidevices/test/Android.bp hinzu. Definieren Sie ein python_test_host-Modul, das ungefähr so aussieht:
python_test_host {
name: "CtsWifiAwareTestCases",
main: "wifi_aware_test.py",
srcs: ["wifi_aware_test.py"],
test_suites: [
"cts",
"general-tests",
],
test_options: {
unit_test: false,
},
data: [
// Package the snippet with the mobly test
":wifi_aware_snippet",
],
}
Geben Sie die Snippets für den Test mit dem Datenfeld an. Sie werden mit dem Binärcode verpackt und können von ATest oder in der kontinuierlichen Ausführung im Test gefunden und installiert werden.
Mobly Bundled Snippets sind in Android unter external/mobly-bundled-snippets/ verfügbar.
Optional: Benutzerdefinierte Snippets erstellen
Für einige Module für mehrere Geräte sind möglicherweise benutzerdefinierte Mobly-Snippets erforderlich. Der Beispieltest enthält ein WLAN-fähiges Snippet unter packages/modules/Wifi/tests/hostsidetests/multidevices/com.google.snippet.wifi/aware/WifiAwareSnippet.java, das mit der Mobly-Snippet-Lib erstellt wurde. Diese ist unter Android unter external/mobly-snippet-lib/ verfügbar.
Das Snippet sollte in Android.bp mit der Regel „android_test“ wie bei der Standardinstrumentierung definiert werden:
android_test {
name: "wifi_aware_snippet",
sdk_version: "current",
srcs: [
"CallbackUtils.java",
"WifiAwareSnippet.java",
],
manifest: "AndroidManifest.xml",
static_libs: [
"androidx.test.runner",
"guava",
"mobly-snippet-lib",
],
}
Schritt 4: Modulkonfiguration erstellen: AndroidTest.xml
Fügen Sie eine Datei „AndroidTest.xml“ wie packages/modules/Wifi/tests/hostsidetests/multidevices/test/aware/AndroidTest.xml hinzu. In dieser Testkonfiguration müssen Sie zwei Geräte für den Test angeben, etwa so:
<configuration description="Config for CTS Wifi Aware test cases">
<option name="test-suite-tag" value="cts" />
<option name="config-descriptor:metadata" key="component" value="wifi" />
<option name="config-descriptor:metadata" key="parameter" value="not_instant_app" />
<option name="config-descriptor:metadata" key="parameter" value="not_multi_abi" />
<option name="config-descriptor:metadata" key="parameter" value="not_secondary_user" />
<device name="device1">
<!-- For coverage to work, the APK should not be uninstalled until after coverage is pulled.
So it's a lot easier to install APKs outside the python code.
-->
<target_preparer class="com.android.tradefed.targetprep.suite.SuiteApkInstaller">
<option name="test-file-name" value="wifi_aware_snippet.apk" />
</target_preparer>
<target_preparer class="com.android.tradefed.targetprep.RunCommandTargetPreparer">
<option name="run-command" value="input keyevent KEYCODE_WAKEUP" />
<option name="run-command" value="wm dismiss-keyguard" />
</target_preparer>
<target_preparer class="com.android.tradefed.targetprep.PythonVirtualenvPreparer">
<!-- Any python dependencies can be specified and will be installed with pip -->
<option name="dep-module" value="mobly" />
</target_preparer>
</device>
<device name="device2">
<target_preparer class="com.android.tradefed.targetprep.suite.SuiteApkInstaller">
<option name="test-file-name" value="wifi_aware_snippet.apk" />
</target_preparer>
<target_preparer class="com.android.tradefed.targetprep.RunCommandTargetPreparer">
<option name="run-command" value="input keyevent KEYCODE_WAKEUP" />
<option name="run-command" value="wm dismiss-keyguard" />
</target_preparer>
</device>
<test class="com.android.tradefed.testtype.mobly.MoblyBinaryHostTest">
<!-- The mobly-par-file-name should match the module name -->
<option name="mobly-par-file-name" value="CtsWifiAwareTestCases" />
<!-- Timeout limit in milliseconds for all test cases of the python binary -->
<option name="mobly-test-timeout" value="60000" />
</test>
</configuration>
Beachten Sie Folgendes:
- Dieser Beispieltest ist von Mobly abhängig. Für
PythonVirtualenvPreparerkönnen beliebige Abhängigkeiten angegeben werden, die dann mit pip installiert werden. - Die
mobly-par-file-namefürMoblyBinaryHostTestmuss mit dem Modulnamen in Android.bp übereinstimmen. - Geben Sie für den Test eine
mobly-test-timeoutan. Sie wird in Millisekunden angegeben und bezieht sich auf die gesamte Ausführung der Python-Binärdatei (alle Testfälle zusammen). Dies ist erforderlich, um zu verhindern, dass Testfälle bei Problemen ewig hängen bleiben. - Jedes
device-Tag kann auf jedem Gerät eine andere Einrichtung enthalten. Die Mobly-Konfiguration empfängt sie in der Reihenfolge, die in der XML-Datei angegeben ist.
Weitere Informationen zur Installation der Snippet-APK:
- Das ursprüngliche POC wurde aufgrund einer Unterhaltung mit dem Coverage-Team aktualisiert, um Snippet-APKs über target_preparer zu installieren: Damit die Abdeckungsmessungen nicht zu früh gelöscht werden, bietet die Deinstallation über Harness anstelle von Testcode in Python-Binärdateien bessere Garantien in Bezug auf die Zeit.
Schritt 5: Test lokal ausführen: atest
Derzeit werden Tests für mehrere Geräte nur auf physischen Geräten ausgeführt. Prüfen Sie vor dem Testen, ob sich Ihre Testgeräte im richtigen Zustand befinden. Der Befehl adb
devices sollte eine Liste Ihrer verbundenen Geräte zurückgeben. Wenn die Liste Geräte enthält, die nicht für Tests vorgesehen sind, geben Sie die Geräte für den Test mit dem Flag „-s“ an.
Achten Sie bei WLAN-Tests darauf, dass das WLAN für die Geräte aktiviert ist (nach dem Zurücksetzen auf die Werkseinstellungen).
Sie können den Test lokal mit atest ausführen:
$ atest CtsWifiAwareTestCases
Die Anzahl der verwendeten Geräte sollte in der Zusammenfassung der Testausgabe angezeigt werden, z. B. Test executed with 2 device(s).
Fehlerbehebung
Wenn der Test bei der lokalen Ausführung aufgrund der folgenden Gründe fehlschlägt:
Virtualenv-Fehler
java.io.IOException: Cannot run program
"virtualenv": error=2, No such file or directory
Prüfen Sie, ob virtualenv in Ihrem PATH enthalten ist. Durch Hinzufügen von "~/.local/bin" zu "PATH" sollte das Problem behoben werden.
Wenn "Virtualenv" nicht installiert ist, folgen Sie der Anleitung unter https://Virtualenv.pypa.io/en/latest/installation.html.
Es wurden mindestens 2 Controllerobjekte erwartet, aber nur 1 ermittelt
Testmodule bestehen entweder aus mehreren Geräten oder einem einzelnen Gerät. Es gibt keine gemischten Module. Wenn Sie versuchen, ein Modul für mehrere Geräte ohne mehrere Geräte auszuführen, wird dieser Fehler angezeigt:
Expected to get at least 2 controller objects, got 1
Wenn Sie das Modul im Modus für mehrere Geräte ausführen, wird das Problem behoben.
Für CTS: Sie können Fragmentierung zum Auslösen verwenden (z. B. --shard-count 2) oder run cts-multidevces verwenden.