Przewodnik po uaktualnianiu stacji testowej Androida OmniLab do wersji 2.0

OmniLab Android Test Station (ATS) to główne narzędzie, którego deweloperzy i inżynierowie testów używają do automatyzacji testowania urządzeń z Androidem. OmniLab ATS udostępnia interfejs do zarządzania urządzeniami, wyświetlania wyników i uruchamiania pakietów testów, takich jak Compatibility Test Suite (CTS).

OmniLab ATS 2.0 to znacząca modernizacja silnika stacji. Przenieśliśmy infrastrukturę bazową do OmniLab, nowoczesnej platformy Google o wysokiej wydajności. Dzięki tej zmianie deweloperzy i inżynierowie testów Androida mogą korzystać z tych samych niezawodnych narzędzi, których używa Google.

Zalecamy rozpoczęcie korzystania z OmniLab ATS 2.0. Jest on dostępny za pomocą flagi konfiguracyjnej, dzięki czemu możesz od razu korzystać z większej wydajności i stabilności.

Główne korzyści OmniLab ATS 2.0

  • Zmodernizowana infrastruktura: wykorzystuje platformę OmniLab, co zwiększa stabilność i wydajność.
  • Płynne przejście: nie wprowadzamy żadnych zmian w interfejsie użytkownika ani w podstawowych procesach wykonywania testów.
  • Gotowość na przyszłość: jest zgodny z ujednoliconą infrastrukturą testową Google, co umożliwia szybsze wdrażanie nowych funkcji.

Nowe funkcje

Te funkcje usprawniają operacje testowe:

  • Zbiorcza aktualizacja planów testów: możesz skonfigurować kilka planów testów jednocześnie, filtrując je za pomocą etykiet. Dzięki temu możesz w jednym kroku zaktualizować niestandardowe harmonogramy, działania związane z uruchamianiem testów i zasoby w kilkudziesięciu planach, co skraca czas ręcznej konfiguracji.

  • Ulepszona obsługa wdrożenia w chmurze i na wielu hostach: ATS 2.0 optymalizuje planowanie testów, przesyłanie plików i buforowanie plików, aby system był niezawodny, wydajny i elastyczny w różnych trybach wdrożenia.

  • Orkiestracja w chmurze: ATS 2.0 obsługuje orkiestrację w chmurze, która umożliwia dynamiczne udostępnianie, skalowanie i zarządzanie urządzeniami wirtualnymi Cuttlefish podczas uruchamiania testów.

Porównanie funkcji: ATS 1.0 a ATS 2.0

MożliwościATS 1.0ATS 2.0
Silnik bazowyTradefed i klaster TradefedPlatforma OmniLab, standardowa platforma urządzeń Google
UIInterfejs MTTInterfejs MTT
SkalujLokalne i wielohostoweLokalne i wielohostowe; zoptymalizowane pod kątem wdrożenia wielohostowego
Liczba ponownych próbPodstawowe reguły ponawianiaMożliwość dostosowania liczby ponownych prób, zaawansowane planowanie ponawiania
Obsługa urządzeń wirtualnychObsługa lokalnych i chmurowych farm urządzeńObsługa lokalnych i chmurowych farm urządzeń
Przetwarzanie wynikówOparte na TradefedOparte na OmniLab ATS (współdzielone z konsolą CTS)
Interfejs APIObsługiwaneObsługiwane

Zmiany w środowisku użytkowników

Większość zmian jest wewnętrzna, ale warto zwrócić uwagę na te aktualizacje zachowań:

  • Pakiety testów chronione hasłem (np. Security Test Suite (STS)): w ATS 1.0 pakiety chronione hasłem były wyodrębniane za pomocą skryptów setup_scripts Trade Federation (np. przez uruchomienie unzip -P ...).

    W OmniLab ATS 2.0 serwer natywnie obsługuje dekompresję pakietu testowego przed zainicjowaniem Tradefed. W przypadku pakietów chronionych hasłem:

    • Usuń ręczne polecenie unzip -P ... z sekcji Setup Scripts (Skrypty konfiguracji). Zachowanie skryptu rozpakowywania spowoduje błąd wywołania.
    • Wpisz hasło odszyfrowywania pakietu testowego bezpośrednio w polu Password (Hasło) w sekcji Test Resource Defs (Definicje zasobów testowych).

    Dostosowywanie konfiguracji testu STS w ATS 2.0

    Rysunek 1. Dostosowywanie konfiguracji testu STS w ATS 2.0.

  • Katalog wyników: struktura katalogu wyjściowego na dysku na potrzeby wyników testów została zaktualizowana ze względu na zmianę infrastruktury. Nadal możesz jednak uzyskać dostęp do tych plików na panelu Test Run (Uruchomienie testu).

    Wyświetlanie plików wyjściowych

    Rysunek 2. Wyświetlanie listy plików wyjściowych.

  • Logi testów: struktura logów testów uległa zmianie. Możesz zobaczyć 3 źródła logów z jednego wywołania: logi wygenerowane przez test Tradefed xTS (dostępne też w ATS 1.0), logi serwera OmniLab dotyczące stanu urządzenia i testu oraz logi testów Mobly dotyczące modułów Mobly w wersji 2.

    Źródła logów ATS 2.0

    Rysunek 3. Źródła logów ATS 2.0: Tradefed xTS, serwer OmniLab i logi testów Mobly.

    Jeśli uruchomisz CTS z włączoną opcją dynamicznego pobierania, OmniLab ATS automatycznie uruchomi testy MCTS oprócz testów CTS, a logi MCTS będą też dostępne w sekcji logów Tradefed.

    Test MCTS na liście testów

    Rysunek 4. Test MCTS uruchomiony przez dynamiczne pobieranie XTS.

    Logi MCTS w sekcji logów Tradefed

    Rysunek 5. Logi MCTS w sekcji logów Tradefed oprócz logów CTS.

Proces wprowadzania zmian

Aktualizacja to przełącznik oprogramowania oparty na flagach, więc nie trzeba ponownie instalować ani zmieniać sprzętu.

Aby włączyć nowy OmniLab ATS 2.0:

  1. Zatrzymaj bieżącą instancję:

    mtt stop
  2. Uruchom OmniLab ATS z flagą force_ats_version 2:

    mtt start --force_ats_version 2

    Jeśli nie używasz najnowszej wersji kompilacji, dodaj --force_update, aby ją pobrać:

    mtt start --force_ats_version 2 --force_update
  3. Opcjonalnie: jeśli napotkasz problemy z ATS 2.0, możesz tymczasowo wrócić do ATS 1.0, usuwając --force_ats_version 2 lub używając --force_ats_version 1:

    mtt start --force_ats_version 1

Harmonogram zmian

W 2026 r. stopniowo wycofujemy OmniLab ATS 1.0. Zaplanuj migrację odpowiednio:

  • I kwartał 2026 r.: ATS 2.0 jest dostępny dla wszystkich deweloperów i partnerów jako opcja.
  • II kwartał 2026 r.: ATS 2.0 staje się domyślną wersją dla coraz większej liczby deweloperów i partnerów.
  • III kwartał 2026 r.: ATS 2.0 staje się standardową wersją dla wszystkich deweloperów i partnerów.
  • IV kwartał 2026 r.: starsza wersja ATS 1.0 zostanie wycofana i usunięta z kompilacji produkcyjnych.

Pomoc

Jeśli podczas aktualizacji napotkasz problemy, skorzystaj z tych zasobów: