Testes de unidade com o Glance

A API de teste de unidade do Glance permite testar seu código do Glance sem inflar visualizações ou precisar de um UI Automator. Por exemplo, a API de teste de unidade permite verificar condições, como se os elementos estão em uma lista ou se as caixas foram marcadas, usando comparadores como hasContentDescriptionEqualTo ou isChecked.

Essa API é leve e requer menos configuração. Assim, você pode realizar o desenvolvimento orientado a testes enquanto desenvolve partes individuais do widget e as organiza para melhorar a reutilização do código.

Observação: o teste não renderiza os elementos combináveis em teste, então não permite que você clique neles. Em vez disso, ele usa matchers, que permitem realizar asserções em ações em elementos clicáveis, como iniciar um serviço ou uma atividade.

Configurar

As dependências necessárias para usar a biblioteca de testes de unidade são mostradas nos exemplos abaixo:

// Other Glance and Compose runtime dependencies.
...
testImplementation 'androidx.glance:glance-testing:1.1.0'
testImplementation 'androidx.glance:glance-AppWidget-testing:1.1.0'
testImplementation 'org.robolectric:robolectric:4.11.1'
...
// You may include additional dependencies, such as Robolectric, if your test
// needs to set a LocalContext.

Estrutura do teste

Organize funções combináveis fora da classe GlanceAppWidget para permitir a reutilização de código e o teste de unidade. Reduza a complexidade das unidades em teste o máximo possível.

class MyGlanceComposableTest {
    @Test
    fun myNewsItemComposable_largeSize_hasAuthorAsSubtitle() = runGlanceAppWidgetUnitTest {
        // Prepare inputs and state
        setAppWidgetSize(100.dp, 100.dp)

        // Set the composable under test
        provideComposable {
            MyNewsItemComposable(TEST_NEWS_ITEM)
        }

        // Perform assertions
        onNode(hasTestTag("subTitle"))
            .assertHasText(TEST_NEWS_ITEM.authorName)
    }
}

Definir o contexto e o tamanho do teste

Se a função combinável ler o contexto usando o método LocalContext.current(), será necessário definir um contexto usando o método LocalContext.current(). Caso contrário, esta etapa é opcional.

É possível usar qualquer framework de teste de unidade do Android baseado em JVM, como o Roboletric, para fornecer o contexto.

Se a função combinável acessar LocalSize, defina o tamanho desejado para o teste antes de fornecer um combinável no teste. O tamanho padrão é 349.dp x 455.dp, o que equivale a um widget de 5 x 4 mostrado em um dispositivo Pixel 4 no modo retrato.

• Se o AppWidget usar sizeMode == Single, defina-o como minWidth e minHeight no arquivo info.xml do widget.
• Se o AppWidget usar sizeMode == Exact, você poderá identificar os tamanhos a ser testados de maneira semelhante a como você determina um tamanho para o widget e identificar os tamanhos de paisagem e retrato em que o widget pode aparecer e testá-los.
• Se o AppWidget usar sizeMode == Responsive, você poderá definir um dos tamanhos da lista que você fornece ao especificar o sizeMode.

A duração padrão de um tempo limite de teste é de 1 segundo, mas é possível transmitir uma duração personalizada como um argumento para o método runGlanceAppWidgetUnitTest se a infraestrutura de teste aplicar um tempo limite diferente.

Para mais informações e exemplos de código, consulte a documentação de referência de runGlanceAppWidgetUnitTest.