Pisanie testu hosta w ramach Federacji handlowej

Na tej stronie opisano, jak napisać test urządzenia w stylu JUnit4 sterowany przez hosta. Oznacza to, że strona hosta będzie wywoływać działania przeciwko urządzenia.

Pamiętaj, że testy „po stronie hosta” i „sterowane przez hosta” różnią się od siebie w następujący sposób:

  • test sterowany przez hosta: test uruchamiany na hoście, który wchodzi w interakcję z jednym lub większą liczbą urządzeń; Testowany system nie znajduje się na hoście, ale jest które są testowane przez hosta.
  • test po stronie hosta: test przeprowadzany tylko na hoście i testujący coś tylko na hoście, na przykład do testów jednostkowych.

Dlaczego lepiej utworzyć test oparty na hoście zamiast testu z instrumentacją?

Niektóre testy mogą wymagać wpływu na ogólny stan urządzenia, na przykład wydania polecenia ponownego uruchamiania. W przypadku testu instrumentacji ponowne uruchomienie spowoduje zatrzymanie instrumentacji, test nie będzie mógł być kontynuowany, a nie będzie żadnych wyników.

Testy sterowane przez hosta mogą też wymagać dodatkowych czynności konfiguracyjnych, które wymagają interakcji z urządzeniami zewnętrznymi, od których zależy test.

Test sterowany przez hosta może obsługiwać te przypadki użycia i umożliwiać zaawansowane testowanie urządzenia w większej liczbie scenariuszy. Jeśli jesteś w takiej sytuacji, napisz jest najsensowniejszy.

Jak tworzyć testy host-driven w TF?

Oto przykład:

@RunWith(DeviceJUnit4ClassRunner.class)
public class SampleHostJUnit4DeviceTest extends BaseHostJUnit4Test {
    @Before
    public void setUp() throws Exception {
       // Some setup
    }

    @Test
    public void testCheckWeHaveDevice() throws Exception {
        Assert.assertNotNull(getDevice());
    }
}

Testy hostowane w ramach federacji wymiany są uruchamiane przez DeviceJUnit4ClassRunner, czyli testujący JUnit4. Ogólna struktura klasy testu jest taka sama jak w przypadku zwykłego testu JUnit4:

  • @BeforeClass
  • @Before
  • @Test
  • @After
  • @AfterClass
  • Assume, Assert

Przedłużam BaseHostJunit4Test to sposób dziedziczenia interfejsu API narzędzi testowych, takich jak:

  • installPackage: umożliwia instalowanie pakietu APK na urządzeniu docelowym.
  • installPackageAsUser: umożliwia instalowanie pliku APK jako użytkownik w środowisku docelowym. urządzenia.
  • uninstallPackage: umożliwia odinstalowanie pliku APK.
  • isPackageInstalled: sprawdź, czy jest zainstalowany pakiet.
  • hasDeviceFeature: sprawdź, czy urządzenie obsługuje daną funkcję. (pm list features)
  • runDeviceTests(DeviceTestRunOptions options): uruchamianie instrumentacji wykonaj test na urządzeniu docelowym za pomocą DeviceTestRunOptions aby zapoznać się z wszystkimi możliwymi opcjami.

Udziel też dostępu do obiektu urządzenia Tradefed:

  • getDevice(): zwraca obiekt urządzenia TF do manipulowania urządzeniem.
  • getBuild(): zwraca obiekt TF z informacjami o kompilacji, aby uzyskać informacje o kompilacji.
  • getAbi(): zwraca interfejs ABI, na którym jest wykonywany test.

Obsługa Tradefed: przygotowanie i czyszczenie urządzeń w poszczególnych klasach

JUnit4 @BeforeClass i @AfterClass są dostępne tylko w przypadku metod statycznych, co uniemożliwia użycie #getDevice() do jednorazowego skonfigurowania lub wyczyszczenia urządzenia w ramach danej klasy. Aby rozwiązać ten problem, użyj funkcji z adnotacji Tradefed.

  • @BeforeClassWithInfo: działa przed adnotacjami @BeforeClass.
  • @AfterClassWithInfo: działa po adnotacjach @AfterClass
   @BeforeClassWithInfo
   public static void beforeClassWithDevice(TestInformation testInfo) {
       assertNotNull(testInfo.getDevice());
       testInfo.properties().put("mytest:test-prop", "test");
   }

   @AfterClassWithInfo
   public static void afterClassWithDevice(TestInformation testInfo) {
       assertNotNull(testInfo.getDevice());
       testInfo.properties().put("mytest:test-prop", "test");
   }

TestInformation umożliwia korzystanie z właściwości urządzenia i sklepu, które można stosować w zakresie statycznym lub niestatycznym. Interfejs BaseHostJUnit4Test obsługuje pobieranie TestInformation w zakresie niestatycznym za pomocą interfejsu #getTestInformation().

Jeśli nie rozszerzasz rozszerzenia BaseHostJUnit4Test, możesz zaimplementować ITestInformationReceiver, aby otrzymać obiekt TestInformation.

Jak skonfigurować test host-driven w Tradefed?

W pliku konfiguracji XML Tradefed testy host-driven są uruchamiane przez HostTestrunner.

<test class="com.android.tradefed.testtype.HostTest" >
    <option name="class" value="android.sample.cts.SampleHostJUnit4DeviceTest" />
</test>