Zbiór w Tradefed to konfiguracja, w której kilka testów jest uruchamianych za pomocą wspólnego narzędzia do testowania, które zarządza ogólnym wykonywaniem.
W Tradefed pakiety są uruchamiane za pomocą klasy ITestSuite, co umożliwia dodawanie i usuwanie testów niezależnie od sposobu ich uruchamiania.
Definicje
- Zestaw: zbiór modułów testowych skonfigurowanych do działania w ramach podobnej konfiguracji najwyższego poziomu, aby raportować wyniki w ramach pojedynczego wywołania.
- Konfiguracja najwyższego poziomu: konfiguracja zastosowana na urządzeniach przed uruchomieniem dowolnego z modułów testowych.
- Konfiguracja główna: konfiguracja XML Tradefed na poziomie pakietu, która opisuje, które moduły powinny być uruchamiane i które ustawienia najwyższego poziomu należy stosować.
- Konfiguracja na poziomie modułu: konfiguracja stosowana na urządzeniach tuż przed uruchomieniem modułu. Są one też nazywane ustawieniami dotyczącymi poszczególnych modułów.
- Konfiguracja modułu: odnosi się do konfiguracji
AndroidTest.xmlXML Tradefed, która opisuje moduły i wskazuję, jakie ustawienia na poziomie modułu należy wprowadzić. - Moduł: jednostka testowa składająca się z etapu konfiguracji (konfiguracja na poziomie modułu), etapu wykonania testu i etapu rozwiązywania.
- Ponowne próby w ramach modułu: automatyczne ponowne próby wykonywane przez uprząż wewnątrz modułu.
- Ponowne uruchomienie zestawu: pełne ponowne uruchomienie testów, które wcześniej nie przeszły.
Struktura ITestSuite
ITestSuitew Tradefed odnosi się do wspólnej klasy bazowej, która powoduje wykonanie pakietu. Jest on używany przez wszystkie główne pakiety testów, w szczególności Compatibility Test Suite (CTS) i Android Vendor Test Suite (VTS), i zapewnia spójne wykonywanie testów we wszystkich pakietach.
Czasami wskaźnik ITestSuite nazywamy uruchamiaczem zestawu.
Podczas wykonywania pakietu program wykonawczy wykonuje te czynności:
- Załaduj konfigurację modułu i określaj, który zestaw ma być uruchamiany.
Uruchom każdy moduł:
- Przeprowadź konfigurację na poziomie modułu.
- uruchamiać testy modułów.
- Przeprowadź analizę na poziomie modułu.
Zgłoś wyniki.
Konfiguracja na najwyższym poziomie
Z punktu widzenia Tradefed ITestSuite to tylko kolejny test. Jest to złożony test, ale nadal tylko test, jak każdy inny IRemoteTest. Dlatego podczas określania pakietu w konfiguracji Tradefed narzędzie Tradefed stosuje zwykły wzór konfiguracji: build_provider, target_preparer, test (w tym przypadku nasz zestaw) i target_cleaner.
Ta sekwencja w konfiguracji Tradefed zawierającej ITestSuite to konfiguracja najwyższego poziomu.
Przykład:
<configuration description="Common config for Compatibility suites">
<build_provider class="com.android.compatibility.common.tradefed.build.CompatibilityBuildProvider" />
<!-- Setup applied before the suite: so everything running in the suite will
have this setup beforehand -->
<target_preparer class="com.android.tradefed.targetprep.RunCommandTargetPreparer">
<option name="run-command" value="settings put global package_verifier_enable 0" />
<option name="teardown-command" value="settings put global package_verifier_enable 1"/>
</target_preparer>
<!-- Our ITestSuite implementation -->
<test class="com.android.compatibility.common.tradefed.testtype.suite.CompatibilityTestSuite" />
<result_reporter class="com.android.compatibility.common.tradefed.result.ConsoleReporter" />
</configuration>
Metadane modułu
Metadane modułu to dodatkowe informacje określone w module testowym.AndroidTest.xml Te metadane umożliwiają określenie dodatkowych informacji o module, a moduły można filtrować za pomocą tych metadanych.
Przykładowe metadane:
<option name="config-descriptor:metadata" key="component" value="framework" />
<option name="config-descriptor:metadata" key="parameter" value="instant_app" />
Przykład filtra metadanych:
--module-metadata-include-filter component=framework
Powyższe polecenie uruchomi wszystkie moduły z ramów jako metadanych komponentu.
Pełny przykład AndroidTest.xml:
<configuration description="Config for CTS Gesture test cases">
<option name="test-suite-tag" value="cts" />
<!-- Metadata -->
<option name="config-descriptor:metadata" key="component" value="framework" />
<option name="config-descriptor:metadata" key="parameter" value="instant_app" />
<!-- End: metadata -->
<target_preparer class="com.android.tradefed.targetprep.suite.SuiteApkInstaller">
<option name="cleanup-apks" value="true" />
<option name="test-file-name" value="CtsGestureTestCases.apk" />
</target_preparer>
<test class="com.android.tradefed.testtype.AndroidJUnitTest" >
<option name="package" value="android.gesture.cts" />
<option name="runtime-hint" value="10m50s" />
</test>
</configuration>
Moduł z parametrami
Specjalnym typem metadanych są parameter.
<option name="config-descriptor:metadata" key="parameter" value="instant_app" />
Te metadane określają, że moduł musi być wykonywany w innym trybie, np. jako aplikacja natychmiastowa zamiast standardowej aplikacji.
Wszystkie możliwe tryby lub parametry są opisane za pomocą parametru ModuleParametersi mają powiązany moduł obsługi w ModuleParametersHelper, który umożliwia zmianę konfiguracji modułu w celu wykonania w określonym trybie.
Na przykład tryb aplikacji błyskawicznej wymusza instalację pliku APK w trybie aplikacji błyskawicznej.
Aby parametryzacja mogła się odbyć, musisz ją włączyć w wierszu poleceń:
--enable-parameterized-modules
Możliwe jest też uruchomienie jednego z tych trybów:
--enable-parameterized-modules --module-parameter <Mode>
--enable-parameterized-modules --module-parameter INSTANT_APP
Gdy uruchamiana jest wersja parametryzowana modułu, jej wyniki są raportowane pod nazwą parametryzowaną, np. CtsGestureTestCases[instant] zamiast base CtsGestureTestCases.