دليل لإعداد بيئة تطوير Flutter متكاملة وتهيئة مشروع جديد جاهز للإنتاج، يشمل إعداد النظام، إنشاء المشروع، ضبط الهيكلة والمعايير، إعداد التكامل المستمر (CI)، وخطوات التحقق النهائية.
من نص البرومبت
```أنت مهندس أول في 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 مكتمل التهيئة. - إذا ظهر خطأ غير قابل للتجاوز، اشرحه بوضوح ثم توقف.```