Korzystanie z weryfikatora CTS

Zadbaj o dobrą organizację dzięki kolekcji Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.

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:

  1. Otwórz ustawienia.
  2. Przejdź do System > Gest > Nawigacja w systemie .
  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
      
    • Zainstaluj Android Studio .

    • Pobierz pakiet APK CTS Verifier dla wersji Androida do przetestowania.

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

  3. Z terminala na komputerze z systemem Linux zainstaluj 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.

Uruchom weryfikatora CTS

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

Ikona weryfikatora CTS w programie uruchamiającym

Rysunek 1. Ikona weryfikatora CTS

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

Weryfikator CTS menu testów

Rysunek 2. Menu testów CTS Verifier

Każdy test zawiera zestaw wspólnych elementów na dole ekranu.

Weryfikator jakości strumieniowego wideo

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

Test akcesoriów USB weryfikatora CTS

Rysunek 4. Procedura testowania akcesoriów USB dla wersji 8.0 i nowszych

Test akcesoriów USB weryfikatora CTS

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.

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

    ./cts-usb-accessory
  3. Poczekaj, aż na urządzeniu testowanym pojawi się wyskakujący komunikat, a następnie wybierz OK .
    Test akcesoriów USB weryfikatora CTS

    Rysunek 6. Test akcesoriów 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
    

Skalibruj pole 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. Wydrukuj plik wzorcowy Calibration-pattern.pdf na papierze o rozmiarze 11” x 17” lub A3.
    2. Zamontuj wydrukowany wzór na sztywnym podłożu.
    3. Ustaw kamerę i wydrukowany cel, jak pokazano na poniższym schemacie.
      Cel wydrukowany z aparatu

      Rysunek 7. Drukowany cel z kamery

  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 konfiguracji i wybierz Odległość znacznika .
    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 +/-2 stopni od wartości kalibracji.
    3. 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.

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>

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.

  1. Aby zapisać wyniki testu, dotknij ikony zapisu (dysku) u góry listy kategorii testów.

  2. 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ę.

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

  4. 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 lub adb 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
      
  5. Aby wyczyścić wyniki zaliczenia/niezaliczenia, wybierz wyniki w aplikacji CTS Verifier i wybierz Menu > Wyczyść .