Testowanie składanych aparatów ITS

Od Androida 13 ITS dla aparatu obejmuje obsługę testów urządzeń składanych. Aparaty w składanych urządzeniach są dostępne lub niedostępne w zależności od tego, czy urządzenie jest złożone czy rozłożone.

Identyfikatory kamer zmieniają się w zależności od typu, modelu i marki urządzenia, a dostępność fizycznych przednich kamer zależy od stanu. Z tego powodu ITS aparatu dynamicznie określa kombinacje scen i kamer do testowania. Ponieważ kamery muszą być testowane w sposób złożony i rozłożony, testowanie składanych urządzeń wymaga ponownego zamontowania urządzenia w trakcie procesu testowania.

testowanie kamery przedniej i tylnej,

Czujniki aparatu dostępne na urządzeniu składanym różnią się w zależności od tego, czy urządzenie jest złożone czy rozłożone. W przypadku składanych telefonów dostępność przedniego aparatu zmienia się w zależności od stanu. Na przykład przedni aparat nie jest dostępny w stanie złożonym. Z powodu tej zmiany w dostępności przednich aparatów przednie aparaty muszą być testowane zarówno w sposobie złożonym, jak i rozłożonym. ITS aparatu zakłada, że dostępność tylnego aparatu pozostaje taka sama, niezależnie od tego, czy urządzenie jest złożone, czy rozłożone, więc tylne aparaty należy przetestować tylko raz.

W zależności od stanu urządzenia ITS kamery odfiltrowuje niedostępne urządzenia z kamerą, a urządzenia z kamerą nie będą widoczne na liście kombinacji kamer i ujęć.

W tabeli poniżej opisano zachowanie testu ITS aparatu w przypadku poszczególnych orientacji aparatu.

Orientacja aparatu Zachowanie testu ITS kamery
Tylny aparat Testuje aparat raz w stanie złożonym lub rozłożonym
Główny przedni aparat Testuje aparat raz w stanie złożonym, a raz w stanie rozłożonym.
Fizyczny przedni aparat Testuje kamerę tylko w stanach, w których jest ona dostępna.

Procedura testowa

W tej sekcji opisano, jak przetestować aparaty w urządzeniach składanych.

Skonfiguruj urządzenie

Informacje o konfigurowaniu znajdziesz w sekcji Konfiguracja.

Przyznawanie dostępu do testowego interfejsu API

Aby usługa ITS aparatu mogła określić, czy urządzenie jest składane, czy nie, przed wywołaniem testów musisz przyznać dostęp do testowego interfejsu API. Jeśli dostęp nie zostanie przyznany, uruchomienie testów ITS aparatu spowoduje zablokowanie aplikacji.

Aby przyznać dostęp, uruchom to polecenie ADB. To polecenie należy wykonać raz na urządzenie. Jeśli narzędzie CTS Verifier zostanie ponownie zainstalowane z inną wersją, musisz ponownie uruchomić to polecenie.

adb shell am compat enable ALLOW_TEST_API_ACCESS com.android.cts.verifier

Plik konfiguracji

Aby określić, że urządzenie jest urządzeniem składanym, dodaj parametr foldable_device w obu testbedach tablet i sensor_fusion w pliku config.yml. ITS aparatu używa tego parametru do określania camera_id i kombinacji scen w sposobie złożonym i rozłożonym.

Poniżej znajdziesz przykład pliku config.yml dla składanego urządzenia.

TestBeds:
  - Name: TABLET_SCENES
    # Test configuration for scenes[0:4, 6]
    Controllers:
        AndroidDevice:
          - serial: 8A9X0NS5Z
            label: dut
          - serial: 5B16001229
            label: tablet

    TestParams:
      brightness: 192
      chart_distance: 22.0
      debug_mode: "False"     # "quotes" needed
      chart_loc_arg: ""
      camera: 0
      scene: scene2_a
  lighting_cntl: arduino    # can be "arduino" or "None"
  lighting_ch: 1
  foldable_device: "True"     # "False" for non-foldable DUTs

Przeprowadzanie testów

Aby uruchomić testy ITS na urządzeniu składanym, uruchom polecenie run_all_tests.py. Więcej informacji znajdziesz w artykule Wywoływanie testów.

Podczas uruchamiania ITS aparatu na urządzeniu składanym testowany jest główny przedni aparat w obu stanach – złożonym i rozłożonym. Jeśli urządzenie jest złożone, wyniki są wyświetlane w opcji camera1_SCENE_NAME_folded w aplikacji CTS Verifier. W zależności od stanu urządzenia niektóre identyfikatory przednich fizycznych aparatów są niedostępne i nie są testowane. Tylny aparat musi być testowany tylko w jednym stanie, najlepiej w stanie złożonym. Wyniki dla tylnego aparatu nie mają przyrostu _folded.

Aby mieć pewność, że sceny składania są wykonywane na urządzeniu złożonym, i sprawdzić stan składanego DUT, uruchom to polecenie.

adb shell cmd device_state state

Podczas wykonywania testów w składanym stanie, ITS aparatu wyświetla wiadomość na terminalu, aby poprosić użytkownika o prawidłowe skonfigurowanie urządzenia na pudełku ITS. Aby kontynuować wykonywanie testu po wyświetleniu prompta, naciśnij Enter.

Jeśli uruchamiasz wszystkie sceny w złożonym i rozłożonym stanie, najpierw wykonywane są sceny złożone, a potem rozłożone. Pozwala to zminimalizować liczbę ponownych zamontowań wymaganych podczas testowania.

ITS aparatu dodaje też sufiks folded do katalogu tmp utworzonego dla scen w złożonym stanie.

Przykładowe polecenia

Poniżej znajdziesz przykładowe polecenia do wykonywania testów na składanych urządzeniach.

Polecenie Opis
python tools/run_all_tests.py Uruchamia wszystkie sceny.
python tools/run_all_tests.py scenes=scene0 Uruchamia scene0. Jeśli urządzenie jest złożone, a użytkownik testuje główny przedni aparat, skrypt określa stan urządzenia i dodaje sufiks _folded do nazwy sceny. Użytkownicy nie muszą dodawać sufiksu, aby uruchomić sceny złożone.
python tests/scene0/ -c config.yml Uruchamia konkretny test.