كيف يتم تنظيم مشروع Flutter؟

Question

Accepted Answer

مشروع Flutter له **هيكل** معياري — يحتوي على مجلدات لكود Dart وكود خاص بالمنصات والموارد والإعدادات. يعتبر فهم الهيكل والملفات الرئيسية (خاصة `pubspec.yaml` و `lib/`) ضروريًا للتنقل وبناء تطبيقات Flutter.

## المجلدات والملفات الرئيسية

```text
my_app/
  lib/                  → your DART CODE lives here (the heart of the app)
    main.dart           → the ENTRY POINT (the main() function; app starts here)
  pubspec.yaml          → project config: DEPENDENCIES, assets, metadata (very important)
  android/              → Android-specific native project/config
  ios/                  → iOS-specific native project/config
  web/ windows/ etc.    → other platform folders
  test/                 → tests
  assets/               → images, fonts, etc. (declared in pubspec.yaml)
```

## pubspec.yaml — ملف الإعدادات الأساسي

```yaml
name: my_app
dependencies:
  flutter:
    sdk: flutter
  http: ^1.0.0           # add packages here (from pub.dev)
  provider: ^6.0.0
flutter:
  assets:
    - assets/images/     # declare assets to bundle
```

`pubspec.yaml` يعلن عن **المكتبات المستخدمة** (الحزم من pub.dev) والموارد والبيانات الوصفية — تقوم بتشغيل `flutter pub get` لتثبيت المكتبات.

## main.dart — نقطة البداية

```dart
import 'package:flutter/material.dart';

void main() => runApp(MyApp());      // runApp starts the Flutter app with a root widget

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(home: HomeScreen());   // the app's root widget
  }
}
```

## تنظيم lib/ مع نمو التطبيقات

```text
→ Beyond main.dart, organize lib/ into folders (by feature or layer):
  lib/screens/, lib/widgets/, lib/models/, lib/services/, lib/providers/ (common)
→ Keep code organized as the app grows (separation of concerns).
```

## لماذا هذا مهم

فهم كيفية تنظيم مشروع Flutter هو معرفة عملية ضرورية للتنقل وبناء وتنظيم تطبيقات Flutter، لذا فهو معرفة تأسيسية مفيدة.

معرفة **المجلدات والملفات الرئيسية** — أن **`lib/` يحتفظ بكود Dart** (قلب التطبيق، حيث تقضي معظم وقتك)، أن **`main.dart` هي نقطة البداية** (حيث يبدأ التطبيق عبر `main()` و `runApp`)، **مجلدات المنصات** (`android/`، `ios/`، وما إلى ذلك للكود الأصلي الخاص بالمنصة)، مجلدات `test/` و `assets/` — ضرورية للتوجه في مشروع Flutter.

فهم **`pubspec.yaml`** مهم بشكل خاص: إنه ملف الإعدادات الأساسي الذي يعلن عن **المكتبات المستخدمة** (الحزم من pub.dev، نظام حزم Flutter)، الموارد، والبيانات الوصفية — ستقوم بتعديله باستمرار لإضافة حزم (بتشغيل `flutter pub get` لتثبيتها)، مما يجعله أساسيًا لتطوير Flutter.

فهم **main.dart ونقطة البداية** (كيف يبدأ `main()` و `runApp` التطبيق بـ widget جذر) يوضح كيف يبدأ تطبيق Flutter.

فهم كيفية **تنظيم `lib/` مع نمو التطبيقات** (إلى مجلدات حسب الميزة أو الطبقة — الشاشات والـ widgets والنماذج والخدمات — للفصل بين المسؤوليات) يعكس الممارسات الجيدة للمشاريع القابلة للصيانة.

بما أن العمل مع Flutter يتطلب التنقل في هيكل المشروع وإدارة المكتبات عبر pubspec.yaml وفهم نقطة البداية وتنظيم الكود، وبما أن هذه المعرفة هي أساس عملي ضروري لأي تطوير Flutter، فإن فهم كيفية تنظيم مشروع Flutter — المجلدات الرئيسية و pubspec.yaml ونقطة البداية وتنظيم الكود — هو معرفة عملية تأسيسية قيمة للعمل مع مشاريع Flutter، وضرورية لبناء والحفاظ على التطبيقات والكفاءة الأساسية لتطوير Flutter.