اختبار تطبيقات Flutter : دليلك إلى Widget Testing خطوة بخطوة

تخيل أنك انتهيت من بناء تطبيق رائع باستخدام Flutter.
كل صفحة تعمل بشكل مثالي لوحدها، وكل دالة تم اختبارها بعناية.
لكن عندما تربط كل شيء معًا — المفاجأة تحدث:
زر لا يرسل البيانات، شاشة لا تتحدث مع الخادم، أو عملية تسجيل الدخول تتعطل في منتصف الطريق.

السبب؟
رغم أن كل جزء يعمل بشكل منفصل، إلا أن المنظومة ككل لم تُختبر بعد.
وهنا يأتي دور بطل المرحلة النهائية: اختبار التكامل (Integration Testing).

ما هو اختبار التكامل في Flutter؟

اختبار التكامل هو المرحلة الأخيرة في رحلة الاختبار.
فهو يهدف إلى التحقق من أن جميع الأجزاء – الوحدات، الواجهات، الخدمات، والبيانات – تعمل معًا بتناغم تام.

بعبارة أخرى:

إذا كان اختبار الوحدة يتأكد أن “القلب” يعمل، واختبار الواجهة يتأكد أن “الوجه” يبدو جيدًا، فإن اختبار التكامل يتأكد أن الجسم بالكامل ينبض بالحياة.

في هذا النوع من الاختبارات، يتم تشغيل التطبيق الحقيقي أو جزء كبير منه على جهاز فعلي أو محاكي (Android Emulator أو iOS Simulator)، تمامًا كما يراه المستخدم النهائي.

لماذا نحتاج اختبارات التكامل؟

• التحقق من تدفق المستخدم الكامل (مثل تسجيل الدخول، الإضافة إلى السلة، والدفع).
• كشف الأخطاء التفاعلية بين الشاشات والخدمات.
• قياس الأداء واكتشاف البطء أو الأعطال.
• ضمان جاهزية التطبيق قبل الإطلاق.

بكلمات أبسط: هذه الاختبارات هي البروفة الأخيرة قبل العرض الرسمي.

إعداد اختبار تكامل في Flutter

Flutter يقدم حزمة رسمية لاختبارات التكامل تدعى:

integration_test: ^1.0.0

أضفها إلى ملف pubspec.yaml ضمن قسم dev_dependencies.

ثم أنشئ مجلدًا جديدًا باسم:

integration_test/

وأضف داخله ملفًا مثل:

app_test.dart

مثال عملي:

import 'package:flutter_test/flutter_test.dart';
import 'package:integration_test/integration_test.dart';
import 'package:my_app/main.dart' as app;

void main() {
  IntegrationTestWidgetsFlutterBinding.ensureInitialized();

  testWidgets('اختبار تسجيل الدخول', (tester) async {
    app.main();
    await tester.pumpAndSettle();

    // أدخل البريد وكلمة المرور
    await tester.enterText(find.byKey(ValueKey('email')), 'user@test.com');
    await tester.enterText(find.byKey(ValueKey('password')), '123456');

    // اضغط على زر الدخول
    await tester.tap(find.text('تسجيل الدخول'));
    await tester.pumpAndSettle();

    // تحقق من الانتقال إلى الصفحة الرئيسية
    expect(find.text('مرحباً بك'), findsOneWidget);
  });
}

في هذا الاختبار، نقوم بمحاكاة رحلة المستخدم الحقيقية:

1. تشغيل التطبيق.
2. إدخال البيانات.
3. الضغط على الأزرار.
4. التأكد من الانتقال الصحيح إلى الشاشة التالية.

إنه اختبار واقعي تمامًا، كما لو أن إنسانًا يستخدم التطبيق أمامك!

كيف يختلف عن اختبار الـWidget؟

بمعنى آخر، اختبار التكامل أغلى تكلفة من حيث الوقت، لكنه يمنحك أعلى مستوى من الثقة.

اختبار الأداء داخل اختبارات التكامل

يمكنك أيضًا قياس أداء التطبيق (مثل سرعة تحميل الشاشة) باستخدام أدوات مدمجة:

final stopwatch = Stopwatch()..start();

// تنفيذ عملية معينة
await tester.tap(find.text('تحميل البيانات'));
await tester.pumpAndSettle();

stopwatch.stop();
print('زمن التحميل: ${stopwatch.elapsedMilliseconds}ms');

بهذه الطريقة يمكنك مراقبة سرعة استجابة الواجهات والوظائف عبر الإصدارات المختلفة للتطبيق.

ربط الاختبارات بخدمات CI/CD

لتحقيق اختبار متكامل فعلاً، من الأفضل أن تُنفّذ هذه الاختبارات تلقائيًا في كل مرة تدفع فيها كودًا جديدًا (Push) إلى المستودع.
وهنا يأتي دور خدمات التكامل المستمر (Continuous Integration).

بعض أشهر الخدمات الداعمة لتطبيقات Flutter:

تخيل أنك تدفع تحديثًا جديدًا، وبعد دقائق تتلقى تقريرًا آليًا يخبرك إن كان التطبيق ما زال يعمل بشكل صحيح على كل الأجهزة! 🔥

نصائح لنجاح اختبارات التكامل

• استخدم مفاتيح ثابتة (Keys) لكل عنصر في واجهتك لتسهيل العثور عليه أثناء الاختبار.
• اجعل كل اختبار قصيرًا ومحدد الهدف.
• لا تخلط بين اختبار الأداء واختبار الوظائف.
• استخدم بيئة بيانات تجريبية حتى لا تتأثر بياناتك الحقيقية.
• راقب الاختبارات في CI لتتأكد من ثبات الأداء عبر الزمن.

الخلاصة

اختبار التكامل هو المرحلة النهائية في ضمان الجودة.
فهو لا يختبر الدوال أو الواجهات فقط، بل يختبر التجربة الكاملة للمستخدم — من لحظة فتح التطبيق إلى آخر نقرة.

ابدأ ببناء اختبارات تكامل تغطي أهم تدفقات الاستخدام في تطبيقك، وستشعر بطمأنينة مطور يعرف أن تطبيقه يعمل كما يجب… في كل مرة.

تذكّر: الاختبارات هي الجسر بين “الكود الجيد” و”التجربة الرائعة”.