Konfigurowanie testowania automatycznego CTS

Zanim uruchomisz automatyczne testy CTS, przygotuj środowisko fizyczne, skonfiguruj stanowisko robocze i urządzenie, które testujesz.

Uwaga: aby skrócić czas wykonywania testów, możesz testować więcej niż 1 DUT naraz. Możesz na przykład podłączyć urządzenia do tej samej stacji roboczej testowej za pomocą koncentratora USB.

Konfigurowanie środowiska fizycznego

Niektóre testy CTS wymagają użycia urządzeń zewnętrznych skonfigurowanych w pobliżu DUT. Aby skonfigurować środowisko fizyczne:

Uwaga: jeśli testujesz więcej niż 1 DUT naraz, musisz skonfigurować środowisko fizyczne dla każdego DUT.

1. (opcjonalnie) Jeśli urządzenie DUT obsługuje Bluetooth LE, umieść co najmniej 3 beacony Bluetooth LE w odległości 5 metrów od urządzenia DUT na potrzeby testowania skanowania Bluetooth LE. Dodatkowo:

   • Nie trzeba ich konfigurować ani emitować żadnych konkretnych sygnałów.
   • Beacony mogą być dowolnego typu, w tym iBeacon, Eddystone, a nawet urządzenia symulujące beacony BLE.

2. Umieść telefon przed sceną, np. ścianą lub sufitem, w odległości odpowiadającej minimalnej odległości ogniskowej urządzenia. Dodatkowo:

   • Scena musi być odpowiednio oświetlona, aby umożliwić testowanym czujnikom osiągnięcie i utrzymanie maksymalnej konfigurowanej wartości docelowej liczby klatek na sekundę (FPS), jak określono w CONTROL_AE_TARGET_FPS_RANGE.
   • Ta konfiguracja dotyczy wszystkich czujników kamery zgłoszonych przez getCameraIdList, ponieważ test przechodzi przez wymienione urządzenia i mierzy wydajność indywidualnie.
   • Jeśli urządzenie do testowania obsługuje kamery zewnętrzne, takie jak kamery internetowe USB, podłącz kamerę zewnętrzną podczas uruchamiania CTS. W przeciwnym razie testy CTS nie przejdą.

3. (opcjonalnie) Jeśli urządzenie DUT obsługuje globalny system pozycjonowania (GPS) lub inny globalny system nawigacji satelitarnej (GNSS), podaj sygnał GNSS do urządzenia DUT na odpowiednim poziomie sygnału do odbioru i obliczenia lokalizacji. Dodatkowo:

   • Urządzenie GPS musi być zgodne ze standardem ICD-GPS-200C.
   • Sygnał GNSS może być dowolnego typu, w tym symulatora satelity lub wzmacniacza sygnałów zewnętrznych.
   • Możesz umieścić DUT w pobliżu okna, aby mógł bezpośrednio odbierać sygnał GNSS z satelity.
   Uwaga: do testowania GPS konfiguracja połączenia z internetem nie może blokować połączeń na porcie supl.google.com 7276. Ten port pobiera dane wspomagające GPS w celu testowania obliczeń pozycji na urządzeniu lokalnym.

4. Upewnij się, że sieć Wi-Fi obsługuje IPv4 i IPv6, ma połączenie z internetem z DNS dla IPv4 i IPv6, obsługuje multicast IP oraz może traktować DUT jako odizolowanego klienta.

   Uwaga: klient izolowany to konfiguracja, w której urządzenie DUT nie ma widoczności do wiadomości rozgłoszeniowych ani wiadomości z wielu sieci w tym subsieci. Aby skonfigurować odizolowanego klienta, użyj konfiguracji punktu dostępu Wi-Fi (AP) lub uruchom DUT w odizolowanej podsieci bez połączenia z innymi urządzeniami.

   Jeśli nie masz dostępu do natywnej sieci IPv6, sieci operatora IPv6 ani sieci VPN, aby przejść testy IPv6, użyj punktu dostępu Wi-Fi i tunelu IPv6.

5. Upewnij się, że w urządzeniu testowym są ustawione flagi UP, BROADCAST i MULTICAST w interfejsie Wi-Fi.

6. Sprawdź, czy interfejs Wi-Fi ma przypisane adresy IPv4 i IPv6. Aby sprawdzić właściwości interfejsu Wi-Fi, uruchom adb shell ifconfig.

7. (opcjonalnie) Jeśli urządzenie DUT obsługuje wielozadaniowość Wi-Fi STA lub STA, skonfiguruj co najmniej 2 sieci Wi-Fi. Sieci Wi-Fi muszą działać na różnych pasmach z różnymi identyfikatorami SSID lub na tym samym identyfikatorze SSID z różnymi identyfikatorami BSSID.

8. (opcjonalnie) Jeśli urządzenie DUT obsługuje czas błądzenia (RTT) Wi-Fi, skonfiguruj urządzenie, które obsługuje RTT Wi-Fi:

   1. Umieść urządzenie RTT Wi-Fi w odległości do 12 metrów od DUT.
   2. Włącz urządzenie RTT Wi-Fi.

   Oto 2 zalecane urządzenia obsługujące Wi-Fi RTT: - Google Wifi - punkt dostępu fitlet2 firmy Compulab (ustaw pasmo 40 MHz na 5 GHz).

Konfigurowanie komputera stacjonarnego

Zanim uruchomisz automatyczne testy CTS, sprawdź, czy Twój komputer stacjonarny spełnia wymagania dotyczące sprzętu i systemu operacyjnego oraz czy ma zainstalowane odpowiednie oprogramowanie zgodnie z opisem w następnych sekcjach.

Wymagania sprzętowe Meet

Komputer stacjonarny CTS powinien spełniać te wymagania sprzętowe lub przekraczać je:

• 64-bitowy system x86

• co najmniej 256 GB wolnego miejsca na dysku, aby uwzględnić zwiększoną liczbę przypadków testowych CTS i zwiększenie rezerwacji miejsca na stos w Java w Tradefed;

• co najmniej 32 GB pamięci RAM,

Spełnianie wymagań systemu operacyjnego

Na komputerze deweloperskim musi być zainstalowana 64-bitowa dystrybucja Linuksa z biblioteką GNU C Library (glibc) w wersji 2.17 lub nowszej.

Instalowanie oprogramowania na komputer

Aby zainstalować odpowiednie oprogramowanie na komputer do korzystania z CTS:

1. Zainstaluj pakiet FFmpeg w wersji 5.1.3 lub nowszej.

2. Zainstaluj najnowsze wersje narzędzi Android Debug Bridge (adb) i Android Asset Packaging Tool (AAPT2) oraz dodaj ich lokalizację do ścieżki systemowej komputera:

   1. Aby zainstalować narzędzie wiersza poleceń sdkmanager, wykonaj instrukcje podane na początku dokumentacji Menedżera pakietu SDK. Link do pobrania narzędzi wiersza poleceń znajduje się w sekcji Tylko narzędzia wiersza poleceń na dole strony pobierania Android Studio.
   2. Zaktualizuj ścieżkę systemową, aby uwzględnić lokalizację nowo zainstalowanego sdkmanager.
   3. Za pomocą sdkmanager zainstaluj najnowsze pakiety platform-tools i build-tools. Te pakiety zawierają adb i AAPT2. Informacje o instalowaniu pakietów znajdziesz w artykule Instalowanie pakietów.
   4. Zaktualizuj ścieżkę, aby uwzględnić lokalizację nowo zainstalowanych narzędzi ADB i AAPT2.
   5. Sprawdź, czy adb i AAPT2 znajdują się na ścieżce.
   Uwaga: jeśli używasz Android Studio na komputerze z systemem operacyjnym CTS, możesz zaznaczyć opcje Android SDK Platform-Tools i Android SDK Build-Tools, aby zainstalować platformę i pakiet narzędzi do kompilowania SDK.

3. Zainstaluj odpowiednią wersję pakietu Java Development Kit (JDK):

   • W przypadku Androida 11 lub nowszego zainstaluj JDK 11.
   • W przypadku Androida 10 lub starszego zapoznaj się z artykułem Konfigurowanie CTS (AOSP 10 lub starszy).

4. (opcjonalnie) W przypadku Androida 13 lub nowszego zainstaluj virtualenv. Narzędzie virtualenv jest wymagane do testów na wielu urządzeniach.

5. Aby sprawdzić, czy Python jest zainstalowany, wpisz python3. Powinny pojawić się wersja i data Pythona, co oznacza, że jest on prawidłowo zainstalowany.

6. Pobierz i otwórz pakiety CTS z Compatibility Test Suite Downloads, które odpowiadają wersji Androida na Twoich urządzeniach, oraz wszystkie interfejsy binarne aplikacji (ABI), które obsługują Twoje urządzenia.

7. Pobierz i otwórz najnowszą wersję plików multimedialnych CTS. Pliki multimedialne obejmują klipy wideo z filmu Big Buck Bunny, które są chronione prawem autorskim przez Blender Foundation na mocy licencji Creative Commons Uznanie autorstwa 3.0.

8. (opcjonalnie) Gdy uruchomisz CTS po raz pierwszy, dynamicznie pobierze on niektóre pliki CTS związane z Mainline. W zależności od szybkości sieci pobieranie może wydłużyć czas działania CTS o co najmniej 10 minut.

   Aby uniknąć tego dodatkowego czasu działania CTS, możesz pobrać pliki CTS związane z Mainline przed uruchomieniem CTS. Informacje o pobieraniu plików CTS związanych z Mainline znajdziesz w artykule Pobieranie plików CTS związanych z Mainline.

Przygotowanie urządzenia DUT

Po skonfigurowaniu komputera musisz skonfigurować urządzenie DUT.

Konfigurowanie DUT

Aby skonfigurować DUT:

1. Upewnij się, że DUT ma zainstalowany obraz systemu oparty na kompatybilnej kompilacji dla użytkowników (Android 4.0 lub nowszej) z nazwy kodów, tagów i numerów kompilacji i korzysta z wariantu kompilacji user. Więcej informacji o wariantach kompilacji znajdziesz w sekcji Wybieranie docelowego urządzenia.

2. Jeśli urządzenie testowe ma zainstalowany Android 13 lub nowszy, sprawdź, czy w wersji ro.product.first_api_level jest ustawiony poziom interfejsu API, z którym urządzenie zostało wprowadzone na rynek. Aby ustawić tę wartość, wprowadź tę zmianę w pliku device.mk:

   PRODUCT_SHIPPING_API_LEVEL := 21
   

   Niektóre wymagania CTS zależą od kompilacji, z którą urządzenie zostało pierwotnie dostarczone. Na przykład urządzenia, które pierwotnie były dostarczane z wersjami starszymi, mogą nie spełniać wymagań systemowych obowiązujących w przypadku urządzeń z wersjami nowszymi. Aby dowiedzieć się, jakie wartości poziomu interfejsu API są prawidłowe, przeczytaj artykuł Kryptonimy, tagi i numery kompilacji. Więcej informacji o ro.product.first_api_level znajdziesz w dokumentacji poziomu interfejsu API dostawcy.

   W przypadku Androida 10 lub starszego zapoznaj się z artykułem Konfigurowanie CTS (AOSP 10 lub starszy).

3. Jeśli urządzenie obsługuje zarządzanie pakietami APEX:

   1. Pobierz pakiet APEX shim dla konkretnej wersji Androida i architektury sprzętowej. 2 kolumny po lewej stronie w tabeli pakiety shim zawierają linki do pakietów do pobrania.
   2. Skopiuj pobrany pakiet do folderu /system/apex.
   3. Zmień nazwę pliku na com.android.apex.cts.shim.apex.

4. Jeśli Twoje urządzenie nie obsługuje zarządzania pakietami APEX:

   1. Pobierz pakiety APEX shim dla konkretnej wersji Androida i architektury sprzętowej. 2 kolumny po prawej stronie w tabeli pakiety shim zawierają linki do pakietów do pobrania.
   2. Skopiuj CtsShim.apk do /system/app/
   3. Zmień nazwę CtsShim.apk na CtsShimPrebuilt.apk.
   4. Skopiuj CtsShimPriv.apk do /system/priv-app/
   5. Zmień nazwę CtsShimPriv.apk na CtsShimPrivPrebuilt.apk.

5. Jeśli urządzenie zgłasza więcej niż 1 element zabezpieczony:

   1. Pobierz plik google-cardlet.cap.
   2. Skopiuj pobrany plik do folderu /data/uicc/cardlets/.

6. Jeśli urządzenie zgłasza więcej niż 1 element zabezpieczeń, zainstaluj przykładowy applet w wbudowanym elemencie zabezpieczeń (eSE) urządzenia testowego lub na karcie SIM używanej przez to urządzenie. Więcej informacji znajdziesz w teście CTS dla elementu zabezpieczeń.

7. Jeśli urządzenie nie ma wbudowanego ekranu, podłącz do niego ekran.

8. Jeśli urządzenie ma gniazdo na kartę pamięci, włóż pustą kartę SD. Użyj karty SD obsługującej magistralę UHS (Ultra High Speed) o pojemności SDHC lub SDXC albo karty o klasie szybkości 10 lub wyższej, aby mieć pewność, że przejdzie test CTS.

   Ostrzeżenie: CTS może zmodyfikować lub usunąć dane na karcie SD podłączonej do urządzenia.

9. Jeśli urządzenie ma gniazda na karty SIM, włóż kartę SIM do każdego gniazda. Jeśli urządzenie obsługuje SMS-y, każda karta SIM musi mieć wypełnione własne pole numeru. W przypadku urządzeń z Androidem 12 lub nowszym wszystkie karty SIM muszą obsługiwać przechowywanie skróconych numerów kierunkowych. Wymagania te spełniają karty GSM i USIM z pliku dedykowanego operatorowi telekomunikacyjnemu (DF _Telecom).

   Ostrzeżenie: CTS może modyfikować lub usuwać dane na kartach SIM podłączonych do urządzenia.

10. Upewnij się, że urządzenie ma kartę SIM z uprawnieniami operatora CTS spełniającymi wymagania określone w artykule Przygotowanie karty UICC.

Uwaga: jeśli testujesz więcej niż 1 test DUT naraz, musisz skonfigurować każdy z nich.

Konfigurowanie DUT

Aby skonfigurować DUT do użycia z CTS, wykonaj te czynności.

Uwaga: jeśli używasz Androida 10 lub starszego, przeczytaj artykuł Konfigurowanie urządzenia testowego.

W przypadku testu DUT:

1. Przywróć dane fabryczne na urządzeniu.

   Ostrzeżenie: zresetowanie urządzenia spowoduje wykasowanie wszystkich danych użytkownika.

2. Ustaw język urządzenia na angielski (Stany Zjednoczone).

3. Jeśli urządzenie obsługuje dostosowywanie domyślnych czcionek, upewnij się, że domyślna rodzina czcionek bezszeryfowego to Roboto.

4. Jeśli na urządzeniu jest GPS lub funkcja Wi-Fi lub sieci komórkowej, włącz ustawienie lokalizacji.

5. Połącz się z siecią Wi-Fi, która obsługuje IPv6, może traktować urządzenie DUT jako odizolowanego klienta i ma połączenie z internetem. Wyjaśnienie dotyczące izolowanych klientów znajdziesz w artykule Konfigurowanie środowiska fizycznego.

6. Upewnij się, że nie ustawiono wzoru blokady ani hasła.

7. Włącz debugowanie USB:

   1. Otwórz Ustawienia > Informacje o telefonie i kliknij Numer kompilacji 7 razy. Opcje programisty znajdują się w kategorii ustawień System.

   2. Kliknij Debugowanie przez USB.

   Aby włączyć debugowanie przez USB w Androidzie 10 lub starszym, przeczytaj artykuł Konfigurowanie CTS (AOSP 10 lub starsza).

8. Ustaw czas w formacie 12-godzinnym.

9. Włącz Opcje programisty > Nie przerywaj.

10. Wyłączanie weryfikacji aplikacji przez USB:

    1. Otwórz Opcje programisty.

    2. Kliknij Weryfikuj aplikacje przez USB.

11. W Androidzie 13 lub nowszym włącz fałszywy modem:

    1. Otwórz Opcje programisty.

    2. Kliknij Zezwól na pozorowanie modemu.

    To ustawienie jest wymagane w przypadku niektórych testów telefonii.

Na komputerze:

1. Uruchom przeglądarkę i zamknij wszystkie ekrany uruchamiania lub konfiguracji.

2. Połącz urządzenie DUT z komputerem stacjonarnym za pomocą kabla USB.

3. Jeśli system poprosi Cię o zaakceptowanie klucza RSA umożliwiającego debugowanie na tym komputerze, kliknij Zezwalaj na debugowanie przez USB.

4. Ustaw Roboto2 jako czcionkę bezszeryfową, używając dostępnej dla użytkownika opcji (nie ukrytej).

5. Skopiuj pliki multimediów CTS na urządzenie DUT:

   1. Przejdź (cd) do ścieżki, na której pobrane i rozpakowane pliki multimedialne są przechowywane.

   2. Zmień uprawnienia pliku:

      chmod u+x copy_media.sh
      

   3. Skopiuj pliki:

      • Aby skopiować klipy o rozdzielczości do 720 x 480, uruchom:

        ./copy_media.sh 720x480

      • Jeśli nie masz pewności co do maksymalnej rozdzielczości, skopiuj wszystkie pliki:

        ./copy_media.sh all

      • Jeśli jest wiele urządzeń DUT, dodaj na końcu numer seryjny (-s) konkretnego urządzenia. Aby na przykład skopiować obraz o rozdzielczości do 720 x 480 na urządzenie o numerze seryjnym 1234567, uruchom:

        ./copy_media.sh 720x480 -s 1234567

Pobieranie plików CTS związanych z Mainline

Aby pobrać pliki CTS związane z Mainline:

1. Aby poznać poziom interfejsu API Androida na urządzeniu, wykonaj te czynności:

   adb shell getprop ro.build.version.sdk
   

2. Aby pobrać pliki Mainline CTS, postępuj zgodnie z instrukcjami w skrypcie download_mcts.sh.

   W zależności od szybkości sieci pobieranie może potrwać co najmniej 10 minut.

Pakiety shim

W tabeli poniżej znajdziesz listę pakietów dostępnych dla poszczególnych wersji i architektur urządzeń:

Wersja urządzenia	Pakiety (jeśli APEX jest obsługiwany)		Pakiety (jeśli APEX nie jest obsługiwany)
	WŁĄCZ WYKRYWANIE	x86	WŁĄCZ WYKRYWANIE	x86
Android 15	15-arm-release	android15-x86-release	android15-arm-CtsShim.apk android15-arm-CtsShimPriv.apk	android15-x86-CtsShim.apk android15-x86-CtsShimPriv.apk
Android 14	android14-arm-release	android14-x86-release	android14-arm-CtsShim.apk android14-arm-CtsShimPriv.apk	android14-x86-CtsShim.apk android14-x86-CtsShimPriv.apk
Android 13	android13-arm-release	android13-x86-release	android13-arm-CtsShim.apk android13-arm-CtsShimPriv.apk	android13-x86-CtsShim.apk android13-x86-CtsShimPriv.apk
Android 12	android12-arm-release	android12-x86-release	android12-arm-CtsShim.apk android12-arm-CtsShimPriv.apk	android12-x86-CtsShim.apk android12-x86-CtsShimPriv.apk
Android 11	android11-arm-release	android11-x86-release	android11-arm-CtsShim.apk android11-arm-CtsShimPriv.apk	android11-x86-CtsShim.apk android11-x86-CtsShimPriv.apk
Android 10	android10-release		android10-arm-CtsShim.apk android10-arm-CtsShimPriv.apk	android10-x86-CtsShim.apk android10-x86-CtsShimPriv.apk
Android 9, O i O-MR1	Nie dotyczy	Nie dotyczy	arm-CtsShim.apk arm-CtsShimPriv.apk	x86-CtsShim.apk x86-CtsShimPriv.apk

Co dalej?

Po przeczytaniu tego dokumentu przejdź do automatycznego uruchamiania testów CTS.