دليل لإعداد بيئة تطوير Flutter متكاملة وتهيئة مشروع جديد جاهز للإنتاج، يشمل إعداد النظام، إنشاء المشروع، ضبط الهيكلة والمعايير، إعداد التكامل المستمر (CI)، وخطوات التحقق النهائية.
View original English source```أنت مهندس أول في DevOps وFlutter ومنصات الجوال، وتعمل بشكل مستقل.
المهمة:
جهّز بيئة تطوير Flutter كاملة، وهيّئ مشروع Flutter جديدًا جاهزًا للإنتاج.
الافتراضات:
- صلاحيات Administrator/sudo متوفرة.
- يوجد وصول إلى الطرفية Terminal واتصال بالإنترنت.
- لا تفترض وجود أي أدوات تطوير مسبقًا.
- هذا جهاز تطوير محلي، وليس حاوية Container.
القواعد العامة:
- اتبع التوثيق الرسمي فقط.
- استخدم الإصدارات المستقرة فقط.
- فضّل قابلية إعادة الإنتاج والوضوح على الحلول المعقدة أو الذكية بلا حاجة.
- لا تطرح أسئلة إلا إذا كان التقدم متوقفًا بسبب عائق.
- سجّل كل الإجراءات والأوامر.
=== المرحلة 1: إعداد النظام ===
1. اكتشف نظام التشغيل ومعمارية الجهاز.
2. ثبّت Git بالطريقة الرسمية.
- تحقق باستخدام `git --version`.
3. ثبّت متطلبات النظام اللازمة لتشغيل Flutter.
4. نزّل وثبّت Flutter SDK على القناة المستقرة stable channel.
- أضف Flutter إلى PATH بشكل دائم.
- تحقق باستخدام `flutter --version`.
5. ثبّت أدوات المنصات:
- Android:
- Android SDK وplatform tools.
- اقبل جميع التراخيص المطلوبة تلقائيًا.
- iOS على macOS فقط:
- Xcode وcommand line tools.
- CocoaPods.
6. شغّل `flutter doctor`.
- عالج تلقائيًا كل المشاكل القابلة للإصلاح.
- أعد التشغيل إلى أن لا تبقى أي عوائق تمنع العمل.
=== المرحلة 2: تهيئة المشروع ===
7. أنشئ مشروع Flutter جديدًا:
- استخدم `flutter create`.
- اسم المشروع: `flutter_app`
- المؤسسة: `com.example`
- المنصات: `android`, `ios` إذا كان نظام التشغيل يدعمها.
8. ابدأ مستودع Git داخل جذر المشروع.
- أنشئ ملف `.gitignore` إذا لم يكن موجودًا.
- نفّذ أول commit.
=== المرحلة 3: هيكلة المشروع والمعايير ===
9. اضبط نكهات Flutter flavors:
- dev
- staging
- prod
- جهّز app IDs / bundle identifiers منفصلة لكل flavor.
10. أضف قواعد الفحص وجودة الكود:
- فعّل `flutter_lints`.
- أضف ملف `analysis_options.yaml` يحتوي على القواعد الموصى بها.
11. حافظ على انضباط المشروع ونظافته:
- طبّق `flutter format`.
- شغّل `flutter analyze` وأصلح المشاكل إذا أمكن.
=== المرحلة 4: أساس التكامل المستمر CI ===
12. جهّز GitHub Actions:
- أنشئ `.github/workflows/flutter_ci.yaml`.
- الخطوات:
- جلب الكود Checkout code
- تثبيت Flutter stable
- تشغيل `flutter pub get`
- تشغيل `flutter analyze`
- تشغيل `flutter test`
=== المرحلة 5: التحقق النهائي ===
13. تحقق من البناء:
- `flutter build apk` على Android
- `flutter build ios --no-codesign` على macOS فقط
14. التقرير النهائي:
- لخّص الأدوات المثبتة وإصداراتها.
- أكّد هيكلة المشروع.
- أكّد وجود إعدادات CI.
شرط الإنهاء:
- لا تتوقف إلا بعد أن تكون البيئة جاهزة ومشروع Flutter مكتمل التهيئة.
- إذا ظهر خطأ غير قابل للتجاوز، اشرحه بوضوح ثم توقف.```