إعداد Flutter على macOS وتحديد SDK وPATH وفحص Flutter Doctor وXcode وأدوات Android حسب منصات التطوير المطلوبة.
اختر أدوات المنصات التي ستبني لها
تثبيت Android Studio لا يثبت Xcode، وتثبيت Flutter لا يحل تراخيص Android تلقائيًا. راجع flutter doctor -v وحدد المنصات المطلوبة ثم أصلح التحذيرات المرتبطة بها؛ غياب أداة Windows على Mac ليس خللًا في تطبيق Android. اختر تنزيل SDK الملائم لمعمارية الجهاز واحتفظ بمساره بعيدًا عن مجلدات مؤقتة.
تحقق من PATH دون تغييره عشوائيًا
استعمل which flutter وflutter –version لتحديد النسخة الفعلية، وافتح طرفية جديدة بعد تعديل ملف shell. مسار Homebrew يختلف بين Intel وApple Silicon؛ اتبع ناتج مثبت Homebrew بدل إضافة /opt/homebrew لكل جهاز. افتح Xcode لاستكمال إعداداته واختر Command Line Tools الصحيحة، ثم جرب بناء تطبيق صغير على الهدف المطلوب.
خطوات التطبيق والشرح
كيفيه تثبيت Flutter على Mac – خطوة بخطوة
أصبحت Flutter واحدة من أهم الأدوات المستخدمة لتطوير التطبيقات عبر الأنظمة الأساسية بفضل أدائها الممتاز وسهولة استخدامها. قد يبدو تثبيت Flutter على نظام macOS معقدًا للبعض، ولكن باتباع الخطوات الصحيحة، يمكن إكمال العملية بنجاح ودون أي متاعب. سنشرح في هذا الدليل جميع خطوات التثبيت ونجيب على الأسئلة
الأكثر شيوعا التي يمكنك العثور عليها.
حدد اسم المستخدم وتحقق من الموقع
pwd
سيظهر لك هذا الأمر المسار الحالي للملف، حتى تتمكن من معرفة اسم المستخدم.
قم بإنشاء المجلد الأساسي لتثبيت Flutter
استخدم الأمر التالي لإنشاء مجلد يسمى التطوير
mkdir development
تأكد من نجاح إنشاء المجلد عن طريق كتابة:
ls
الان عليك الانتقال الي الرابط التالي ومن ثم تحميل فلاتر كما هو موضح بالصوره ولكن اختر نوع المعالج الخاص بجهازك سواء intel / Apple Silicon
لتثبيت Flutter، قم بفك ضغط الملف داخل المجلد development باستخدام الأمر:
unzip ~/Downloads/flutter_macos_arm64_3.24.4-stable.zip -d ~/development/
هذا الكود يقوم بفك الضغط عن الملف الذي تم تحميله ومساره في التنزيلات
cd development/
ls
كيفية التحقق من وجود ملف Flutter في المجلد؟
عند اكتمال عملية فك الضغط، استخدم الأوامر التالية:
إذا وجدت مجلد Flutter قيد التطوير، فهذا يعني أن الخطوات قد تمت بنجاح.
cd development/
ls
كيف يمكنني تكوين خط أنابيب Flutter للتشغيل من أي مكان على النظام؟
انتقل إلى دليل المستخدم عن طريق كتابة:
cd
ls -al
البحث في الملفات. zshrc أو . ثم يفتح zshenv الملف المطلوب
open .zshrc
اذا لم تجد الملف سوف تحتاج لإنشاءه ويمكنك ذلك عن طريق الكود التالي
cd ~/
touch .zshrc
open .zshrc
بعد فتح الملف فقط الصق الكود المسؤول عن عمليه تعريف ملف path الخاص بي ال bin في متغيرات النظام
export PATH=$HOME/development/flutter/bin:$PATH
ومن ثم قم بحفظ الملف عن طريق command + s واغلق الملف
كيف يمكنني التأكد من نجاح التثبيت؟
اغلق التيرمينال وافتح واحد جديد ومن ثم اكتب الامر التالي
flutter –version
إذا رأيت رسالة “مرحبًا بك في Flutter”، فهذا يعني أن التثبيت كان ناجحًا. وايضا رقم الاصدار الخاص بفلاتر
تثبيت وإعدادات Xcode
يعد Xcode ضروريًا لتطوير تطبيقات iOS. لبدء التثبيت، افتح App Store، وابحث عن Xcode وقم بتنزيله. تأكد من أن إصدار macOS لديك متوافق مع إصدار Xcode الذي تريده.
بعد ذلك اغلقه بعد التثبيت
افتح موقع اندرويد ستوديو لتحميل الاصدار المناسب لك عن طريق اختيار المعالج المخصص لك
بعد التحميل انقر عليه ومن ثم اسحبه الي ملف التطبيقات كما هو موضح
بعد ذلك انتقل الي تطبيقاتك في النظام وابحث عليه وافتحه وهنا اختر انه لا يوجد لديك اعدادات معينه
واختر stander في عمليه التثبيت
بعد التثبيت انتقل الي الاندرويد ستوديو ومن ثم المكتبات والاضافات وقم بتحميل فلاتر و دارت
وانتقل بعدها لمدير sdk لتحميل licenses
بعد ذلك قم بتثبيته بشكل صحيح كما هو موضح
بعدها افتح terminal واكتب بداخل الامر التالي
flutter doctor –android-licenses
بعد ذلك اكتب y لاي شرط يطلبه منك الي ان تتم العمليه بشكل صحيح
كيف يمكنني التحقق من أن بيئة Flutter الخاصة بي مهيأة بالكامل؟
استخدم Flutter Doctor، الذي يقوم بإجراء فحص كامل للنظام ويظهر لك أي مشاكل أو أدوات مفقودة:
سوف يقابلك مشكله Xcode – develop for iOS and macOS
سوف تقوم بفتح Xcode ومن ثم الانتقال الي الاعدادات
تاكد من اختيارك للاصدار المناسب في هذا الجزء بشكل صحيح
اذا كانت لديك مشكله CocoaPods not installed flutter في Flutter doctor
خطوات تثبيت Homebrew على نظام التشغيل macOS
فتح الوحدة الطرفية: افتح تطبيق الوحدة الطرفية في نظام التشغيل macOS.
قم بتثبيت Homebrew باستخدام هذا الأمر: الصق الأمر التالي في Terminal واضغط على Enter لبدء التثبيت:
اتبع التعليمات: سيُطلب منك إدخال كلمة مرور النظام، ثم سيبدأ تنزيل وتثبيت Homebrew تلقائيًا. تأكد من اتباع جميع التعليمات التي تظهر على الشاشة.
/bin/bash -c “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)”
تعيين مسار لـ Homebrew: بمجرد اكتمال التثبيت، قد تحتاج إلى تعيين مسار لـ Brew ليتم تشغيله من أي مكان. يمكنك إضافة السطر التالي في ملف .zshrc
عن طريق فتح الملف
open .zshrc
وضع الكود التالي بداخله
echo ‘export PATH=”/opt/homebrew/bin:$PATH”‘ >> ~/.zshrc
بعد التأكد من تثبيت Homebrew بنجاح، يمكنك الآن تثبيت Cocopod باستخدام الأمر التالي:
brew install cocoapods
مرجع للتنفيذ
راجع التوثيق الخاص بهذا الموضوع وطابق إعداداته مع إصدار أدوات مشروعك. اختبر السلوك المستهدف وحالة الفشل قبل إدماج المثال في تطبيق منشور.
