Scrivere un test basato sull'host in Trade Federation

Questa pagina descrive come scrivere un test del dispositivo in stile JUnit4 basato sull'host. Ciò significa che il lato host del cablaggio attiverà azioni sul dispositivo.

Tieni presente che consideriamo i test "lato host" e i test "basati sull'host" leggermente diversi:

  • test basato sull'host: è un test in esecuzione sull'host che interagisce con uno o più dispositivi. Il sistema in fase di test (SUT) non si trova sull'host stesso, ma viene testato dall'host.
  • test lato host: è un test eseguito esclusivamente sull'host e che verifica qualcosa solo sull'host, ad esempio i test delle unità.

Perché creare un test basato sull'host anziché un test di strumentazione?

Alcuni test potrebbero richiedere di influire sullo stato generale del dispositivo, ad esempio l'emissione di un comando di riavvio. Nello scenario di test di strumentazione, un riavvio interromperebbe la strumentazione, il test non potrebbe continuare e non sarebbero disponibili risultati.

I test basati sull'host possono anche comportare passaggi di configurazione aggiuntivi che richiedono l'interazione con dispositivi esterni da cui dipende il test.

Un test basato sull'host può gestire questi casi d'uso e consentire test avanzati del dispositivo con più scenari. Se ti trovi in questa situazione, la soluzione più logica è scrivere un test basato sull'host.

Come vengono scritti i test basati sull'host in TF?

Ecco un esempio:

@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());
    }
}

I test basati sull'host in Trade Federation sono gestiti dal runner di test JUnit4 DeviceJUnit4ClassRunner. La struttura generale della classe di test è la stessa di un normale test JUnit4:

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

L'estensione di BaseHostJunit4Test è un modo per ereditare API di utilità di test utili, ad esempio:

  • installPackage: consente di installare un APK sul dispositivo di destinazione.
  • installPackageAsUser: consente di installare un APK come utente sul dispositivo di destinazione.
  • uninstallPackage: consente di disinstallare un APK.
  • isPackageInstalled: controlla se un pacchetto è installato o meno.
  • hasDeviceFeature: controlla se il dispositivo supporta una funzionalità. (pm list features)
  • runDeviceTests(DeviceTestRunOptions options): esegui un test di strumentazione su un dispositivo di destinazione utilizzando DeviceTestRunOptions per gestire tutte le opzioni possibili.

Fornisci anche l'accesso all'oggetto dispositivo Tradefed:

  • getDevice(): Restituisce un oggetto dispositivo TF per manipolare il dispositivo.
  • getBuild(): Restituisce un oggetto TF con informazioni sulla build per ottenere informazioni sulla build.
  • getAbi(): restituisce l'ABI su cui viene eseguito il test.

Supporto di Tradefed: preparazione e pulizia del dispositivo per classe

JUnit4 @BeforeClass e @AfterClass sono applicabili solo ai metodi statici, il che rende impossibile utilizzare il gestore #getDevice() per eseguire alcune configurazioni o pulizie specifiche del dispositivo, una tantum e per classe. Per risolvere il problema, utilizza l'annotazione Tradefed.

  • @BeforeClassWithInfo: viene eseguito prima delle annotazioni @BeforeClass
  • @AfterClassWithInfo: viene eseguito dopo le annotazioni @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 ti consente di utilizzare il dispositivo e memorizzare le proprietà che possono essere utilizzate nell'ambito statico o non statico. BaseHostJUnit4Test supporta l'ottenimento di TestInformation in un ambito non statico tramite #getTestInformation().

Se non stai estendendo BaseHostJUnit4Test, puoi implementare ITestInformationReceiver per ricevere l'oggetto TestInformation.

Come configurare un test basato sull'host in Tradefed

Nel file di configurazione XML di Tradefed, i test basati sull'host vengono eseguiti tramite il runner HostTest.

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