Escreva um teste dirigido por host na Trade Federation

Esta página descreve como escrever um teste de dispositivo no estilo JUnit4 conduzido pelo host. Isso significa que o lado do host do chicote disparará ações contra o dispositivo.

Observe que consideramos os testes "do lado do host" e os testes "orientados pelo host" como sendo ligeiramente diferentes:

  • teste dirigido por host: é um teste executado no host que interage com um ou mais dispositivos. O sistema em teste (SUT) não está no próprio host, mas está sendo testado no host.
  • teste do lado do host: é um teste executado puramente no host e testando algo apenas no host, por exemplo, testes de unidade.

Por que criar um teste orientado por host em vez de um teste de instrumentação?

Alguns testes podem exigir que você afete o estado geral do dispositivo, como emitir um comando de reinicialização. No caso de teste de instrumentação, uma reinicialização mataria a instrumentação, o teste não poderia continuar e nenhum resultado estaria disponível.

Os testes orientados por host também podem conduzir etapas de configuração adicionais que exigem interação com dispositivos externos dos quais o teste depende.

Um teste orientado por host pode lidar com esses casos de uso e permitir testes avançados do dispositivo com mais cenários. Se você estiver nessa situação, escrever um teste dirigido por host faz mais sentido.

Como os testes orientados por host são escritos em TF?

Aqui está uma amostra:

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

Os testes orientados por host no Trade Federation são orientados pelo executor de teste DeviceJunit4ClassRunner JUnit4. A estrutura geral da classe de teste é a mesma de um teste JUnit4 regular:

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

Estender BaseHostJunit4Test é uma maneira de herdar a API de utilitários de teste úteis, como:

  • installPackage : Permite instalar um APK no dispositivo alvo.
  • installPackageAsUser : Permite instalar um APK como usuário no dispositivo alvo.
  • uninstallPackage : Permite desinstalar um APK.
  • isPackageInstalled : Verifica se um pacote está instalado ou não.
  • hasDeviceFeature : Verifique se o dispositivo suporta um recurso ou não. ( pm list features )
  • runDeviceTests(DeviceTestRunOptions options) : execute um teste de instrumentação em um dispositivo de destino usando DeviceTestRunOptions para lidar com todas as opções possíveis.

Também forneça acesso ao objeto de dispositivo Tradefed:

  • getDevice() : Retorna um objeto de dispositivo TF para manipular o dispositivo.
  • getBuild() : Retorna um objeto TF de informações de construção para obter informações sobre a construção.
  • getAbi() : Retorna a ABI na qual o teste está sendo executado.

Suporte Tradefed: preparação e limpeza de dispositivos por classe

JUnit4 @BeforeClass e @AfterClass são aplicáveis ​​apenas a métodos estáticos, o que torna impossível usar o manipulador #getDevice() para fazer alguma configuração ou limpeza específica do dispositivo, uma única vez, por classe. Para resolver esse problema, use a anotação Tradefed.

  • @BeforeClassWithInfo: Executa antes das anotações @BeforeClass
  • @AfterClassWithInfo: Executa após as anotações @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 permite usar o dispositivo e armazenar propriedades que podem ser usadas no escopo estático ou não estático. BaseHostJUnit4Test suporta a obtenção de TestInformation em um escopo não estático via #getTestInformation() .

Se você não estiver estendendo BaseHostJUnit4Test , poderá implementar ITestInformationReceiver para receber o objeto TestInformation .

Como configurar um teste dirigido por host no Tradefed?

No arquivo de configuração Tradefed XML, os testes orientados por host são executados por meio do executor HostTest .

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