Korzystanie z weryfikatora CTS

Weryfikator zestawu testów zgodności systemu Android (CTS Verifier) ​​stanowi uzupełnienie zestawu 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 lub pozycjonowania, takich jak jakość dźwięku, ekran dotykowy, akcelerometr i kamera.

Wymagania

Przed uruchomieniem CTS Verifier upewnij się, że posiadasz następujący sprzęt:

  • Urządzenie z systemem Android, które zweryfikowało zgodność z interfejsem API systemu Android, pomyślnie przechodząc test CTS. To jest testowane urządzenie (DUT).
  • Komputer z systemem Linux i portem zgodnym z USB 2.0. Wszystkie połączenia z testowanym urządzeniem przechodzą przez ten port.
  • Drugie urządzenie z systemem Android ze znaną kompatybilną implementacją Bluetooth, Wi-Fi direct, Wi-Fi Aware, UWB (jeśli urządzenie testowane obsługuje UWB) i emulacją karty hosta NFC (HCE).
  • Router Wi-Fi skonfigurowany z nazwą punktu dostępu i hasłem. Router powinien mieć możliwość rozłączenia się z Internetem, ale nie powinien być wyłączony.

Upewnij się, że przygotowałeś także statywy, uchwyty do urządzeń i wstępnie zmierzone odległości wymagane do testów pomiaru odległości (bliskości) dla UWB, Wi-Fi NAN i Bluetooth RSSI. Aby uzyskać szczegółowe informacje, zobacz Kalibracja obecności .

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:

  • Hash APK CtsVerifier: 61:ED:37:7E:85:D3:86:A8:DF:EE:6B:86:4B:D8:5B:0B:FA:A5:AF:81
  • Autoryzowany identyfikator aplikacji (AID) umożliwiający dostęp 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 trzech przycisków w następujący sposób:

  1. Otwórz ustawienia.
  2. Przejdź do opcji System > Gest > Nawigacja systemowa .
  3. Wybierz dowolny tryb nawigacji oparty na przyciskach, preferowany tryb trzech przycisków, jeśli jest dostępny.

Aby skonfigurować środowisko testowe CTS Verifier:

  1. Na komputerze z systemem Linux:

    • Uruchom następującą komendę przed zainstalowaniem CTS Verifier, aby umożliwić 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 wersji Androida, aby przetestować.

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

  3. Z terminala na komputerze z systemem Linux zainstaluj CtsVerifier.apk na urządzeniu DUT.

    adb install -r -g CtsVerifier.apk
    
  4. W systemie Android 10 i nowszym 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 systemie Android 11 i nowszym uruchom następujące polecenie, aby zezwolić na 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. W systemie Android 13 i nowszym uruchom następujące polecenie, aby zezwolić na dostęp do testowego API dla CTS Verifier.

    adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier
    
  7. W systemie Android 14 i nowszym uruchom następujące polecenie, aby zezwolić aplikacji na włączenie ekranu.

    adb shell appops set com.android.cts.verifier TURN_SCREEN_ON 0
    
  8. Upewnij się, że urządzenie DUT ma prawidłowo ustawioną datę i godzinę systemową.

Uruchom weryfikator CTS

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

Ikona CTS Verifier w programie uruchamiającym

Rysunek 1. Ikona weryfikatora CTS

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

Menu testów CTS Verifier

Rysunek 2. Menu testów CTS Verifier

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

Weryfikator jakości strumieniowego wideo

Rysunek 3. Ekran testowy z podświetlonymi typowymi elementami testowymi

  • Pass (✓). Stuknij, jeśli testowane urządzenie spełnia wymagania testowe zgodnie z instrukcjami informacyjnymi.
  • Informacje (?). Stuknij, aby wyświetlić instrukcje dotyczące testu. Pojawia się również automatycznie przy pierwszym otwarciu testu.
  • Ponieść porażkę (!). Stuknij, jeśli testowane urządzenie nie spełnia wymagań testowych zgodnie z instrukcjami informacyjnymi.

Niektóre testy, takie jak tryb akcesoriów USB i test kalibracji aparatu, wymagają dodatkowej konfiguracji testu i instrukcji opisanych szczegółowo w poniższych sekcjach.

Przetestuj tryb akcesoriów USB w wersji 8.0 i nowszej

Test akcesoriów USB CTS Verifier

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

Test akcesoriów USB CTS Verifier

Rysunek 5. Testowanie trybu akcesoriów USB w wersji 8.0 i nowszych

Przetestuj tryb akcesoriów USB w wersji 7.x i starszej

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

  1. Podłącz urządzenie DUT 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 DUT pojawi się wyskakujący komunikat, a następnie wybierz OK .
    Test akcesoriów USB CTS Verifier

    Rysunek 6. Test akcesoriów USB

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

  5. Na komputerze przejrzyj dane wyjściowe z konsoli. Przykładowe wyjście:

    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. Wydrukuj docelowy plik wzorca kalibracji.pdf na papierze o formacie 11” x 17” lub A3.
    2. Zamontuj wydrukowany wzór na sztywnym podłożu.
    3. Ustaw kamerę i wydrukowany cel w sposób pokazany na poniższym schemacie.
      Cel wydrukowany przez kamerę

      Rysunek 7. Cel wydrukowany przez kamerę

  2. Ustaw szerokość docelową:

    1. Zmierz odległość (w centymetrach) pomiędzy liniami ciągłymi na wzorze docelowym, aby uwzględnić niedokładności drukowania (~38 cm).
    2. Uruchom aplikację kalibracyjną.
    3. Naciśnij przycisk konfiguracji i wybierz Odległość znacznika .
    4. Zmierz i wpisz odległość do wzorca 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 dialogowym konfiguracji wprowadzono prawidłowe odległości. Podgląd wyświetla obraz z nałożoną pionową linią; linia ta powinna pokrywać się z linią środkową docelowego wzoru. Przezroczystą siatkę można zastosować z innymi pionowymi liniami, 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 przechodzi 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 zbiegają się z pionowymi liniami wzoru docelowego w odległości kilku centymetrów, raportowane pole widzenia dla wybranej rozdzielczości jest dokładne.
      • Jeśli linie nie są wyrównane, raportowane pole widzenia jest niedokładne. Aby to skorygować, przesuń suwak u dołu ekranu, aż nakładka zrówna się z docelowym wzorem tak blisko, jak to możliwe. Kiedy nakładka i obraz wzoru docelowego są wyrównane, wyświetlane pole widzenia jest zbliżone do prawidłowej wartości. Podane pole widzenia powinno mieścić się w zakresie +/-2 stopnia od wartości kalibracyjnej.
    3. Naciśnij przycisk Wstecz i powtórz test kalibracyjny dla wszystkich rozdzielczości obrazu obsługiwanych przez testowane urządzenie.

Uruchom CTS Verifier dla alternatywnych trybów

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.

Na górze głównego widoku listy w CTS Verifier widoczny jest przycisk umożliwiający użytkownikom przełączanie pomiędzy trybem wyświetlania rozłożonego i złożonego. CTS Verifier pokaże niezbędne testy dla wybranego trybu wyświetlania. Aby uruchomić alternatywne tryby w CTS Verifier należy przełączyć przycisk w odpowiedni tryb wyświetlania i uruchomić pokazaną listę testów.

Przełącznik CTS-V

Wyniki testów złożonych zostaną zapisane w tym samym raporcie co testy rozłożone. Aby zidentyfikować każdy wynik testu, z którego pochodzi zestaw testów, do nazwy każdego testu w trybie złożonym dodawany jest 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 w postaci raportu i pobrać je na komputer. Nazwy raportów są automatycznie oznaczane znacznikiem czasu na podstawie czasu systemowego testowanego urządzenia.

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

  2. Poczekaj na wyskakujący komunikat wyświetlający ścieżkę pliku do zapisanego raportu (na przykład /sdcard/verifierReports/ctsVerifierReport-date-time.zip ), a następnie zapisz ścieżkę.

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

  4. Z instalacji Android SDK na komputerze z systemem Linux pobierz raporty z podłączonego urządzenia za pomocą adb shell content read lub adb pull CTSVerifierReportPath .

    • W przypadku Androida 7.x i nowszych pobierz wszystkie raporty za pomocą następującego polecenia:

      adb pull /sdcard/verifierReports
      
    • W przypadku Androida 6.0 i starszych pobierz wszystkie raporty za pomocą następującego polecenia:

      adb pull /mnt/sdcard/ctsVerifierReports/
      
    • W przypadku Androida 10 i nowszego, wdrażającego Motoryzację 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ć listę wszystkich raportów dostępnych na 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 pozytywne/negatywne, wybierz wyniki w aplikacji CTS Verifier i wybierz Menu > Usuń .