Key-files.md

در فلاتر، چندین فایل کلیدی وجود دارد که برای توسعه و مدیریت پروژه اهمیت دارند. این فایل‌ها به دو دسته کلی تقسیم می‌شوند:

۱. فایل‌های پیکربندی پروژه

این فایل‌ها برای تنظیمات و مدیریت پروژه استفاده می‌شوند:

1. pubspec.yaml

   • نقش: مدیریت وابستگی‌ها (dependencies)، مشخص کردن دارایی‌ها (assets) و فونت‌ها (fonts)، و تنظیمات کلی پروژه.
   • اهمیت: هر تغییری در وابستگی‌ها یا دارایی‌ها باید در این فایل ثبت شود.

2. AndroidManifest.xml

   • نقش: تنظیمات اصلی برای اپلیکیشن اندروید (مانند دسترسی‌ها، فعالیت‌ها، و سرویس‌ها).
   • مسیر: android/app/src/main/AndroidManifest.xml.

3. Info.plist

   • نقش: تنظیمات اپلیکیشن برای سیستم‌عامل iOS (مانند دسترسی‌ها و شناسه‌های خاص).
   • مسیر: ios/Runner/Info.plist.

4. build.gradle (Module-level و Project-level)

   • نقش: تنظیمات بیلد برای اندروید (مانند نسخه SDK و وابستگی‌های گریدل).
   • مسیر:
     • Project-level: android/build.gradle
     • Module-level: android/app/build.gradle.

5. GeneratedPluginRegistrant.java/Swift

   • نقش: ثبت افزونه‌های استفاده شده در پروژه برای Android و iOS.
   • مسیر: به طور خودکار در پوشه‌های Android و iOS تولید می‌شود.

---

۲. فایل‌های کد و منطق برنامه

این فایل‌ها مستقیماً با طراحی و منطق اپلیکیشن مرتبط هستند:

1. main.dart

   • نقش: نقطه ورود به اپلیکیشن فلاتر.
   • اهمیت: شامل توابع اصلی برای اجرا و ساختار اولیه اپلیکیشن است.

2. lib/

   • نقش: شامل کدهای اصلی اپلیکیشن است. معمولاً ساختار زیر در این پوشه وجود دارد:
     • screens/: برای مدیریت صفحات.
     • widgets/: برای مدیریت ویجت‌های قابل استفاده مجدد.
     • models/: برای مدل‌های داده.
     • services/: برای منطق سرویس‌ها و APIها.

3. test/

   • نقش: شامل تست‌های واحد (unit tests) و تست‌های ویجت است.
   • اهمیت: اطمینان از عملکرد صحیح اپلیکیشن.

---

۳. فایل‌های مرتبط با دارایی‌ها

1. assets/

   • نقش: شامل فایل‌های رسانه‌ای (تصاویر، فایل‌های صوتی و ویدئویی).
   • اهمیت: باید در pubspec.yaml ثبت شوند.

2. fonts/

   • نقش: شامل فایل‌های فونت سفارشی.
   • اهمیت: باید در pubspec.yaml تعریف شوند.

---

۴. فایل‌های تولید شده به صورت خودکار

1. build/

   • نقش: شامل فایل‌های موقتی که در زمان اجرای پروژه تولید می‌شوند.
   • اهمیت: نباید تغییر داده شوند.

2. .dart_tool/

   • نقش: شامل اطلاعات وابستگی‌ها و ابزارهای داخلی Dart.

---

۵. فایل‌های مدیریت نسخه و محیط

1. .gitignore

   • نقش: مشخص کردن فایل‌ها یا پوشه‌هایی که نباید در سیستم کنترل نسخه (Git) ذخیره شوند.

2. .metadata و .packages

   • نقش: تنظیمات داخلی پروژه برای فلاتر و دارت.

---

توجه:

بسته به نوع پروژه شما (ساده یا پیچیده)، ممکن است نیاز به افزودن فایل‌ها و ساختارهای بیشتری برای مدیریت بهتر پروژه باشد.