Der Android Compatibility Test Suite Verifier (CTS Verifier) ergänzt die Compatibility Test Suite (CTS): Während CTS APIs und Funktionen prüft, stellt CTS Verifier Tests für APIs und Funktionen bereit, Tests auf einem stationären Gerät ohne manuelle Eingabe oder Positionierung, z. B. Audio Qualität, Touchscreen, Beschleunigungsmesser und Kamera.
Voraussetzungen
Bevor Sie CTS Verifier ausführen, stellen Sie sicher, dass Sie über folgende Ausrüstung verfügen:
- Android-Gerät, dessen Android-API-Kompatibilität erfolgreich bestätigt wurde und die CTS-Prüfung bestehen. Dies ist das zu testende Gerät.
- Linux-Computer mit USB 2.0-kompatiblem Port Alle Verbindungen zum DUT über diesen Anschluss.
- Zweites Android-Gerät mit bekanntem kompatiblem Bluetooth, Wi-Fi Direct, WLAN Aware, UWB (wenn der DUT UWB unterstützt) und NFC-Hostkartenemulation (HCE) Implementierung.
- Ein WLAN-Router mit Name und Passwort des Zugangspunkts. Router in der Lage sein, die Verbindung zum Internet zu trennen, aber nicht mit Strom versorgt wird deaktiviert.
Bereiten Sie die Stative, Gerätehalter und die gemessenen erforderlichen Entfernungen für UWB-Tests, Wi-Fi NAN und Bluetooth RSSI. Weitere Informationen finden Sie unter Anwesenheitskalibrierung:
UICC-Anforderungen für NFC-Tests
CTS Verifier hat die folgenden NFC-Testläufe:
- Feldoff (verwendet Transaktionsdaten von 0x54)
- Auswahl aufheben (verwendet Transaktionsdaten von 0x52)
- HCI-Befehl (0025000000) (verwendet Transaktionsdaten aus 0x02)
Für Tests von Transaktionsereignissen sind zwei Geräte erforderlich, von denen eines über SecureElement UICC mit den folgenden Zugriffsregeln:
- CtsVerifier APK-Hash: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
- Authorized Application Identifier (AID) für den Zugriff auf NFC-Ereignisse: 0xA000000476416E64726F696443545341
Auf der Emulatorseite wird erwartet, dass das Transaktionsereignis die entsprechende in den Vordergrund zu stellen.
Einrichten
Ändern Sie den Systemsteuerungsmodus des Testgeräts in den Drei-Schaltflächen-Modus folgt:
- Öffnen Sie die Einstellungen.
- Gehen Sie zu System > Geste > Systemnavigation:
- Wählen Sie einen beliebigen schaltflächenbasierten Navigationsmodus, wobei der Drei-Schaltflächen-Modus bevorzugt wird, wenn verfügbar.
So richten Sie die CTS-Verifier-Testumgebung ein:
Auf dem Linux-Computer:
Führen Sie vor der Installation von CTS Verifier den folgenden Befehl aus, um Zugriff auf Nicht-SDK-Schnittstellen.
adb shell settings put global hidden_api_policy 1
Installieren Sie Android Studio.
Laden Sie das CTS Verifier APK für die zu testende Android-Version.
Verbinden Sie den DUT mit dem Linux-Computer.
Installieren Sie
CtsVerifier.apküber ein Terminal auf dem Linux-Computer auf dem DUT.adb install -r -g CtsVerifier.apk
Führen Sie ab Android 10 folgenden Befehl aus: um der App die Berechtigung zum Erstellen des Berichts zu erteilen.
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
Führen Sie ab Android 11 folgenden Befehl aus: können Berichte in einem selbst definierten Verzeichnis unter der das externe Verzeichnis der obersten Ebene auf dem Gerät.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
Führen Sie ab Android 13 folgenden Befehl aus: um CTS Verifier Zugriff auf die Test-API zu gewähren.
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
Führen Sie ab Android 14 folgenden Befehl aus: um der App die Berechtigung zu erteilen, den Bildschirm einzuschalten.
adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
Achten Sie darauf, dass auf dem DUT das Systemdatum und die Systemzeit korrekt eingestellt sind.
CTS-Verifizierung ausführen
Starten Sie die CTS Verifier App, indem Sie auf das CTS Verifier-Symbol auf dem DUT tippen.
Abbildung 1: Symbol: CTS Verifier
In der Anwendung werden mehrere Testsets für die manuelle Bestätigung angezeigt.
Abbildung 2: Testmenü der CTS-Prüfung
Jeder Test enthält eine Reihe gängiger Elemente am unteren Bildschirmrand.
Abbildung 3: Testbildschirm mit hervorgehobenen gängigen Testelementen
- Richtig (✓). Tippen, wenn der DUT die Testanforderungen gemäß den Informationen erfüllt Anleitung.
- Info (?). Tippe, um die Testanleitung anzuzeigen. Wird auch automatisch angezeigt wenn ein Test zum ersten Mal geöffnet wird.
- Fehlgeschlagen (!). Tippen, wenn der DUT die Testanforderungen gemäß den Informationen nicht erfüllt Anleitung.
Für einige Tests, z. B. für den USB-Zubehörmodus und den Kalibrierungstest der Kamera, müssen zusätzliche Testeinrichtung und Anweisungen, wie in den folgenden Abschnitten beschrieben.
USB-Zubehörmodus für Version 8.0 und höher testen
Abbildung 4: Testverfahren für USB-Zubehör für 8.0 und über
Abbildung 5: USB-Zubehörmodus wird für 8.0 und über
USB-Zubehörmodus für Version 7.x und niedriger testen
Für den Test des USB-Zubehörs ist ein Linux-Computer erforderlich, um den USB-Desktopcomputer auszuführen (Host-Programm) zur Verfügung.
- Verbinden Sie den DUT mit dem Linux-Computer.
Führen Sie auf dem Computer das Programm
cts-usb-accessoryaus der CTS aus. Verifiziererpaket:./cts-usb-accessory
Warten Sie, bis auf dem DUT eine Pop-up-Nachricht erscheint, und wählen Sie dann OK aus.
Abbildung 6: Test von USB-Zubehör
Gehen Sie in der Anwendung „CTS Verifier“ auf DUT zum USB-Zubehörtest.
Sehen Sie sich auf dem Computer die Ausgabe der Konsole an. Beispielausgabe:
CTS USB Accessory Tester Found possible Android device (413c:2106) - attempting to switch to accessory mode... Failed to read protocol versionfigure3 Found Android device in accessory mode (18d1:2d01)... [RECV] Message from Android device #0 [SENT] Message from Android accessory #0 [RECV] Message from Android device #1 [SENT] Message from Android accessory #1 [RECV] Message from Android device #2 [SENT] Message from Android accessory #2 [RECV] Message from Android device #3 [SENT] Message from Android accessory #3 [RECV] Message from Android device #4 [SENT] Message from Android accessory #4 [RECV] Message from Android device #5 [SENT] Message from Android accessory #5 [RECV] Message from Android device #6 [SENT] Message from Android accessory #6 [RECV] Message from Android device #7 [SENT] Message from Android accessory #7 [RECV] Message from Android device #8 [SENT] Message from Android accessory #8 [RECV] Message from Android device #9 [SENT] Message from Android accessory #9 [RECV] Message from Android device #10 [SENT] Message from Android accessory #10
Sichtfeld der Kamera kalibrieren
Gerät mithilfe der Kalibrierung des Sichtfelds schnell erkennen mit mittlerer Genauigkeit.
Richten Sie die Testumgebung ein:
- Drucken Sie die Ziel für calibration-pattern.pdf auf Papier im Format 11" x 17" oder A3.
- Befestigen Sie das gedruckte Muster auf einer festen Unterlage.
Richten Sie das Kameragerät und das gedruckte Ziel wie unten gezeigt aus. Diagramm.
Abbildung 7: Kameraziel gedruckt
Legen Sie die Zielbreite fest:
- Messen Sie den Abstand (in Zentimetern) zwischen den durchgezogenen Linien auf der Zielmuster, um Druckabweichungen zu berücksichtigen (ca. 38 cm).
- Starten Sie die Kalibrierungsanwendung.
- Klicken Sie auf die Einrichtungsschaltfläche und wählen Sie Markierungsabstand aus.
- Messen Sie den Abstand zum Zielmuster und geben Sie ihn ein (ca. 100 cm).
- Drücke die Zurück-Taste, um zur Kalibrierungsvorschau zurückzukehren.
Stellen Sie sicher, dass das Gerät und das Ziel wie in der Abbildung dargestellt platziert sind. wurden im Dialogfeld für die Einrichtung die richtigen Abstände eingegeben. Vorschau zeigt das Bild mit einer darüber gelegten vertikalen Linie an; sollte diese Zeile an der Mittellinie des Zielmusters ausrichten. Das transparente Raster kann zusammen mit den anderen vertikalen Linien verwendet werden, um sicherzustellen, dass die optische Achse orthogonal zum Ziel.
Führe den Kalibrierungstest durch:
- Wählen Sie mithilfe der Auswahl links unten eine Bildauflösung aus und tippen Sie dann auf um ein Foto aufzunehmen. Der Test wechselt in den Kalibrierungsmodus und zeigt das Foto mit zwei vertikalen Linien über dem Bild an.
- Genauigkeit bestimmen:
<ph type="x-smartling-placeholder">
- </ph>
- Wenn die Linien an den vertikalen Linien auf dem Zielmuster ausgerichtet sind auf die Größe von wenigen Zentimetern beschränkt, ausgewählte Auflösung ist korrekt.
- Wenn die Linien nicht aufeinander ausgerichtet sind, ist das angegebene Sichtfeld ungenau. Um dies zu korrigieren, bewegen Sie den Schieberegler unten auf dem Bildschirm, bis Das Overlay passt sich so genau wie möglich am Zielmuster an. Wenn das Overlay und das Zielmusterbild ausgerichtet sind, Das angezeigte Sichtfeld ist eine Annäherung an den Wert. Das angegebene Sichtfeld sollte nicht mehr als +/-2 Grad von den Kalibrierungswert.
- Drücke die Schaltfläche „Zurück“ und wiederhole den Kalibrierungstest für alle Bilder vom DUT unterstützten Auflösungen.
CTS Verifier für alternative Modi ausführen
Ab CTS 10 R6 und CTS 11 R2 unterstützt CTS Verifier die erforderlichen Tests. für Geräte mit alternativen Modi oder für Geräte mit mehr als einem Bildschirmmodus.
In CTS Verifier befindet sich oben in der Hauptlistenansicht eine Schaltfläche zum Aktivieren. zwischen dem aufgeklappten und dem zugeklappten Displaymodus wechseln. wird von der CTS-Prüfung die für den ausgewählten Anzeigemodus erforderlichen Tests. So führen Sie die alternative in CTS Verifier aktiviert ist, sollte die Schaltfläche auf den entsprechenden Bildschirm umgeschaltet werden. und führen Sie die Liste der angezeigten Tests aus.
Die Ergebnisse der aufgeklappten Tests werden im selben Bericht mit den aufgeklappten Tests erfasst. Tests durchführen. Um jedes Testergebnis zu identifizieren, aus dem das Test-Dataset stammt, wird ein wird jedem Testnamen im minimierten Modus ein Suffix hinzugefügt.
<Test result="fail" name="com.android.cts.verifier.deskclock.DeskClockTestsActivity[folded]">
<RunHistory subtest="CREATE_ALARM[folded]">
<Run start="1594176663973" end="1594176665841" isAutomated="false" />
</RunHistory>
</Test>
Ergebnisse exportieren
Wenn alle Tests abgeschlossen sind, können Sie die Ergebnisse als Bericht speichern und herunterladen auf einem Computer. Berichtsnamen werden anhand des DUT automatisch mit einem Zeitstempel versehen. Systemzeit.
Tippe zum Speichern der Testergebnisse oben in der Liste auf das Speichersymbol (auf einem Laufwerk). von Testkategorien.
Warten Sie auf eine Pop-up-Meldung, die den Dateipfad zum gespeicherten Bericht (für Beispiel:
/sdcard/verifierReports/ctsVerifierReport-date-time.zip), dann und notieren Sie sich den Pfad.Verbinden Sie den DUT mit dem Linux-Computer.
Berichte aus der Android SDK-Installation auf dem Linux-Computer herunterladen vom verbundenen Gerät mit
adb shell content readoderadb pull CTSVerifierReportPath.Bei Android 7.x und höher laden Sie alle Berichte mit dem folgenden Befehl herunter:
adb pull /sdcard/verifierReports
Bei Android 6.0 und niedriger können Sie alle Berichte mit dem folgenden Befehl herunterladen:
adb pull /mnt/sdcard/ctsVerifierReports/
Für Android 10 und höher wird die Implementierung Automobilbranche und Geräte, die als sekundärer Nutzer, Download mit dem folgenden Befehl abrufen:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
So listen Sie alle auf dem verbundenen Gerät verfügbaren Berichte auf:
adb shell content query --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports
Um einen Bericht aus der Liste herunterzuladen, können Sie die Zeilen-ID oder filename. Beispiel:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/0 > report.zip adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/ctsVerifierReport-date-time.zip > report.zip
Um die bestandene/nicht bestandene Prüfung zu löschen, wählen Sie die Ergebnisse in der CTS Verifier App aus und Wählen Sie Menü > Löschen: