Korzystanie z weryfikatora CTS

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.

Konfiguracja

Zmień tryb nawigacji systemowej urządzenia testowego na tryb z trzema przyciskami w następujący sposób:

  1. Otwórz ustawienia.
  2. Przejdź do System> Gest> System nawigacji.
  3. Wybierz dowolny tryb nawigacji oparty na przyciskach, preferowany tryb z trzema przyciskami, jeśli jest dostępny.

Aby skonfigurować środowisko testowe CTS Verifier:

  1. 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
      
    • Zainstalować Androida Studio .

    • Pobierz CTS weryfikatora APK dla wersji Androida do testu.

  2. Podłącz testowane urządzenie do komputera z systemem Linux.

  3. Z terminala na komputerze z systemem Linux należy zainstalować CtsVerifier.apk na DUT.

    adb install -r -g CtsVerifier.apk
    
  4. 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
    
  5. 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
    
  6. Upewnij się, że testowane urządzenie ma prawidłowo ustawione dane systemowe i czas.

Bieganie

Uruchom aplikację CTS Verifier, dotykając ikony CTS Verifier na testowanym urządzeniu.

Ikona weryfikatora CTS w programie uruchamiającym

Ikona figura 1. CTS kontrolny

Aplikacja wyświetla kilka zestawów testowych dostępnych do ręcznej weryfikacji.

Weryfikator CTS menu testów

Figura 2. CTS kontrolny menu testów

Każdy test zawiera zestaw wspólnych elementów (Info, Pass, Fail) na dole ekranu.

Weryfikator jakości strumieniowego wideo

Elementy figura 3. Test

  • Info (?). Dotknij, aby wyświetlić instrukcje testu. Pojawia się również automatycznie przy pierwszym otwarciu testu.
  • Przejście (✓). Stuknij, jeśli testowane urządzenie spełnia wymagania testowe zgodnie z instrukcjami informacyjnymi.
  • Fail (!). 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.

Testowanie trybu akcesoriów USB dla wersji 8.0 i nowszych

Test akcesoriów USB weryfikatora CTS

Figura 4. Test USB akcesoria prcedure do 8,0 i powyżej

Test akcesoriów USB weryfikatora CTS

Tryb akcesorium USB Rysunek 5. Badanie na 8,0 i powyżej

Testowanie trybu akcesoriów USB dla wersji 7.x i starszych

Test akcesorium USB wymaga komputera z systemem Linux do uruchomienia programu komputera stacjonarnego (hosta) USB.

  1. Podłącz testowane urządzenie do komputera z systemem Linux.
  2. Na komputerze, wykonaj cts-usb-accessory program z pakietu CTS kontrolny:

    ./cts-usb-accessory
  3. Poczekaj na wiadomość popup do pojawiają się na DUT, a następnie wybierz OK.
    Test akcesoriów USB weryfikatora CTS

    Rysunek 6. Test akcesoria USB

  4. Przejdź do testu akcesoriów USB w aplikacji CTS Verifier na DUT.

  5. 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
    

Kalibracja pola widzenia kamery

Użyj procedury kalibracji pola widzenia, aby szybko określić pole widzenia urządzenia z umiarkowaną dokładnością.

  1. Skonfiguruj środowisko testowe:

    1. Drukuj kalibracji pattern.pdf plik docelowy na x 17” lub papieru o rozmiarze 11” A3.
    2. Zamontuj wydrukowany wzór na sztywnym podłożu.
    3. Ustaw aparat i wydrukowany cel, jak pokazano poniżej.
      Cel wydrukowany z aparatu

      Rysunek 7. Aparat drukowane cel

  2. Ustaw docelową szerokość:

    1. Zmierz odległość (w centymetrach) między liniami ciągłymi na docelowym wzorze, aby uwzględnić niedokładności drukowania (~38 cm).
    2. Uruchom aplikację do kalibracji.
    3. Naciśnij przycisk Ustawienia i wybierz Marker dystans.
    4. Zmierz i wprowadź odległość do wzoru docelowego (~100 cm).
    5. Naciśnij przycisk Wstecz, aby powrócić do podglądu kalibracji.
  3. 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.

  4. Uruchom test kalibracyjny:

    1. 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.
    2. 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 +/-1 stopnia wartości kalibracji.
    3. Naciśnij przycisk Wstecz i powtórz test kalibracji dla wszystkich rozdzielczości obrazu obsługiwanych przez testowane urządzenie.

Uruchamianie 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.

Przełącznik CTS-V

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>

Eksportowanie wyników

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.

  1. Stuknij ikonę Save (dysku).
    Ikona Zapisz weryfikatora CTS

    Rysunek 8. CTS Weryfikator Zapisz ikona

  2. Poczekaj na komunikat popup, aby wyświetlić ścieżkę do zapisanego raportu (np /sdcard/verifierReports/ctsVerifierReport-date-time.zip ), a następnie nagrać ścieżkę.
    Ścieżka weryfikatora CTS do zapisanego raportu

    Rysunek 9. CTS Weryfikator ścieżka do zapisanego raportu

  3. Podłącz testowane urządzenie do komputera z systemem Linux.

  4. Z instalacji Android SDK na komputerze z systemem Linux, pobieranie raportów z podłączonego urządzenia wykorzystujące adb shell content read lub adb pull CTSVerifierReportPath .

    • W przypadku systemu Android 7.x i nowszego pobierz wszystkie raporty za pomocą:

      adb pull /sdcard/verifierReports
      
    • W przypadku Androida 6.0 i starszych pobierz wszystkie raporty, używając:

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • Android 10 i wyżej, wykonawczego motoryzacyjnej i urządzeń z systemem jako wtórnego użytkownika , pobierz najnowszy raport za pomocą:

      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
      
  5. Do jasnej pass / fail wyniki, wybierz wyniki w CTS Weryfikator aplikacji i wybierz Menu> Usuń.