Testes de integração com flutter_driver

Testes unitários garantem que partes individuais do seu app funcionem como esperado, mas e a sua aplicação como um todo?

Testes unitários garantem que partes individuais da sua aplicação funcionem como o esperado, mas e a aplicação como um todo? É aí que entra o teste de integração.

Flutter driver

Se você nunca fez teste de integração no Flutter (ou em qualquer outro lugar), não se preocupe! Adicionar testes de integração ao seu app é uma tarefa simples no Flutter. Um conjunto de artigos bem útil vai guiar você.

  1. Uma introdução ao teste de integração: o que é isso e como configurar?

  2. Lidar com scroll: como fazer o padrão comum de rolar até algo?

Chegar a esse ponto garante que seu app possa rodar sem travar, que determinadas telas possam ser acessadas, que ações específicas tenham algum resultado, e assim por diante. Quais testes você cria depende das suas necessidades. Você pode ter um teste que abre todas as telas do seu app, ou testes que percorrem jornadas específicas do usuário.

Mas podemos ir além com flutter_driver usando-o para testes de performance.

Profiling de performance

Basta envolver seu teste com flutterDriver.traceAction para registrar a performance do seu app enquanto o teste está rodando. Esses dados de saída (em formato JSON) podem ser usados em testes de integração contínua (CI), para garantir, por exemplo, que determinadas métricas se mantenham acima ou abaixo de um limite específico. Os dados também podem ser usados para depurar problemas de performance. Para detalhes sobre como fazer profiling de performance, veja o artigo sobre teste de integração, Profiling de performance.

Como referência, a Flutter Gallery tem um teste de integração que percorre todas as demos e captura métricas de performance de um subconjunto delas.

Testes de screenshot

Teste de screenshot é a técnica de renderizar a UI, capturar uma imagem da saída e então comparar o resultado com uma imagem esperada. Uma forma fácil de adicionar testes de screenshot ao seu app é usar o flutterDriver.screenshot. Para saber mais e ver um exemplo de código real, veja o artigo no Medium, Testando a UI do Flutter com o Flutter Driver, do membro da comunidade Darshan Kawar.

Esse método pode ser facilmente integrado à sua configuração de testes de integração contínua para evitar regressões de UI. A Flutter Gallery tem alguns testes de screenshots e uma configuração de workflow do GitHub para testar automaticamente os PRs que chegam.

dart
await pumpWidgetWithImages(
  tester,
  const GalleryApp(initialRoute: demoBannerRoute),
  homeAssets,
);
​
await tester.pumpAndSettle();
​
await expectLater(
  find.byType(GalleryApp),
  matchesGoldenFile('goldens/demo_desktop_dark.png'),
);

Testes de a11y

a11y, ou teste de acessibilidade, é um tipo de teste de usabilidade realizado para garantir que a aplicação possa ser usada por pessoas com deficiências, como deficiência visual, perda auditiva, deficiência motora e assim por diante. Use flutterDriver.getSemanticsId para verificar os rótulos semânticos, por exemplo, para confirmar que todas as imagens têm rótulos semânticos.

dart
final imageLabel = find.bySemanticsLabel('Company logo');
int id = await flutterDriver.getSemanticsId(imageLabel);
expect(id, isNotNull);

Saiba mais sobre testes de acessibilidade em outro ótimo artigo de Darshan Kawar, Desenvolvendo e testando apps acessíveis no Flutter.

Testes de i18n

i18n, ou teste de internacionalização, é o processo de verificar que uma aplicação pode ser usada em vários idiomas e regiões sem nenhuma alteração.

Dependendo de como o seu código de localização está configurado, você pode trocar os locales usando o delegate das suas localizações.

dart
ExampleAppLocalizationsDelegate.load(Locale('fr'));

Como alternativa, ao usar o MaterialApp, basta permitir a sobrescrita do locale do app para rodar em um locale diferente.

dart
void main() {
  runApp(const ExampleApp());
}
​
class ExampleApp extends StatelessWidget {
  const ExampleApp({
    Key key,
    this.locale,
  }) : super(key: key);
​
  final Locale locale;
​
  @override
  Widget build(BuildContext context) {
      return MaterialApp(
        locale: locale,
        ...
      );
  }
}

No arquivo de driver que inicia o app, defina o locale.

dart
void main() {
  runApp(const ExampleApp(locale: Locale('fr')));
}

Dica extra

Quer saber se um elemento está presente na página?

dart
/// Returns a [Future] that resolves to true if the widget specified by [finder]
/// is present, false otherwise.
Future<bool> isPresent(SerializableFinder finder, FlutterDriver driver,
    {Duration timeout = const Duration(seconds: 1)}) async {
  try {
    await flutterDriver.waitFor(finder, timeout: timeout);
    return true;
  } catch (exception) {
    return false;
  }
}

Você pode escolher o timeout que funcionar melhor para o seu app.

Considerações finais

Agora você já deve ter uma boa ideia do que é possível com o flutter_driver. Você pode combinar métodos conforme suas necessidades; por exemplo, fazer testes de screenshot usando locales diferentes. Se esquecemos de algo, conte para nós nos comentários! Para mais informações, veja a documentação da API do flutter_driver .

Sobre o autor: Pierre-Louis é recém-graduado pela University of Waterloo. Baseado em Munique, ele faz parte de uma equipe que mantém a biblioteca Material do Flutter. Tem grande interesse em UI, UX e desenvolvimento de apps. Você pode se conectar com ele no LinkedIn e no GitHub.

Mais do Flutter