ساختار پروژه Flutter، فایل pubspec.yaml و Hot Reload

Flutter project structure & Hot reload

بررسی کامل پوشه‌ها و فایل‌های کلیدی یک پروژه Flutter، نقش pubspec.yaml و نحوه عملکرد Stateful Hot Reload در برابر Hot Restart

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

هنگامی که یک پروژه جدید با دستور flutter create می‌سازید، فلاتر مجموعه‌ای استاندارد از پوشه‌ها و فایل‌های پیکربندی را ایجاد می‌کند تا کدهای شما به‌صورت هم‌زمان روی پلتفرم‌های مختلف قابل کامپایل و اجرا باشند.

ساختار پوشه‌ها و فایل‌های اصلی پروژه

در ریشه هر پروژه استاندارد Flutter، پوشه‌ها و فایل‌های زیر قرار دارند:

مسیر در پروژه نقش و کاربرد فنی
lib/ پوشه اصلی کدهای Dart شما. نقطه شروع برنامه فایل lib/main.dart است.
pubspec.yaml فایل پیکربندی پروژه؛ محل تعریف نام اپلیکیشن، نسخه، وابستگی‌ها (dependencies)، فونت‌ها و دارایی‌ها (assets).
test/ محل قرارگیری فایل‌های تست خودکار (Unit Tests و Widget Tests).
android/ و ios/ کدهای بومی (Native) و تنظیمات بیلد اختصاصی برای پلتفرم‌های Android و iOS.
web/، windows/، macos/، linux/ فایل‌های میزبان و تنظیمات کامپایل برای پلتفرم‌های وب و دسکتاپ.
build/ پوشه موقت خروجی‌های کامپایل‌شده (نباید در سیستم کنترل نسخه Git ذخیره شود).

آشنایی با فایل pubspec.yaml

فایل pubspec.yaml با فرمت YAML نوشته می‌شود و به تورفتگی‌ها (Indentation با دو فاصله) حساس است. مهم‌ترین بخش‌های آن عبارت‌اند از:

YAML
name: my_flutter_app
description: A new Flutter project.
publish_to: 'none'
version: 1.0.0+1

environment:
  sdk: '>=3.5.0 <4.0.0'

dependencies:
  flutter:
    sdk: flutter
  http: ^1.2.2

dev_dependencies:
  flutter_test:
    sdk: flutter
  flutter_lints: ^4.0.0

flutter:
  uses-material-design: true

پس از هر تغییر در بخش dependencies یا assets، باید دستور زیر را در ریشه پروژه اجرا کنید تا وابستگی‌ها دریافت و ثبت شوند:

Terminal / Bash
flutter pub get

تفاوت Hot Reload و Hot Restart

یکی از قدرتمندترین ویژگی‌های فلاتر برای توسعه سریع رابط کاربری، قابلیت Stateful Hot Reload است که در کمتر از یک ثانیه تغییرات کد را روی دستگاه یا شبیه‌ساز اعمال می‌کند:

  1. Stateful Hot Reload (کلید r در ترمینال یا ذخیره فایل در IDE):
    • کدهای تغییریافته Dart را در ماشین مجازی در حال اجرا (Dart VM) تزریق می‌کند.
    • فریم‌ورک درخت ویجت‌ها را مجدداً بازسازی (build) می‌کند، اما وضعیت فعلی برنامه (State) را حفظ می‌کند (برای مثال اگر در صفحه سوم هستید یا فرمی را پر کرده‌اید، همان‌جا باقی می‌مانید).
  2. Hot Restart (کلید Shift + R در ترمینال):
    • اپلیکیشن را کاملاً از ابتدا راه‌اندازی می‌کند و تمام وضعیت‌های ذخیره‌شده در حافظه (State) به مقدار اولیه بازمی‌گردند.
    • زمانی که تغییراتی در initState()، متغیرهای سراسری (static / global) یا تابع main() ایجاد می‌کنید، لازم است از Hot Restart استفاده کنید.
  3. Full Restart (توقف و اجرای مجدد flutter run):
    • هر زمان پلاگین جدیدی با کد بومی (Android/iOS) به pubspec.yaml اضافه کنید، باید برنامه را متوقف کرده و دوباره اجرا کنید.