تست ویجت‌ها (Widget Testing) و ساخت خروجی نهایی انتشار

Testing & Build and release an Android app

آموزش نوشتن تست خودکار برای ویجت‌ها با flutter_test و دستورات رسمی ساخت فایل APK، App Bundle (AAB) و نسخه Web

فهرست مطالب این صفحه

آزمایش خودکار اپلیکیشن قبل از انتشار، اطمینان می‌دهد که با اضافه کردن قابلیت‌های جدید، بخش‌های قبلی دچار خطا نمی‌شوند. Flutter سه سطح تست را پشتیبانی می‌کند: Unit Test (تست منطق و توابع)، Widget Test (تست رابط کاربری و تعاملات) و Integration Test (تست سرتاسری روی دستگاه واقعی).

۱. نوشتن Widget Test با flutter_test

در پوشه test/ پروژه، می‌توانید با استفاده از تابع testWidgets و شیء WidgetTester ویجت‌ها را رندر کرده، روی دکمه‌ها کلیک کنید و نتیجه را بررسی نمایید:

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

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

  @override
  State<CounterWidget> createState() => _CounterWidgetState();
}

class _CounterWidgetState extends State<CounterWidget> {
  int _count = 0;

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        body: Center(child: Text('شمارش: $_count')),
        floatingActionButton: FloatingActionButton(
          onPressed: () => setState(() => _count++),
          child: const Icon(Icons.add),
        ),
      ),
    );
  }
}

void main() {
  testWidgets('افزایش شمارنده با کلیک روی دکمه افزودن', (WidgetTester tester) async {
    await tester.pumpWidget(const CounterWidget());

    expect(find.text('شمارش: 0'), findsOneWidget);
    expect(find.text('شمارش: 1'), findsNothing);

    await tester.tap(find.byIcon(Icons.add));
    await tester.pump();

    expect(find.text('شمارش: 1'), findsOneWidget);
  });
}

برای اجرای تمام تست‌های پروژه، دستور زیر را در ترمینال اجرا کنید:

Terminal / Bash
flutter test

۲. ساخت خروجی نهایی انتشار (Release Build)

در حالت توسعه (flutter run)، فلاتر برنامه را در حالت Debug اجرا می‌کند که شامل ابزارهای اشکال‌زدایی است و حجم و سرعت نهایی را نشان نمی‌دهد. برای انتشار عمومی اپلیکیشن از دستورات Release استفاده کنید:

  • ساخت فایل Android App Bundle (پیشنهادی برای Google Play):
    Terminal / Bash
    flutter build appbundle --release
    
  • ساخت فایل نصب مستقیم اندروید (APK):
    Terminal / Bash
    flutter build apk --release
    
  • ساخت خروجی بهینه‌شده برای وب (Web):
    Terminal / Bash
    flutter build web --release
    

نکته: پیش از ساخت نسخه نهایی، حتماً دستور flutter analyze را اجرا کنید تا مطمئن شوید هیچ خطا یا هشدار استاتیکی در کدهای شما وجود ندارد.