Weryfikator zestawu testów zgodności systemu Android (CTS Verifier) uzupełnia zestaw testów zgodności (CTS). Podczas gdy CTS sprawdza interfejsy API i funkcje, które można zautomatyzować, CTS Verifier zapewnia testy interfejsów API i funkcji, których nie można przetestować na urządzeniu stacjonarnym bez ręcznego wprowadzania danych, takich jak jakość dźwięku, ekran dotykowy, akcelerometr i kamera.
Wymagania
Przed uruchomieniem CTS Verifier upewnij się, że masz następujący sprzęt:
- Urządzenie z systemem Android, które zweryfikowało zgodność interfejsu API systemu Android, pomyślnie przechodząc CTS. To jest testowane urządzenie (DUT).
- Komputer z systemem Linux z portem zgodnym z USB 2.0. Wszystkie połączenia z testowanym urządzeniem przechodzą przez ten port.
- Drugie urządzenie z Androidem ze znaną kompatybilną implementacją Bluetooth, Wi-Fi Direct i NFC host card emulation (HCE).
- Router Wi-Fi skonfigurowany z nazwą punktu dostępu i hasłem. Router powinien mieć możliwość odłączenia się od internetu, ale nie powinien być wyłączony.
Wymagania UICC dotyczące testów NFC
CTS Verifier ma następujące przypadki testowe NFC:
- Field-off (wykorzystuje dane transakcyjne z 0x54)
- Odznacz (używa danych transakcji z 0x52)
- Polecenie HCI (0025000000) (wykorzystuje dane transakcji z 0x02)
Testy zdarzeń transakcyjnych wymagają dwóch urządzeń, z których jedno musi mieć SecureElement UICC z następującymi regułami dostępu:
- CtsVerifier Hash APK: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
- Autoryzowany identyfikator aplikacji (AID) dla dostępu do zdarzeń NFC: 0xA000000476416E64726F696443545341
Po stronie emulatora oczekujemy, że zdarzenie transakcji wypchnie odpowiednią aktywność na pierwszy plan.
Organizować coś
Zmień tryb nawigacji systemowej urządzenia testowego na tryb z trzema przyciskami w następujący sposób:
- Otwórz ustawienia.
- Przejdź do System > Gest > Nawigacja w systemie .
- Wybierz dowolny tryb nawigacji oparty na przyciskach, preferowany tryb z trzema przyciskami, jeśli jest dostępny.
Aby skonfigurować środowisko testowe CTS Verifier:
Na komputerze z systemem Linux:
Uruchom następujące polecenie przed zainstalowaniem weryfikatora CTS, aby umożliwić dostęp do interfejsów innych niż SDK.
adb shell settings put global hidden_api_policy 1
Zainstaluj Android Studio .
Pobierz pakiet APK CTS Verifier dla wersji Androida do przetestowania.
Podłącz testowane urządzenie do komputera z systemem Linux.
Z terminala na komputerze z systemem Linux zainstaluj
CtsVerifier.apk
na DUT.adb install -r -g CtsVerifier.apk
W systemie Android 10 i nowszych uruchom następujące polecenie, aby zezwolić aplikacji na utworzenie raportu.
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
W przypadku systemu Android 11 i nowszych uruchom następujące polecenie, aby umożliwić zapisywanie raportów w samodzielnie zdefiniowanym katalogu w zewnętrznym katalogu najwyższego poziomu urządzenia.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
Upewnij się, że testowane urządzenie ma prawidłowo ustawione dane systemowe i czas.
Uruchom weryfikatora CTS
Uruchom aplikację CTS Verifier, dotykając ikony CTS Verifier na testowanym urządzeniu.
Rysunek 1. Ikona weryfikatora CTS
Aplikacja wyświetla kilka zestawów testowych dostępnych do ręcznej weryfikacji.
Rysunek 2. Menu testów CTS Verifier
Każdy test zawiera zestaw wspólnych elementów na dole ekranu.
Rysunek 3. Ekran testu z podświetlonymi typowymi elementami testu
- Zdaj (✓). Stuknij, jeśli testowane urządzenie spełnia wymagania testowe zgodnie z instrukcjami informacyjnymi.
- Informacje (?). Dotknij, aby wyświetlić instrukcje testu. Pojawia się również automatycznie przy pierwszym otwarciu testu.
- Niepowodzenie (!). Stuknij, jeśli testowane urządzenie nie spełnia wymagań testowych zgodnie z instrukcjami informacyjnymi.
Niektóre testy, takie jak tryb akcesorium USB i test kalibracji kamery, wymagają dodatkowej konfiguracji testu i instrukcji, jak opisano w poniższych sekcjach.
Przetestuj tryb akcesoriów USB dla wersji 8.0 i nowszych
Rysunek 4. Procedura testowania akcesoriów USB dla wersji 8.0 i nowszych
Rysunek 5. Testowanie trybu akcesoriów USB dla wersji 8.0 i nowszych
Przetestuj tryb akcesorium USB dla wersji 7.x i niższych
Test akcesorium USB wymaga komputera z systemem Linux do uruchomienia programu komputera stacjonarnego (hosta) USB.
- Podłącz testowane urządzenie do komputera z systemem Linux.
Na komputerze uruchom program
cts-usb-accessory
z pakietu CTS Verifier:./cts-usb-accessory
Poczekaj, aż na urządzeniu testowanym pojawi się wyskakujący komunikat, a następnie wybierz OK .
Rysunek 6. Test akcesoriów USB
Przejdź do testu akcesoriów USB w aplikacji CTS Verifier na DUT.
Na komputerze przejrzyj dane wyjściowe z konsoli. Przykładowe dane wyjściowe:
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
Skalibruj pole widzenia kamery
Użyj procedury kalibracji pola widzenia, aby szybko określić pole widzenia urządzenia z umiarkowaną dokładnością.
Skonfiguruj środowisko testowe:
- Wydrukuj plik wzorcowy Calibration-pattern.pdf na papierze o rozmiarze 11” x 17” lub A3.
- Zamontuj wydrukowany wzór na sztywnym podłożu.
Ustaw kamerę i wydrukowany cel, jak pokazano na poniższym schemacie.
Rysunek 7. Drukowany cel z kamery
Ustaw docelową szerokość:
- Zmierz odległość (w centymetrach) między liniami ciągłymi na docelowym wzorze, aby uwzględnić niedokładności drukowania (~38 cm).
- Uruchom aplikację do kalibracji.
- Naciśnij przycisk konfiguracji i wybierz Odległość znacznika .
- Zmierz i wprowadź odległość do wzoru docelowego (~100 cm).
- Naciśnij przycisk Wstecz, aby powrócić do podglądu kalibracji.
Sprawdź, czy urządzenie i cel są umieszczone tak, jak pokazano na rysunku, a w oknie konfiguracji wprowadzono prawidłowe odległości. Podgląd wyświetla obraz z nałożoną na niego pionową linią; linia ta powinna być wyrównana z linią środkową wzoru docelowego. Przezroczystą siatkę można stosować z innymi liniami pionowymi, aby zapewnić, że oś optyczna jest prostopadła do celu.
Uruchom test kalibracyjny:
- Wybierz rozdzielczość obrazu (za pomocą selektora w lewym dolnym rogu), a następnie dotknij ekranu, aby zrobić zdjęcie. Test wchodzi w tryb kalibracji i wyświetla zdjęcie z dwiema pionowymi liniami nałożonymi na obraz.
- Określ dokładność:
- Jeśli linie są wyrównane z liniami pionowymi na wzorze docelowym w odległości kilku centymetrów, raportowane pole widzenia dla wybranej rozdzielczości jest dokładne.
- Jeśli linie nie są wyrównane, zgłaszane pole widzenia jest niedokładne. Aby to naprawić, przesuń suwak na dole ekranu, aż nakładka zrówna się z docelowym wzorem tak blisko, jak to możliwe. Gdy nakładka i obraz wzorca docelowego są wyrównane, wyświetlane pole widzenia jest zbliżone do prawidłowej wartości. Raportowane pole widzenia powinno mieścić się w zakresie +/-2 stopni od wartości kalibracji.
- Naciśnij przycisk Wstecz i powtórz test kalibracji dla wszystkich rozdzielczości obrazu obsługiwanych przez testowane urządzenie.
Uruchom weryfikatora CTS dla trybów alternatywnych
Począwszy od wersji CTS 10 R6 i CTS 11 R2, CTS Verifier obsługuje testy wymagane dla urządzeń z alternatywnymi trybami lub dla urządzeń z więcej niż jednym trybem ekranu.
W górnej części głównego widoku listy w CTS Verifier wyświetlany jest przycisk umożliwiający użytkownikom przełączanie między trybem wyświetlania rozwiniętym i złożonym. CTS Verifier pokaże niezbędne testy dla wybranego trybu wyświetlania. Aby wykonać alternatywne tryby w CTS Verifier należy przełączyć przycisk w odpowiedni tryb wyświetlania i uruchomić wyświetloną listę testów.
Wyniki testów złożonych zostaną zapisane w tym samym raporcie z testami rozwiniętymi. Aby zidentyfikować każdy wynik testu, z którego pochodzi zestaw testowy, do każdej nazwy testu dodawany jest przyrostek w trybie złożonym.
<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>
Eksportuj wyniki
Po zakończeniu wszystkich testów możesz zapisać wyniki jako raport i pobrać je na komputer. Nazwy raportów są automatycznie oznaczane czasem na podstawie czasu systemowego DUT.
Aby zapisać wyniki testu, dotknij ikony zapisu (dysku) u góry listy kategorii testów.
Poczekaj na wyskakujący komunikat, który wyświetla ścieżkę pliku do zapisanego raportu (na przykład
/sdcard/verifierReports/ctsVerifierReport-date-time.zip
), a następnie zapisz ścieżkę.Podłącz testowane urządzenie do komputera z systemem Linux.
Z instalacji zestawu Android SDK na komputerze z systemem Linux pobierz raporty z podłączonego urządzenia przy użyciu
adb shell content read
adb lubadb pull CTSVerifierReportPath
.W przypadku systemu Android 7.x i nowszych pobierz wszystkie raporty za pomocą następującego polecenia:
adb pull /sdcard/verifierReports
W przypadku systemu Android 6.0 i starszych pobierz wszystkie raporty za pomocą następującego polecenia:
adb pull /mnt/sdcard/ctsVerifierReports/
W przypadku systemu Android 10 lub nowszego, w którym zaimplementowano Automotive i urządzenia działające jako użytkownik dodatkowy , pobierz najnowszy raport za pomocą następującego polecenia:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
Aby wyświetlić wszystkie raporty dostępne w podłączonym urządzeniu:
adb shell content query --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports
Aby pobrać raport z listy, możesz określić identyfikator wiersza lub nazwę pliku. Na przykład:
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
Aby wyczyścić wyniki zaliczenia/niezaliczenia, wybierz wyniki w aplikacji CTS Verifier i wybierz Menu > Wyczyść .