Konsola poleceń CTS w wersji 2

Korzystanie z konsoli CTS v2

W przypadku Androida 7.0 lub nowszego użyj CTS v2.

Wybierz abonamenty

Dostępne plany testów:

  • cts – uruchamia CTS z wcześniejszej instalacji CTS.
  • cts-camera – uruchamia kamerę CTS z istniejącej instalacji CTS.
  • cts-java – uruchamia podstawowe testy Java z istniejącej instalacji CTS.
  • cts-pdk – uruchamia testy przydatne podczas weryfikowania kompilacji PDK fusion.
  • wszystko – wspólna konfiguracja pakietów zgodności.

Inne dostępne konfiguracje:

  • basic-reporters – konfiguracja z podstawowymi raportami CTS.
  • collect-tests-only – uruchamia CTS z wcześniejszej instalacji CTS.
  • common-compliance-config – wspólna konfiguracja pakietów zgodności.
  • cts-filtered-sample – wspólna konfiguracja pakietów zgodności.
  • cts-known-failures – konfiguracja ze znanymi błędami w pakiecie CTS.
  • cts-preconditions – konfiguracje warunku wstępnego CTS.
  • host – uruchamia pojedynczy test na hoście na istniejącym urządzeniu.
  • instrument – uruchamia pojedynczy test instrumentacji Androida na istniejącym urządzeniu.
  • native-benchtest – uruchamia natywny test w warunkach stresu na istniejącym urządzeniu.
  • native-stress – przeprowadza natywny test stresu na istniejącym urządzeniu.
  • recharge (doładowanie) – fałszywy test, który czeka na prawie rozładowane urządzenia i wstrzymuje ich ładowanie.
  • testdef – uruchamia testy zawarte w plikach test_def.xml na istniejącym urządzeniu.
  • util/wifi – konfiguracja narzędzia do konfigurowania sieci Wi-Fi na urządzeniu.
  • util/wipe – usuwa dane użytkownika z urządzenia.

Wszystkie te plany i konfiguracje można wykonać za pomocą polecenia run cts.

Dokumentacja poleceń konsoli CTS w wersji 2

Ta tabela zawiera podsumowanie poleceń konsoli CTS w wersji 2 dla do różnych celów.

Host Opis
help Wyświetl podsumowanie najczęściej używanych poleceń
help all Wyświetl pełną listę dostępnych poleceń
version Pokaż wersję.
exit Gratisowo zamknij konsolę CTS. Konsola zamyka się, gdy wszystkie aktualnie uruchomione testy zostały zakończone.
extdir

Skompresowany plik z pobranymi plikami jest rozpakowany do formatu extdir. Jeśli chcesz pozbądź się zawyżonych danych wyjściowych, użyj opcji -q:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip -d extdir

Jeśli chcesz rozpakować archiwum do bieżącego katalogu, nie używaj opcji -d, po prostu uruchom:

unzip -q android-cts-9.0_r15-linux_x86-arm.zip

Uruchom Opis
run cts

Na Androidzie 10 uruchom domyślny abonament CTS i natychmiastowe reklamy CTS razem (czyli pełne wywołanie CTS). W przypadku Androida w wersji 9 lub starszej uruchom domyślną Tylko abonament CTS. Użyj tej kompleksowej opcji (łącznie z warunkami wstępnymi) do weryfikacji urządzenia. Informacje o uwzględnieniach znajdziesz w pliku cts.xml.

W trakcie testów konsola CTS może akceptować inne polecenia.

Jeśli nie są połączone żadne urządzenia, komputer stacjonarny (lub host) będzie czekać aby połączyć urządzenie przed rozpoczęciem testów. Jeśli więcej niż jeden urządzenie jest połączone, host CTS wybierze urządzenie automatycznie.

run cts-instant

W przypadku Androida 9 uruchom domyślny abonament błyskawiczny CTS.

run cts --module-parameter INSTANT_APP

Na Androidzie 10 uruchom domyślny plan CTS – błyskawiczny plan.

run cts --module-parameter INSTANT_APP --module/-m test_module_name

W Androidzie 10 uruchom określony moduł CTS – Instant Test. lub moduły.

run retry

Tylko na urządzeniach z Androidem 9 lub nowszym. Ponów wszystkie testy, które się nie powiodły lub nie zostały wykonane w porównaniu z poprzednimi sesjami. Na przykład run retry --retry -s lub run retry --retry --shard-count z fragmentacją TF.

run cts --retry nie jest dozwolona w Androidzie 9 lub nowszym.

run cts-sim

Na Androida w wersji 11 lub nowszej. Uruchamia podzbiór testów na urządzenia z kartą SIM.

--device-token

Android 8.1 lub starszy. Określa, że dane urządzenie ma podany token. Na przykład: --device-token 1a2b3c4d:sim-card.

--enable-token-sharding

Tylko na urządzeniu z Androidem 10 lub nowszym. Automatycznie pasuje do testu, który wymaga odpowiedniego typu karty SIM. Nie trzeba podawać numeru seryjnego urządzenia do uruchomienia przypadki testowe związane z kartą SIM. Obsługiwane karty SIM: SIM_CARD, UICC_SIM_CARD, i SECURE_ELEMENT_SIM_CARD.

run cts-dev

Uruchom domyślny plan CTS (czyli pełne wywołanie CTS), ale pomijania warunków wstępnych, aby zaoszczędzić czas działania na potrzeby iteracyjnego tworzenia nowego test. Pomija to weryfikację i konfigurację konfiguracja, na przykład przesyłanie plików multimedialnych lub sprawdzanie połączenia z Wi-Fi. tak samo jak przy korzystaniu z opcji --skip-preconditions. Ten także pomija zbieranie informacji o urządzeniu i wszystkie narzędzia do sprawdzania stanu systemu. Dodatkowo uruchamia testy tylko w jednym interfejsie ABI. Aby przeprowadzić weryfikację urządzenia, unikaj tej optymalizacji i uwzględnić wszystkie warunki wstępne i sprawdzenia. Zobacz cts-dev.xml.

W trakcie testów konsola CTS może akceptować inne polecenia.

Jeśli nie są połączone żadne urządzenia, komputer stacjonarny (lub host) będzie czekać aby połączyć urządzenie przed rozpoczęciem testów. Jeśli więcej niż jeden urządzenie jest połączone, host CTS wybierze urządzenie automatycznie.

--subplan subplan_name Uruchom określony abonament podrzędny.
--module/-m test_module_name --test/-t test_name  Uruchom określony moduł i przetestuj go. Przykład: run cts -m Gesture --test android.gesture.cts.GestureTest#testGetStrokes uruchamia określony pakiet, klasę lub test.
--retry Ponów wszystkie testy, które w poprzednich sesjach się nie powiodły lub nie zostały wykonane. Użyj kodu list results, aby uzyskać identyfikator sesji.
--retry-type NOT_EXECUTED Ponawiaj tylko te testy, które nie zostały wykonane w poprzednich sesjach. Użyj kodu list results, aby uzyskać identyfikator sesji.
--shards number_of_shards Android 8.1 lub starszy Fragment CTS na określoną liczbę niezależnych fragmentów, które można uruchomić na wielu urządzeniach. równolegle.
--shard-count number_of_shards Android 9 Podziel uruchomienie CTS na podaną liczbę niezależne fragmenty, które będą działać równolegle na wielu urządzeniach.
--serial/-s deviceID Uruchom CTS na konkretnym urządzeniu.
--include-filter "test_module_name test_name" uruchamiać go z użyciem określonych modułów lub z pakietami testowymi, klasami i przypadkami; Przykład: run cts --include-filter "CtsCalendarcommon2TestCases android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" zawiera określony moduł.

Ta opcja polecenia nie jest obsługiwana podczas ponawiania próby.

--exclude-filter "test_module_name test_name" Wyklucz z uruchomienia określone moduły lub pakiety testowe, klasy i przypadki. Przykład: run cts --exclude-filter "CtsCalendarcommon2Test android.calendarcommon2.cts.Calendarcommon2Test#testStaticLinking" wyklucza określony moduł.
--log-level-display/-l log_level Uruchom z minimalnym określonym poziomem logowania wyświetlanym dla STDOUT Prawidłowe wartości: [VERBOSE, DEBUG, INFO, WARN, ERROR, ASSERT].
--abi abi_name Wymuś uruchomienie testu z użyciem danego interfejsu ABI w wersji 32 lub 64. Domyślnie CTS uruchamia test raz dla każdego interfejsu ABI obsługiwanego przez urządzenie.
--logcat-on-failure,
--bugreport-on-failure,
--screenshoot-on-failure
Zapewnia lepszy wgląd w błędy i pomaga w diagnostyce.
--device-token Określa, że dane urządzenie ma dany token, na przykład --device-token 1a2b3c4d:sim-card
--skip-device-info Pomija zbieranie informacji o urządzeniu.
--skip-preconditions Pomiń warunki wstępne, aby zaoszczędzić czas działania na potrzeby iteracyjnego tworzenia instancji nowego testu. Pomija to weryfikację i konfigurację konfiguracja, na przykład przesyłanie plików multimedialnych lub sprawdzanie połączenia z Wi-Fi. połączenia.
Lista Opis
list modules Wyświetl wszystkie dostępne moduły testowe w repozytorium.
list plans lub list configs Wyświetl wszystkie dostępne plany testów (konfiguracje) w repozytorium.
list subplans Wyświetl wszystkie dostępne abonamenty podrzędne w repozytorium.
list invocations Wyświetl listę poleceń uruchamianych aktualnie wykonywanych na urządzeniach.
list commands Wyświetl wszystkie polecenia run znajdujące się w kolejce, które oczekują na przypisanie do urządzeń.
list results Wyświetl wyniki CTS obecnie przechowywane w repozytorium.
list devices Wyświetl listę obecnie połączonych urządzeń i ich stan.

Dostępne urządzenia to działają, są nieaktywne i można przeprowadzać testy.

Urządzenia niedostępne to takie, które są widoczne przez narzędzie adb, ale nie reagują na żądanie adb. i nie będzie przydzielany do testów.

Przydzielone urządzenia to urządzenia, na których są obecnie przeprowadzane testy.

Zrzuć Opis
dump logs Zrzuć logi handlowe wszystkich uruchomionych wywołań.
Dodaj Opis
add subplan --name/-n subplan_name
--result-type
[passed | failed | not_executed]
[--session session_id]
utworzyć podplan na podstawie poprzedniej sesji; ta opcja generuje w ramach planu podrzędnego, który może służyć do uruchamiania podzbioru testów.

Jedyna wymagana opcja to --session. Inne są opcjonalne, ale kiedy jest uwzględniony, po którym musi następować wartość. Opcja --result-type jest powtarzalna; na przykład Wartość add subplan --session 0 --result-type passed --result-type failed jest prawidłowa.