التثبيت على MacOS

FlutterSy Team

 

 

توثيق منصة Flutter

التثبيت علىmacOS :

تثبيت منصة Flutter على نظام تشغيل macOS:

يضم القسم التالي العناوين التالية:

  • متطلبات النظام.
  • احصل على Flutter SDK .
    • قم بتشغيل التعليمة التالية flutter doctor ضمن محرر الاوامر.
    • التنزيل مباشرة من GitHub بدلاً من استخدام الملف المضغوط (archive).
    • قم بتحديث المسار path.
  • إعداد المنصة (Platform setup)
  • إعداد المنصة لتطوير تطبيقات iOS
    • قم بتثبيت Xcode
    • قم بإعداد المحاكي (iOS simulator)
    • قم بإنشاء وتشغيل تطبيق Flutter بسيط.
    • شغل التطبيق على جهاز يعمل بنظام iOS (iOS device).
  • إعداد المنصة لتطوير تطبيقات Android
    • قم بتثبيت Android Studio
    • قم بإعداد جهاز Android الخاص بك
    • قم بإعداد محاكي لجهاز Android
  • إعداد المنصة لتطوير تطبيقات الويب
  • الخطوات الواجب تنفيذها بعد تثبيت المنصة.

متطلبات النظام:

لتثبيت منصة Flutter وتشغيلها ، يجب أن تفي بيئة التطوير لديك بالحد الأدنى من المتطلبات التالية:

  • نظام تشغيل macOS (64-bit) .
  • مساحة خالية على القرص: 2.8 جيجا بايت ( هذا لا يشمل مساحة القرص المطلوبة لتثبيت الـ IDE والأدوات الأخرى التي ستذكر في البند التالي).
  • الأدوات: تستخدم Flutter الأداة git للتثبيت (installation) والترقية (upgrade). نوصي بتثبيت Xcode ، والذي يتضمن git ، كما يمكنك أيضًا تثبيت git بشكل منفصل.

ملاحظة هامة: إذا كنت تقوم بالتثبيت على جهاز Mac بأحدث معالج Apple M1 ، فقد تجد هذه الملاحظات التكميلية مفيدة لأننا نكمل الدعم لبنية Apple Silicon الجديدة.

احصل على Flutter SDK:

  1. قم بتنزيل حزمة التثبيت التالية للحصول على أحدث إصدار مستقر من Flutter SDK:

flutter_macos_2.0.4-stable.zip

لتحميل قنوات الإصدار (release channels) الأخرى أوالإصدارات الأقدم ، راجع صفحة إصدارات SDK.

  1. قم باستخراج الملف المضغوط ووضع مجلد Flutter في مسار التثبيت المطلوب، على سبيل المثال:

  1. أضف أداة Flutter إلى المسار path:

يقوم الأمر السابق بتعيين متغير PATH الخاص بك من أجل نافذة الـ terminal الحالية. لإضافة Flutter إلى المسار path بشكل دائم ، راجع الفقرة التي بعنوان “قم بتحديث المسار” في هذا الملف.

أنت جاهز الآن لتشغيل أوامر Flutter.

ملاحظة: لتحديث إصدار Flutter الموجود لديك، راجع ترقية Flutter.

قم بتشغيل التعليمة التالية flutter doctor ضمن محرر الاوامر:

قم بتشغيل الأمر التالي لمعرفة ما إذا كانت هناك أي تبعيات للنظام الأساسي (platform dependencies) ما زلت تحتاجها لإكمال تثبيت منصة flutter على جهازك بشكل صحيح (للحصول على verbose output أضف الـflag التالي -v):

يتحقق هذا الأمر من بيئتك ويعرض تقريرًا عن حالة تثبيت منصة Flutter .

تم تجميع الـ Dart SDK مع Flutter وبالتالي فليس من الضروري تثبيت Dart بشكل منفصل.

تحقق من نتيجة هذه التعليمة بعناية بحثًا عن برامج أخرى قد تحتاج إلى تثبيتها أو القيام بمهام أخرى (ستظهر لك بخط عريض ضمن محرر الاوامر).

لاحظ النتيجة التالية التي ظهرت على أحد الأجهزة التي تم تثبيت flutter عليها ،وبعد تنفيذ الامر السابق:

تظهر النتيجة السابقة أن هناك نقصا في بعض التبعيات (Android SDK). سنتعلم ضمن الأقسام التالية من التوثيق طريقة حل هذه المشكلة. بعد أن تحل أي مشكلة تصادفك أثناء التثبيت، قم بتنفيذ التعليمة flutter doctor مجددا لتتحقق من أنك قمت بإعداد كل شيء بشكل صحيح.

التنزيل مباشرة من GitHub بدلاً من استخدام الملف المضغوط (archive):

هذا مقترح فقط لحالات الاستخدام المتقدمة (advanced use cases).

يمكنك أيضًا استخدام git مباشرةً بدلاً من تنزيل الملف المضغوط. على سبيل المثال ، لتنزيل الـ stable branch:

قم بتحديث المسار كما هو موضح في الفقرة التالية من هذا الملف، قم بتشغيل الأمر flutter doctor لمعرفة ما إذا كانت هناك أي تبعيات للنظام الأساسي (platform dependencies) ما زلت تحتاجها لإكمال تثبيت منصة flutter على جهازك بشكل صحيح (Android SDK مثلا).

إذا لم تستخدم ملف الـ archive ، فسيقوم Flutter بتنزيل الـ development binaries الضرورية عند الحاجة لها ( أما إذا كنت تستخدم الأرشيف ، فسيتم تضمينها في الملف المضغوط). قد ترغب في تنزيل الـ development binaries الضرورية هذه مسبقًا (على سبيل المثال ، قد ترغب في القيام بذلك عند إعداد hermetic build environments ، أو إذا كان لديك intermittent network availability). للقيام بذلك ، قم بتشغيل الأمر التالي:

للحصول على خيارات تنزيل إضافية ، راجع flutter help precache.

تحذير: تستخدم أداة Flutter أدوات Google Analytics لإعداد تقرير مجهول (anonymously report) عن إحصائيات استخدام المنصة وتقارير الأعطال الأساسية. تُستخدم هذه البيانات للمساعدة في تحسين أدوات Flutter بمرور الوقت.

لا يتم إرسال تحليلات أداة Flutter عند تشغيلها لأول مرة. لتعطيل ميزة إعداد التقارير ، اكتب الامر التالي ضمن محرر الأوامر flutter config –no-analytics. لعرض الإعدادات الحالية ، اكتب flutter config. إذا قمت بإلغاء الاشتراك في التحليلات ، فسيتم إرسال حدث لإلغاء الاشتراك ، ومن ثم لا يتم إرسال أي معلومات أخرى بواسطة أداة Flutter.

عندما تقوم بتنزيل Flutter SDK ، فإن هذا يعتبر موافقة منك على شروط خدمة Google. ملاحظة: تصف سياسة خصوصية Google كيفية معالجة البيانات في هذه الخدمة.

علاوة على ذلك ، يشتمل Flutter على Dart SDK ، والتي قد ترسل مقاييس الاستخدام وتقارير الأعطال إلى Google.

قم بتحديث المسار path:

يمكنك تحديث متغير PATH للجلسة الحالية في سطر الأوامر ، كما هو موضح في الفقرة السابقة احصل على الـ Flutter SDK. ولكنك قد ترغب على الأرجح في تحديث هذا المتغير بشكل دائم ، بحيث يمكنك تشغيل أوامر flutter في أي جلسة للـ terminal.

خطوات تعديل هذا المتغير بشكل دائم لجميع جلسات الـ terminal هو أمر متعلق بالجهاز الذي تعمل حاليا تحديدا (machine-specific). عادةً ما يكون بإضافة سطر إلى ملف يتم تنفيذه كلما فتحت نافذة جديدة للـterminal. على سبيل المثال:

  1. حدد مسار الـ Flutter SDK على جهازك وانسخه إلى الحافظة، ستحتاجه في الخطوة الثالثة.
  2. افتح (أو أنشئ) ملف rc الخاص بالـshell التي تستخدمها. يخبرك الأمر التالي echo $ SHELL ضمن الـ terminal ما هي الـ shell التي تستخدمها.

إذا كنت تستخدم Bash ، فعدِّل $HOME/.bash_profile أو $HOME/.bashrc. إذا كنت تستخدم Z shell ، فعدِّل $HOME/.zshrc. إذا كنت تستخدم shell مختلفة ، فسيختلف مسار الملف واسمه على جهازك.

  1. أضف السطر التالي وغيّر [PATH_OF_FLUTTER_GIT_DIRECTORY] ليكون مسار الـ Flutter git repo على جهازك (لقد قمت بتجهيز هذا المسار في الخطوة الأولى):

  1. نفذ الأمر source $HOME/.<rc file> لتقوم بعمل refresh للنافذة الحالية للـterminal . أو قم بإغلاق الـ terminal وفتحه من جديد.
  2. تحقق من أن المسار flutter/bin قد تم إضافته إلى الـ Path من خلال الامر التالي:

  1. تحقق من ان الأمر flutter متوفر في الـ terminal الحالية من خلال الأمر التالي:

ملاحظة: اعتبارًا من الإصدار Flutter’s 1.19.0 dev release تحتوي Flutter SDK على أمر dart جنبًا إلى جنب مع أمر flutter بحيث يمكنك تشغيل الـ Dart command-line programs بسهولة أكبر. يؤدي تنزيل Flutter SDK أيضًا إلى تنزيل الإصدار المتوافق من Dart ، ولكن إذا قمت بتنزيل Dart SDK بشكل منفصل ، فتأكد من أن إصدار dart الخاص بـ Flutter يكون أولاً في مسارك ، حيث قد لا يكون الإصداران متوافقين. يخبرك الأمر التالي ما إذا كانت أوامر flutter و dart تنشأ من نفس المجلد bin (وبالتالي فهي متوافقة):

كما هو موضح أعلاه ، لا يأتي الأمران من المجلد bin نفسه. قم بتحديث المسار الخاص بك لاستخدام الأوامر من / path-to-flutter-sdk / bin قبل الأوامر من / usr / local / bin (في هذه الحالة). بعد إغلاق الـ shell الذي تستخدمه وتشغيله مرة أخرى، فإن تشغيل الأمر السابق سيظهر أن أوامر flutter و dart ينشآن من نفس المجلد:

لمعرفة المزيد حول أمر dart ، قم بتشغيل dart -h في الـ terminal، أو راجع صفحة dart tool.

إعداد المنصة (Platform setup):

يدعم macOS تطوير تطبيقات Flutter لأجهزة iOS و Android، وكما يدعم تطوير تطبيقات الويب (technical preview release). أكمل واحدة على الأقل من خطوات الـPlatform setup الآن ، لتتمكن من إنشاء وتشغيل أول تطبيق Flutter.

إعداد المنصة لتطوير تطبيقات iOS:

تثبيت Xcode:

لتطوير تطبيقات Flutter لنظام iOS ، تحتاج إلى جهاز Mac مثبت عليه Xcode.

  1. قم بتثبيت أحدث إصدار مستقر من Xcode (باستخدام الـ web download أو من Mac App Store).
  2. قم بتغيير إعدادات الـ Xcode command-line tools لتستخدم الإصدار المثبت حديثًا من Xcode عن طريق تشغيل الأمرين التاليين:

sudo xcode-select –switch /Applications/Xcode.app/Contents/Developer

sudo xcodebuild -runFirstLaunch

هذا هو المسار الصحيح عندما تريد استخدام أحدث إصدار من Xcode. إذا كنت بحاجة إلى استخدام إصدار مختلف ، فحدد ذلك المسار بدلاً من هذا.

  1. تأكد من توقيع اتفاقية ترخيص Xcode (Xcode license agreemen) إما عن طريق فتح Xcode مرة واحدة و عمل تأكيد على الموافقة أو من خلال تشغيل الأمر sudo xcodebuild -license من الـterminal.

قد تستمر الإصدارات السابقة من Xcode (الأقدم من أحدث إصدار مستقر) في العمل، ولكن لا ينصح بها لتطوير باستخدام Flutter. استخدام الإصدارات القديمة من Xcode لاستهداف bitcode غير مدعوم ومن المحتمل ألا يعمل.

باستخدام Xcode ، ستتمكن من تشغيل تطبيقات Flutter على جهاز iOS أو على المحاكي (simulator).

إعداد الـ iOS simulator:

للاستعداد لتشغيل واختبار تطبيق Flutter على iOS simulator، اتبع الخطوات التالية:

  1. على جهاز Mac الخاص بك ، ابحث عن الـ Simulator عبر Spotlight أو باستخدام الأمر التالي:

  1. تأكد من أن المحاكي لجهاز 64 بت (iPhone 5s أو أحدث) من خلال التحقق من الإعدادات من خلال الضغط على الخيار Device ضمن القائمة Hardware > Device
  2. اعتمادًا على حجم شاشة حاسوبك ، قد يتجاوز حجم شاشة المحاكي ذو كثافة الشاشة العالية حجم شاشتك. اضغط على زاوية جهاز المحاكاة واسحبه لتغيير مقاسه. يمكنك أيضًا باستخدام الخيارات ضمن الـ Pixel Accurate من Window > Physical Size or Window > Pixel Accurateوذلك إذا كانت دقة شاشة حاسوبك عالية بما يكفي.
    1. ملاحظة: إذا كنت تستخدم إصدارًا من Xcode أقدم من 1.9 ، فيجب عليك بدلاً من ذلك ضبط مقياس الجهاز من القائمة Window> Scale.

قم بإنشاء وتشغيل تطبيق Flutter بسيط:

لإنشاء تطبيق Flutter الأول الخاص بك واختبار عملية تثبيت المنصة، اتبع الخطوات التالية:

  1. أنشئ تطبيق Flutter جديد عن طريق تشغيل الأمر التالي ضمن الـ terminal:

  1. يتم إنشاء مجلد my_app يحتوي على تطبيق Flutter جديد. أدخل هذا المجلد:

  1. لتشغيل التطبيق في الـ Simulator ، تأكد من تشغيل الـ Simulator واكتب في الـ terminal:

شغل تطبيق Flutter على جهاز فعلي يعمل بنظام iOS:

لتشغيل تطبيق Flutter على جهاز iOS فعلي ، ستحتاج إلى إعداد الـ physical device deployment في Xcode كما ستحتاج حساب Apple Developer. إذا كان تطبيقك يستخدم Flutter plugins، فستحتاج أيضًا إلى third-party CocoaPods dependency manager.

  1. يمكنك تخطي هذه الخطوة إذا كانت تطبيقاتك لا تعتمد على Flutter plugins ضمن كود iOS الأصلي. قم بتثبيت وإعداد CocoaPods عن طريق تشغيل الأوامر التالية:

ملاحظة: الإصدار الافتراضي من Ruby يتطلب sudo لتثبيت CocoaPods gem. إذا كنت تستخدم Ruby Version manager ، فقد تحتاج إلى تشغيل الامر السابق بدون sudo.

  1. قم باتباع الـ Xcode signing flow لكي تقوم بعمل provision لمشروعك:
    1. افتح الـdefault Xcode workspace في مشروعك عن طريق تشغيل الأمر open ios/Runner.xcworkspace ضمن الـ terminal المفتوح في مجلد مشروع Flutterالحالي.
    2. حدد الجهاز الذي تنوي تشغيل التطبيق عليه من خلال القائمة المنسدلة للأجهزة (device drop-down menu) الموجودة بجوار زر التشغيل Run.
    3. حدد مشروع Runner في الـ navigation panel اليسرى.
    4. في صفحة إعدادات الـ Runner target ، تأكد من تحديد الـ Development Team الخاص بك ضمن القائمة Signing & Capabilities > Team.

عند تحديد team، يقوم Xcode بإنشاء وتنزيل Development Certificate، ويسجل جهازك في حسابك (registers your device with your account)، ويقوم بإنشاء وتنزيل ملف provisioning profile (إذا لزم الأمر).

      • لبدء مشروعك الأول لتطوير تطبيقات iOS ، قد تحتاج إلى تسجيل الدخول إلى Xcode باستخدام الـ Apple ID الخاص بك.

Xcode account add

التطوير والاختبار مدعومان لأي Apple ID. التسجيل في برنامج Apple Developer مطلوب لرفع تطبيقك على App Store. للحصول على تفاصيل حول أنواع العضويات (membership types) ، راجع اختيار العضوية.

      • في المرة الأولى التي تستخدم فيها جهازًا فعلياً متصلًا لتطوير تطبيقات iOS ، يجب أن تثق بكل من جهاز Mac الخاص بك وشهادة التطوير (Development Certificate) على هذا الجهاز. حدد الخيار “Trust” في مربع الحوار عند توصيل جهاز iOS بجهاز Mac الخاص بك لأول مرة.

Trust Mac

بعد ذلك ، انتقل إلى تطبيق الإعدادات على جهاز iOS ، واختر General > Device Management وثق في الـ Certificate الخاصة بك. بالنسبة للمستخدمين الذين يقومون بهذا الشيء لأول مرة ، قد تحتاجون إلى اختيار General > Profiles > Device Management بدلاً من ذلك.

      • إذا فشل الـ automatic signing في Xcode ، فتحقق من أن قيمة معرف الحزمة الـ General > Identity > Bundle Identifier الخاصة بمشروعك فريدة(unique).

Check the app's Bundle ID

  1. شغل تطبيقك عن طريق تشغيل الأمر flutter run أو النقر فوق الزر Run في Xcode

إعداد المنصة لتطوير تطبيقات Android:

ملاحظة: تعتمد Flutter على التثبيت الكامل لـ Android Studio لتوفير تبعيات نظام Android الأساسي (Android platform dependencies). ومع ذلك ، يمكنك كتابة تطبيقات Flutter الخاصة بك في عدد من المحررات الأخرى، وسنناقش هذه المسألة في فقرة لاحقة.

تثبيت Android Studio:

  1. قم بتنزيل وتثبيت Android Studio.
  2. قم بتشغيل Android Studio ، وانتقل إلى ‘Android Studio Setup Wizard’. يقوم هذا بتثبيت أحدث ‘Android SDK’ ، و’Android SDK Command-line Tools’ ،و ‘ Android SDK Build-Tools’ ، والتي تتطلبها Flutter عند التطوير لنظام Android.

قم بإعداد جهاز Android الخاص بك:

للاستعداد لتشغيل واختبار تطبيق Flutter على جهاز Android ، تحتاج إلى جهاز Android يعمل بنظام Android 4.1 (مستوى API 16) أو أعلى.

ولتشغيل واختبار تطبيق Flutter على جهاز Android قم بما يلي:

  1. قم بتمكين خيارات المطور (Enable Developer options) وتصحيح أخطاء USB (USB debugging) على جهازك. التعليمات التفصيلية للقيام بذلك متوفرة ضمن توثيق Android.
  2. قم بتوصيل هاتفك بالكمبيوتر باستخدام كبلUSB ، وامنح الكمبيوتر السماح بالوصول إلى جهازك إذا طُلب منك ذلك.
  3. ضمن محرر الاوامر قم بتنفيذ الامر التالي flutter devices، يقوم هذا الامر بالتحقق ما إذا تم التعرف على جهاز الاندرويد المتصل بالحاسوب كجهاز جاهز لاخبتار التطبيقات عليه أم لا.

ملاحظة: بشكل افتراضي ، تستخدم Flutter إصدار Android SDK حيث توجد أداة adb الخاصة بك. إذا كنت تريد من Flutter استخدام Android SDK مختلف، فيجب عليك تعيين متغير بيئة ANDROID_SDK_ROOT تكون قيمته دليل Android SDK المختلف الذي تريده.

قم بإعداد محاكي لجهاز Android :

للاستعداد لتشغيل واختبار تطبيق Flutter على محاكي Android ، اتبع الخطوات التالية:

  1. قم بتمكين VM acceleration على جهازك.
  2. قم بتشغيل Android Studio ، وانقر فوق رمز AVD Manager ، واختر إنشاء جهاز افتراضي (Create Virtual Device) …
    1. في الإصدارات القديمة من Android Studio ، يجب عليك بدلاً من ذلك تشغيل Android Studio> Tools> Android> AVD Manager وتحديد إنشاء جهاز افتراضي…. (قائمة Android الفرعية موجودة فقط عندما تكون داخل مشروع Android.).
    2. إذا لم يكن لديك مشروع مفتوح ، يمكنك اختيار Configure> AVD Manager وتحديد إنشاء جهاز افتراضي (Create Virtual Device) …
  3. اختر مواصفات الجهاز واضغط التالي.
  4. حدد system image واحدة أو أكثر لإصدارات Android التي تريد محاكاتها ، واضغط التالي. يوصى باستخدام x86 أو x86_64 image.
  5. ضمن الخيار Emulated Performance ، اختر Hardware – GLES 2.0 لتمكين خاصيةhardware acceleration.
  6. تحقق لمرة أخيرة من أنك اخترت الخيارات الصحيحة لإعداد المحاكي ، ثم اضغط إنهاء.

للحصول على تفاصيل حول الخطوات المذكورة أعلاه ، راجع Managing AVDs.

  1. في Android Virtual Device Manager ، انقر فوق تشغيل (Run) في شريط الأدوات. يبدأ المحاكي في العمل ويعرض الشاشة الافتراضية لإصدار نظام التشغيل والجهاز الذي اخترته.

إعداد المنصة لتطوير تطبيقات الـ Web:

تحتوي Flutter على دعم لإنشاء تطبيقات الويب في الـ stable channel. يتم بناء أي تطبيق تم إنشاؤه في Flutter 2 للويب تلقائيًا. لإضافة دعم الويب إلى تطبيق موجود ، اتبع الإرشادات المتعلقة بإنشاء تطبيق ويب باستخدام Flutter عند الانتهاء من الإعدادات المذكورة أعلاه.

الخطوات الواجب تنفيذها بعد تثبيت المنصة:

قم بتثبيت المحرر المفضل لديك لتقوم بتطوير التطبيقات باستخدام منصة Flutter من خلاله.

اترك تعليقًا

لن يتم نشر عنوان بريدك الإلكتروني. الحقول الإلزامية مشار إليها بـ *

arAR