التثبيت على Windows

فلنبدأ:

تثبيت منصة Flutter:

حدد نظام التشغيل الذي تريد أن تقوم بتثبيت منصة Flutter  عليه:

نظام تشغيل Windows.

نظام تشغيل macOS.

نظام تشغيل Linux.

نظام تشغيل Chrome OS.

 

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

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

  • متطلبات النظام.
  • احصل على Flutter SDK .
    • قم بتحديث المسار path.
    • قم بتشغيل التعليمة التالية flutter doctor ضمن محرر الاوامر.
  •  إعداد المنصة لتطوير تطبيقات Android
    • قم بتثبيت Android Studio
    • قم بإعداد جهاز Android الخاص بك
    • قم بإعداد محاكي لجهاز Android
  • إعداد المنصة لتطوير تطبيقات الويب
  • الخطوات الواجب تنفيذها بعد تثبيت المنصة.

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

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

  • نظام تشغيل Windows 7 SP1 أو أحدث (64 بت أو مستند إلى x86-64).
  • مساحة خالية على القرص: 1.64 جيجا بايت ( هذا لا يشمل مساحة القرص المطلوبة لتثبيت الـ IDE والأدوات الأخرى التي ستذكر في البند التالي).
  • الأدوات: تعتمد Flutter على توفر هذه الأدوات في بيئتك:
    • Windows PowerShell 5.0 أو أحدث (يكون مثبت مسبقًا مع Windows 10).
    • Git for Windowsx: مع خيار (Use Git from the Windows Command Prompt)

إذا كانت Git for Windows مثبتة بالفعل ، فتأكد من أنه يمكنك تشغيل أوامر git من موجه الأوامر أو PowerShell.

احصل على Flutter SDK:

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

 

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

  • قم باستخراج الملف المضغوط ووضع مجلد Flutter في مسار التثبيت المطلوب (مثلا C:\src\flutter).

تحذير: لا تقم بتثبيت Flutter في مسار مثل C: \ Program Files \ الذي يتطلب سماحيات وصول(privileges) عالية.

إذا كنت لا ترغب في تثبيت إصدار ثابت من حزمة التثبيت  المذكورة أعلاه، فيمكنك تخطي الخطوتين 1 و 2. وبدلاً من ذلك ، احصل على شيفرة المصدر (source code) من Flutter repo على GitHub ، وقم بتغيير الفروع (branches) أو العلامات (tags) حسب الحاجة. علي سبيل المثال، إذهب للمسار  C:/src وقم بتنفيذ التعليمة التالية:

git clone https://github.com/flutter/flutter.git -b stable

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

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

إذا كنت ترغب في تشغيل أوامر Flutter في محرر أوامر ويندوز العادية (cmd) ، فاتبع هذه الخطوات لإضافة Flutter إلى متغير البيئة  PATH:

  • من شريط البحث الظاهر في قائمة إبدأ، أدخل كلمة “env” واختر النتيجة التالية “تعديل متغيرات البيئة لحسابك”.
  • ضمن الـUser variables تحقق مما إذا كان هناك خيار يسمى Path:
    • إذا كان الخيار موجودًا، فقم بإضافة فاصلة منقوطة بعد القيم الموجودة أساسا، ثم قم بإضافة المسار الكامل لمجلد flutter\bin . على سبيل المثال: (;C:\src\flutter\bin).
    • إذا لم يكن الخيار موجوداً، فقم بإنشاء user variable جديد يسمى Path وأسند المسار الكامل للمجلد flutter\bin كقيمة له.
  • يجب عليك إغلاق أي محرر أوامر cmd مفتوح، ثم عليك أن تشغل محرر الاوامر من جديد حتى تصبح هذه التغييرات سارية المفعول.

ملاحظة: يخبرك الأمر التالي ما إذا كانت أوامر flutter و dart تنشأ من نفس المجلد bin (ما يعني أنهما متوافقان):

where flutter dart

إذا ظهرت لك النتيجة التالية:

C:\path-to-flutter-sdk\bin\flutter

C:\path-to-flutter-sdk\bin\flutter.bat

C:\path-to-dart-sdk\bin\dart.exe        :: this should go after `C:\path-to-flutter-sdk\bin\` commands

C:\path-to-flutter-sdk\bin\dart

C:\path-to-flutter-sdk\bin\dart.bat

كما هو موضح أعلاه فإن الأمرين flutter و dart غير موجودين في نفس المسار. ولحل هذه المشكلة عليك تحديث المسار الخاص ب dart لكي يظهر في نفس مسار flutter . بعد اجراء التغييرات المناسبة وإغلاق محرر  أوامر cmd وتشغيله من جديد وتنفيذ الأمر السابق where flutter dart فالنتيجة يجب أن تظهر بشكل مشابه لما يلي:

where flutter dart

C:\dev\src\flutter\bin\flutter

C:\dev\src\flutter\bin\flutter.bat

C:\dev\src\flutter\bin\dart

C:\dev\src\flutter\bin\dart.bat

C:\dev\src\dart-sdk\bin\dart.exe

ولكن إذا كنت تستخدم PowerShell فإن عليك أن تستخدم الامر التالي:

where.exe flutter dart

لمعرفة المزيد حول الأمر dart ، قم بكتابة dart -h  ضمن محرر الأوامر ، أو راجع صفحة أداة  dart.

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

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

C:\src\flutter>flutter doctor

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

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

[-] Android toolchain – develop for Android devices

  • Android SDK at D:\Android\sdk

✗ Android SDK is missing command line tools; download from https://goo.gl/XxQghQ

  • Try re-installing or updating your Android SDK,

visit https://flutter.dev/setup/#android-setup for detailed instructions.

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

ملاحظة: إذا ظهر لك ضمن نتيجة التعليمة السابقة أن (Flutter plugin or Dart plugin of Android Studio are not installed) فيمكنك حل المشكلة من خلال اتباع التعليمات الموجودة ضمن التوثيق تحت عنوان “قم بإعداد المحرر” (Set up an editor).

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

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

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

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

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

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

تثبيت Android Studio:

  • قم بتنزيل وتثبيتAndroid Studio من الرابط التالي (https://developer.android.com/studio) .
  • قم بتشغيل 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 قم بما يلي:

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

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

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

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

  • قم بتمكين VM acceleration على جهازك.
  • قم بتشغيل 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) …
  • اختر مواصفات الجهاز واضغط التالي.
  • حدد system image واحدة أو أكثر لإصدارات Android التي تريد محاكاتها ، واضغط التالي. يوصى باستخدام x86 أو  x86_64 system image.
  • ضمن الخيار Emulated Performance ، اختر Hardware – GLES 2.0 لتمكين خاصية hardware acceleration.
  • تحقق لمرة أخيرة من أنك اخترت الخيارات الصحيحة لإعداد المحاكي ، ثم اضغط إنهاء.

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

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

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

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

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

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

اترك تعليقًا

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

arAR