Flutter Mobile Development · Lección

Pruebas de integración

Realice pruebas de integración para validar la interacción entre varios widgets y flujos completos de usuario dentro de su aplicación.

Pruebas de integración es una lección gratuita de Flutter Mobile Development en CoddyKit. Esta es la lección 2 de 4. Puedes leer la lección completa abajo gratuitamente — luego la practicas en el navegador con un editor de código integrado y un tutor de IA 24/7. Forma parte de la ruta de aprendizaje de Flutter Mobile Development, y tu progreso se sincroniza en la web y la app de CoddyKit. El curso de Flutter Mobile Development incluye 4 lecciones en total.

Partes de esta lección aún no han sido traducidas y se muestran en inglés.

What are Integration Tests?

Welcome! In this lesson, we'll explore integration testing, a crucial step for building robust Flutter apps.

Integration tests verify how different parts of your application work together. Think of it as simulating a user interacting with your app through a complete flow, like logging in, navigating, and performing actions.

Why Integration Tests Matter

While widget tests (which we covered previously) focus on individual UI components, integration tests give you confidence that entire user journeys function correctly.

Real-world scenarios: Mimic actual user behavior.
Catch bugs early: Uncover issues that only appear when multiple widgets or services interact.
Ensure stability: Validate that changes don't break existing features.

Setting Up Integration Tests

Flutter uses the integration_test package to enable these tests. It allows you to run tests directly on a real device or emulator, providing a true representation of your app's behavior.

First, add the integration_test dependency to your pubspec.yaml file under both dependencies and dev_dependencies:

dependencies:
  flutter:
    sdk: flutter
  integration_test:
    sdk: flutter
dev_dependencies:
  flutter_test:
    sdk: flutter
  integration_test:
    sdk: flutter

Integration Test Structure

Integration tests typically involve two main files:

The test driver, usually in test_driver/app_test.dart. This file sets up the environment to run your integration tests.
The actual test suite, typically in integration_test/app_test.dart. This is where you write your test logic.

The Test Driver Entry Point

The test_driver/app_test.dart file is simple. It initializes the IntegrationTestWidgetsFlutterBinding and calls integrationDriver() to handle the test execution.

import 'package:integration_test/integration_test_driver.dart';

Future<void> main() async {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();
  await integrationDriver();
}

App for Integration Testing

Let's create a simple counter app to demonstrate an integration test. Notice we add Keys to widgets we want to find and interact with in our tests.

import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  int _counter = 0;

  void _incrementCounter() {
    setState(() {
      _counter++;
    });
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Counter App',
      home: Scaffold(
        appBar: AppBar(title: const Text('Counter App')),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              const Text(
                'You have pushed the button this many times:',
              ),
              Text(
                '$_counter',
                key: const Key('counterText'),
                style: Theme.of(context).textTheme.headlineMedium,
              ),
            ],
          ),
        ),
        floatingActionButton: FloatingActionButton(
          key: const Key('incrementButton'),
          onPressed: _incrementCounter,
          tooltip: 'Increment',
          child: const Icon(Icons.add),
        ),
      ),
    );
  }
}

Writing Your Integration Test

Now, let's write the actual test in integration_test/app_test.dart. We'll use tester.pumpAndSettle() to wait for animations and UI updates, and tester.tap() to simulate user interaction.

import 'package:flutter/material.dart';
import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';

// Import your app's main file. 
// Replace 'my_app_name' with your actual package name.
import 'package:my_app_name/main.dart' as app;

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  group('Counter App Integration Tests', () {
    testWidgets('Verify counter increments on button tap', (tester) async {
      app.main(); // Start the application
      await tester.pumpAndSettle(); // Wait for the UI to build

      // Find the counter text and verify its initial value
      final counterTextFinder = find.byKey(const Key('counterText'));
      expect(counterTextFinder, findsOneWidget);
      expect(tester.widget<Text>(counterTextFinder).data, '0');

      // Find and tap the increment button
      final incrementButtonFinder = find.byKey(const Key('incrementButton'));
      await tester.tap(incrementButtonFinder);
      await tester.pumpAndSettle(); // Wait for state change & UI update

      // Verify the counter text has updated to 1
      expect(tester.widget<Text>(counterTextFinder).data, '1');

      // Tap again and verify it updates to 2
      await tester.tap(incrementButtonFinder);
      await tester.pumpAndSettle();
      expect(tester.widget<Text>(counterTextFinder).data, '2');
    });
  });
}

Running Integration Tests

To execute your integration tests, you'll use the flutter drive command from your project's root directory. Make sure you have an Android emulator/device or iOS simulator/device running.

This command tells Flutter to use your test driver to run the integration test suite against your app.

flutter drive \
  --driver=test_driver/app_test.dart \
  --target=integration_test/app_test.dart

Advanced Interactions

Integration tests can simulate complex user flows across multiple screens. You can:

Enter text: Use tester.enterText(find.byType(TextField), 'Hello');
Scroll: Use tester.scrollUntilVisible() to bring widgets into view.
Navigate: Tap buttons that trigger Navigator.push() or Navigator.pop() and verify screen changes.

Always use Keys for robust widget identification, especially when dealing with dynamic UIs or multiple similar widgets.

Quick Check

Which of the following are primary benefits of using integration tests in Flutter development?

Recap: Integration Testing

Great job! You've learned about integration testing in Flutter. We covered:

What integration tests are and why they are vital for app stability.
How to set up the integration_test package.
The structure of integration tests and how to write them.
How to run tests using flutter drive.

Integration tests provide high confidence that your app's features work together seamlessly, just like a user would experience them.

Preguntas frecuentes

¿La lección «Pruebas de integración» es gratis?

Sí — el texto completo de «Pruebas de integración» es gratis para leer aquí en la web. Para practicarla de forma interactiva (editor de código integrado y tutor de IA 24/7) y desbloquear el resto del curso de Flutter Mobile Development, actualiza a CoddyKit PRO. El curso de Flutter Mobile Development incluye 4 lecciones en total.

¿Qué aprenderé en «Pruebas de integración»?

Realice pruebas de integración para validar la interacción entre varios widgets y flujos completos de usuario dentro de su aplicación. Practicas Flutter Mobile Development con código real que ejecutas directamente en el navegador, y un tutor de IA 24/7 responde tus preguntas mientras trabajas en la lección.

¿Necesito experiencia previa para empezar Flutter Mobile Development?

No se requiere experiencia previa. Flutter Mobile Development en CoddyKit está estructurado para principiantes hasta estudiantes avanzados, así que puedes empezar aquí o desde el inicio y avanzar a tu ritmo. Esta es la lección 2 de 4.

¿Cuánto tiempo toma la lección «Pruebas de integración»?

La mayoría de las lecciones de CoddyKit toman alrededor de 5–10 minutos. Cada una es compacta e interactiva, así que avanzas constantemente y retomas exactamente por donde dejaste en la web y la app.

¿Puedo escribir y ejecutar código en esta lección de Flutter Mobile Development?

Sí. Cada lección de Flutter Mobile Development incluye un editor de código integrado, así que escribes y ejecutas código real directamente en tu navegador y obtienes retroalimentación instantánea de IA — sin configuración local necesaria.

Todas las lecciones de este curso

← Volver a Flutter Mobile Development