ساختار پروژه 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 با دو فاصله) حساس است. مهمترین بخشهای آن عبارتاند از:
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، باید دستور زیر را در ریشه پروژه اجرا کنید تا وابستگیها دریافت و ثبت شوند:
flutter pub get
تفاوت Hot Reload و Hot Restart
یکی از قدرتمندترین ویژگیهای فلاتر برای توسعه سریع رابط کاربری، قابلیت Stateful Hot Reload است که در کمتر از یک ثانیه تغییرات کد را روی دستگاه یا شبیهساز اعمال میکند:
- Stateful Hot Reload (کلید
rدر ترمینال یا ذخیره فایل در IDE):- کدهای تغییریافته Dart را در ماشین مجازی در حال اجرا (Dart VM) تزریق میکند.
- فریمورک درخت ویجتها را مجدداً بازسازی (
build) میکند، اما وضعیت فعلی برنامه (State) را حفظ میکند (برای مثال اگر در صفحه سوم هستید یا فرمی را پر کردهاید، همانجا باقی میمانید).
- Hot Restart (کلید
Shift + Rدر ترمینال):- اپلیکیشن را کاملاً از ابتدا راهاندازی میکند و تمام وضعیتهای ذخیرهشده در حافظه (
State) به مقدار اولیه بازمیگردند. - زمانی که تغییراتی در
initState()، متغیرهای سراسری (static/global) یا تابعmain()ایجاد میکنید، لازم است از Hot Restart استفاده کنید.
- اپلیکیشن را کاملاً از ابتدا راهاندازی میکند و تمام وضعیتهای ذخیرهشده در حافظه (
- Full Restart (توقف و اجرای مجدد
flutter run):- هر زمان پلاگین جدیدی با کد بومی (Android/iOS) به
pubspec.yamlاضافه کنید، باید برنامه را متوقف کرده و دوباره اجرا کنید.
- هر زمان پلاگین جدیدی با کد بومی (Android/iOS) به