Narzędzie do weryfikacji zgodności z systemem Android Compatibility Test Suite (CTS Verifier) uzupełnia Compatibility Test Suite (CTS). CTS sprawdza interfejsy API i funkcje, które można lub zautomatyzowany, CTS Verifier umożliwia przeprowadzanie testów interfejsów API i funkcji, których nie można przetestowane na nieruchomych urządzeniach bez ręcznego wprowadzania i pozycjonowania, np. dźwięku; jakość, ekran dotykowy, akcelerometr i aparat.
Wymagania
Przed uruchomieniem weryfikatora CTS upewnij się, że masz następujący sprzęt:
- urządzenie z Androidem, na którym zweryfikowano zgodność z interfejsem Android API który nie zalicza się do grupy docelowej. To jest urządzenie w trakcie testowania (DUT).
- Komputer z systemem Linux i portem zgodnym z USB 2.0. Wszystkie połączenia z DUT przez ten port.
- Drugie urządzenie z Androidem ze znanym zgodnym Bluetoothem, Wi-Fi Direct i Wi-Fi Aware, UWB (jeśli DUT obsługuje UWB) oraz emulację karty hosta NFC (HCE) implementacji.
- router Wi-Fi skonfigurowany z nazwą punktu dostępu i hasłem, router, powinien mieć możliwość odłączenia się od internetu, ale nie jest zasilany wyłączone.
Przygotuj również statywy, uchwyty do urządzeń i odległości wymagane do pomiaru odległości (zbliżeniowej) w ramach UWB; Wi-Fi NAN i Bluetooth RSSI. Więcej informacji: Kalibracja obecności.
Wymagania UICC w przypadku testów NFC
Weryfikator CTS obsługuje te testy NFC:
- Field-off (używa danych transakcji z rozmiaru 0 x 54)
- Odznacz (używa danych transakcji z 0x52)
- Polecenie HCI (0025000000) (używa danych transakcji z 0x02)
Testy zdarzeń transakcji wymagają użycia 2 urządzeń, z których jedno musi mieć SecureElement UICC z tymi regułami dostępu:
- Skrót CtsVerifier 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) dostępu do zdarzeń NFC: 0xA000000476416E64726F696443545341
Po stronie emulatora oczekujemy, że zdarzenie transakcji przekaże odpowiednie wartości aktywność na pierwszym planie.
Konfiguracja
Zmień tryb nawigacji w systemie na urządzeniu testowym na tryb z 3 przyciskami jako następujące:
- Wybierz Ustawienia.
- Kliknij System > Gest > Nawigacja w systemie.
- Wybierz dowolny tryb nawigacji oparty na przyciskach. Preferowany tryb z 3 przyciskami i dostępności informacji.
Aby skonfigurować środowisko testowe CTS Verifier:
Na komputerze z Linuksem:
Przed zainstalowaniem weryfikatora CTS w celu zezwolenia na odczyt uruchom następujące polecenie dostęp do interfejsów innych niż SDK.
adb shell settings put global hidden_api_policy 1
Zainstaluj Android Studio.
Pobierz plik APK CTS Verifier dla wersję Androida do przetestowania.
Podłącz DUT do komputera z systemem Linux.
W terminalu na komputerze z systemem Linux zainstaluj aplikację
CtsVerifier.apkna urządzeniu DUT.adb install -r -g CtsVerifier.apk
W przypadku Androida 10 lub nowszego uruchom te polecenia aby przyznać aplikacji uprawnienia do utworzenia raportu.
adb shell appops set com.android.cts.verifier android:read_device_identifiers allow
W przypadku Androida 11 lub nowszego uruchom te polecenia pozwalającego na zapisywanie raportów w samodzielnie zdefiniowanym katalogu w katalogu w zewnętrznym katalogu najwyższego poziomu.
adb shell appops set com.android.cts.verifier MANAGE_EXTERNAL_STORAGE 0
W przypadku Androida 13 lub nowszego uruchom te polecenia aby zezwolić na testowy dostęp weryfikatora CTS za pomocą interfejsu API.
adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
W przypadku Androida 14 lub nowszego uruchom te polecenia aby przyznać aplikacji uprawnienia do włączania ekranu.
adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
Upewnij się, że na urządzeniu mobilnym ma ustawioną prawidłową datę i godzinę systemową.
Uruchamianie weryfikatora CTS
Uruchom aplikację CTS Verifier, klikając ikonę CTS Verifier (DUT).
Rysunek 1. Ikona weryfikatora CTS
Aplikacja wyświetla kilka zestawów testów dostępnych do ręcznej weryfikacji.
Rysunek 2. Menu testów w weryfikatorze CTS
Każdy test zawiera u dołu ekranu zestaw typowych elementów.
Rysunek 3. Ekran testowy z wyróżnionymi typowymi elementami testowymi
- Pass (✓). Kliknij, jeśli DUT spełnia wymagania testu zgodnie z informacjami za instrukcje.
- Informacje (?). Kliknij, aby wyświetlić instrukcje testu. Wyświetla się też automatycznie przy pierwszym otwarciu testu.
- Niepowodzenie (!). Kliknij, jeśli DUT nie spełnia wymagań dotyczących testów zgodnie z informacjami za instrukcje.
Niektóre testy, takie jak tryb akcesorium USB i test kalibracji aparatu, wymagają dodatkowej konfiguracji testu i instrukcji opisanych w kolejnych sekcjach.
Testowanie trybu akcesorium USB w wersji 8.0 i nowszych
Rysunek 4. Procedura testowania akcesoriów USB w wersjach 8.0 i powyżej
Rysunek 5. Testowanie trybu akcesoriów USB w modelach 8.0 i powyżej
Przetestuj tryb akcesorium USB w modelu 7.x i starszych
Test akcesoriów USB wymaga do działania komputera z systemem Linux (gospodarza).
- Podłącz DUT do komputera z systemem Linux.
Na komputerze uruchom program
cts-usb-accessoryz pakietu CTS Pakiet weryfikatora:./cts-usb-accessory
Poczekaj, aż na urządzeniu DUT pojawi się wyskakujące okienko, a następnie kliknij OK.
Rysunek 6. Test akcesorium USB
Przejdź do testu akcesoriów USB w aplikacji CTS Verifier w DUT.
Na komputerze sprawdź dane wyjściowe 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
Skorzystaj z procedury kalibracji pola widzenia, aby szybko określić urządzenie. pole widzenia z umiarkowaną dokładnością.
Skonfiguruj środowisko testowe:
- Wydrukuj Element docelowy calibration-pattern.pdf na papierze o wymiarach 11 x 17 cali lub A3.
- Zamontuj nadrukowany wzór na sztywnym podłożu.
Ustaw aparat i wydrukowany cel w następujący sposób .
Rysunek 7. Cel wydrukowany przez kamerę
Ustaw szerokość docelową:
- Zmierz odległość (w centymetrach) między liniami ciągłymi na docelowy wzorzec, by uwzględnić niedokładności w druku (ok. 38 cm).
- Uruchom aplikację kalibracji.
- Kliknij przycisk konfiguracji i wybierz Odległość znacznika.
- Zmierz odległość do wzorca docelowego (ok. 100 cm).
- Naciśnij przycisk Wstecz, aby wrócić do podglądu kalibracji.
Sprawdź, czy urządzenie i cel są umieszczone tak, jak widać na ilustracji oraz i podano prawidłowe wartości w oknie konfiguracji. Podgląd wyświetla obraz z nałożoną pionową linią. ten wiersz powinien wyrównać do środkowej linii wzorca docelowego. Przezroczysta siatka może w połączeniu z innymi pionowymi liniami, aby zapewnić ortogonalny do celu.
Uruchom test kalibracji:
- Wybierz rozdzielczość obrazu (za pomocą selektora w lewym dolnym rogu), a potem kliknij ekranu, by zrobić zdjęcie. Test przejdzie w tryb kalibracji i wyświetla zdjęcie z 2 pionowymi liniami nałożonymi na obraz.
- Określanie dokładności:
- Jeśli linie są zgodne z pionowymi liniami na wzorcu docelowym do kilku centymetrów, pole widzenia dla wybrana rozdzielczość jest prawidłowa.
- Jeśli linie się nie wyrównają, pole widzenia w raporcie jest nieprawidłowe. Aby to poprawić, przesuń suwak u dołu ekranu, aż aby nakładka ściśle przylegała do wzorca docelowego. Po wyrównaniu nakładki i obrazu wzorca docelowego wyświetlane pole widzenia to bardzo zbliżona wartość . Pole widzenia w raporcie powinno mieścić się w zakresie +/-2 stopnia od wartość kalibracji.
- Naciśnij przycisk Wstecz i powtórz test kalibracji dla wszystkich obrazów w rozwiązaniach obsługiwanych przez ustawę DUT.
Uruchamianie weryfikatora CTS dla trybów alternatywnych
Od wersji CTS 10 R6 i CTS 11 R2 weryfikator CTS obsługuje wymagane testy w przypadku urządzeń z alternatywnymi trybami lub urządzeń z więcej niż 1 trybem ekranu.
U góry głównego widoku listy w weryfikatorze CTS widoczny jest przycisk umożliwiający włączenie przełączać się między trybem złożonym a rozłożonym. Weryfikator CTS wyświetli oraz przeprowadź testy niezbędne dla wybranego trybu wyświetlania. Aby wykonać polecenie alternatywne w narzędziu CTS Verifier, należy przełączyć przycisk na odpowiedni wyświetlacz. i uruchomić listę wyświetlanych testów.
Wyniki testów złożonych będą rejestrowane w tym samym raporcie testów. Aby zidentyfikować każdy wynik testu, z którego pochodzi zbiór testowy, do każdej nazwy testowej w trybie złożonym jest dodawany przyrostek.
<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 je pobrać do komputera. Nazwy raportów są automatycznie oznaczane sygnaturą czasową na podstawie numeru DUT czasu systemowego.
Aby zapisać wyniki testu, kliknij ikonę zapisywania (dysku) u góry listy kategorii testowych.
Poczekaj, aż pojawi się wyskakujące okienko z podaną ścieżką pliku do zapisanego raportu (na przykład:
/sdcard/verifierReports/ctsVerifierReport-date-time.zip), a następnie i zapisać ścieżkę.Podłącz DUT do komputera z systemem Linux.
Pobierz raporty po zainstalowaniu pakietu Android SDK na komputerze z systemem Linux z połączonego urządzenia za pomocą
adb shell content readlubadb pull CTSVerifierReportPath.W przypadku Androida 7.x lub nowszego pobierz wszystkie raporty, używając tego polecenia:
adb pull /sdcard/verifierReports
W przypadku Androida 6.0 i starszych wersji pobierz wszystkie raporty, używając tego polecenia:
adb pull /mnt/sdcard/ctsVerifierReports/
W przypadku Androida 10 i nowszych implementacja Motoryzacja i urządzenia należące do secondary user, pobierz najnowszy raport, używając tego polecenia:
adb shell content read --user CURRENT_USER --uri content://com.android.cts.verifier.testresultsprovider/reports/latest > report.zip
Aby wyświetlić listę wszystkich raportów dostępnych na połą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 podać identyfikator wiersza lub nazwa 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, wybierz je w aplikacji CTS Verifier i wybierz Menu > Wyczyść.