Skonfiguruj pakiety

Zbiór w Tradefed to konfiguracja, w której kilka testów jest uruchamianych przez wspólnego wykonawcę testów, który 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

  • Pakiet: zestaw modułów testowych skonfigurowanych do uruchamiania w podobnej konfiguracji najwyższego poziomu do raportowania wyników w ramach jednego 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ą to tak zwane konfiguracje modułów.
  • Konfiguracja modułu: odnosi się do konfiguracji AndroidTest.xml XML Tradefed, która opisuje moduły i określa, 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 wykonywania testu i etapu rozwiązywania.
  • Ponowne próby w ramach modułu: automatyczne ponowne próby wykonywane przez uprząż wewnątrz modułu.
  • Ponowna próba wykonania testów: pełne ponowne uruchomienie testów, które wcześniej nie przeszły.

Struktura ITestSuite

ITestSuite w Tradefed oznacza wspólną klasę bazową uruchamiającą wykonanie pakietu. Jest on używany przez wszystkie główne pakiety testów, w tym Compatibility Test Suite (CTS) i Android Vendor Test Suite (VTS), i zapewnia spójne wykonywanie testów we wszystkich pakietach.

Czasami określamy ITestSuite jako osobę biegową.

Uruchamiający pakiet wykonuje te kroki:

  1. Załaduj konfigurację modułu i określaj, który zestaw ma być uruchamiany.

  2. Uruchom każdy moduł:

    1. Przeprowadź konfigurację na poziomie modułu.
    2. Przeprowadzaj testy modułów.
    3. Przeprowadź analizę na poziomie modułu.

  3. Zgłoś wyniki.

Konfiguracja na najwyższym poziomie

Z punktu widzenia Tradefed ITestSuite to po prostu kolejny test. Jest to złożony test, ale nadal tylko test, jak każdy inny IRemoteTest. Zatem określenie uruchomienia pakietu w konfiguracji Tradefed odbywa się zgodnie ze standardowym wzorcem konfiguracji: uruchamianie build_provider, target_preparer, test (w tym przypadku nasz pakiet) 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

W module testowym nazywamy metadane modułu AndroidTest.xml. Te metadane umożliwiają podanie dodatkowych informacji o module, a moduły można filtrować przy użyciu 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 spowoduje uruchomienie wszystkich modułów z ramką jako metadane 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 zostać uruchomiony w innym trybie, np. jako aplikacja błyskawiczna, a nie w standardowym trybie aplikacji.

Wszystkie możliwe tryby lub parametry są opisane za pomocą funkcji 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 można było używać parametrów, w wierszu poleceń musisz włączyć parametry:

--enable-parameterized-modules

Możliwe jest też uruchomienie jednego trybu z:

--enable-parameterized-modules --module-parameter <Mode>

--enable-parameterized-modules --module-parameter INSTANT_APP

Gdy działa wersja modułu z parametrami, raportuje wyniki pod nazwą modułu z parametrami, np. CtsGestureTestCases[instant] w porównaniu z podstawową wersją CtsGestureTestCases.