Flutter Mobile Development · درس

اختبار التكامل

أجرِ اختبارات التكامل للتحقق من التفاعل بين عناصر متعددة ومسارات المستخدم الكاملة داخل تطبيقك

اختبار التكامل درس مجاني في Flutter Mobile Development على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في Flutter Mobile Development، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة Flutter Mobile Development 4 دروس في المجموع.

بعض أجزاء هذا الدرس لم تُترجم بعد وتظهر باللغة الإنجليزية.

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.

الأسئلة الشائعة

هل درس «اختبار التكامل» مجاني؟

نعم — نص درس «اختبار التكامل» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة Flutter Mobile Development، انتقل إلى CoddyKit PRO. تتضمن دورة Flutter Mobile Development 4 دروس في المجموع.

ماذا ستتعلم في «اختبار التكامل»؟

أجرِ اختبارات التكامل للتحقق من التفاعل بين عناصر متعددة ومسارات المستخدم الكاملة داخل تطبيقك تتمرن على Flutter Mobile Development مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ Flutter Mobile Development؟

لا تُشترط خبرة سابقة. Flutter Mobile Development على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.

كم من الوقت يستغرق درس «اختبار التكامل»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس Flutter Mobile Development هذا؟

نعم. كل درس في Flutter Mobile Development يتضمن محرر أكواد مدمج، لذا تكتب وتشغل أكواداً حقيقية مباشرة في متصفحك وتحصل على تعليقات فورية من الذكاء الاصطناعي — بدون إعداد محلي.

جميع الدروس في هذه الدورة

← العودة إلى Flutter Mobile Development