Testes de unidade com o Glance

A API de teste de unidade do Glance permite testar o 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 exige menos configuração. Assim, você pode realizar o desenvolvimento orientado por testes à medida que desenvolve partes individuais do widget e as organiza para melhorar a reutilização do código.

Configurar

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

// Other Glance and Compose runtime dependencies.
...
testImplementation 'androidx.glance:glance-testing:1.1.1'
testImplementation 'androidx.glance:glance-appwidget-testing:1.1.1'
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 contexto e tamanho para o teste

Se a função combinável ler o contexto usando o método LocalContext.current(), defina um contexto usando setContext(). Caso contrário, essa etapa é opcional.

Você pode usar qualquer framework de teste de unidade do Android baseado em JVM, como o Robolectric, para fornecer o contexto.

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

• Se o AppWidget usar sizeMode == Single, defina isso como minWidth e minHeight no arquivo info.xml do widget.
• Se o AppWidget usar sizeMode == Exact, você poderá identificar os tamanhos a serem testados de maneira semelhante a como determinar um tamanho para seu widget e identificar tamanhos de paisagem e retrato em que o widget pode aparecer e testar para eles.
• Se o AppWidget usar sizeMode == Responsive, defina esse valor como um dos tamanhos da lista fornecida ao especificar o sizeMode.

A duração padrão para um tempo limite de teste é de 1 segundo, mas você pode transmitir uma duração personalizada como argumento para o método runGlanceAppWidgetUnitTest se a infraestrutura de teste exigir um tempo limite diferente.

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