الصفحة الرئيسية>موارد بناء الموقع>موارد أخرى
تنزيل

Micro: Bit Target for PXT

PXT-Microbit هو هدف أدوات Microsoft Experience Tower (PXT) يتيح لك برمجة Micro: BBC Micro: bit.

  • pxt-microbit beta ، v3.0.* يتطلب

    • pxt-microbit#مستقر 3.0
    • PXT#مستقر 6.0.
    • pxt-common packages#stable6.0.

  • يتطلب pxt-microbit v2.0.* ، فرع stable2.0 ، pxt v5.15.*. إنه فرع الخدمة للمحرر المباشر.

  • يتطلب pxt-microbit v1.* pxt V4.4 ، والذي يوجد حاليًا في فرع PXT مستقر.

  • pxt-microbit v0.* في فرع V0 من هذا المستودع

  • جربها على الهواء مباشرة

قضية تتبع

الرجاء إضافة مشكلة إذا اكتشفت خطأ (غير مُبلغ).

تطوير ملحقات جديدة

يمكن إجراء تأليف واختبار ملحقات جديدة مباشرة من محرر الويب. انظر وثائقنا حول كيفية البدء. إذا كنت ترغب في تشغيل المحرر محليًا ، فاستمر في القراءة.

إعداد الخادم المحلي

يتيح لك الخادم المحلي تشغيل المحرر وخدمة الوثائق من جهاز الكمبيوتر الخاص بك. إنه مخصص لمطور واحد يستخدم وغير مصمم لخدمة المحرر لكمية كبيرة من المستخدمين.

  1. تثبيت node.js 8.9.4 أو أعلى.
  2. استنساخ هذا المستودع. 
 git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit
  1. قم بتثبيت سطر أوامر PXT (إضافة sudo لقذائف Mac/Linux). 
 npm install -g pxt
  1. تثبيت تبعيات pxt-microbit. 
 npm install

انتقل إلى قسم الجري .

إعداد المطور

هذا هو الإعداد النموذجي الذي يستخدمه فريق Makecode للعمل على الميكروبيت.

  1. تثبيت node.js 8.9.4 أو أعلى.
  2. قم بتثبيت Docker إذا كنت تخطط لإنشاء ملفات .cpp .
  3. استنساخ مستودع PXT. 
 git clone https://github.com/microsoft/pxt
cd pxt
  1. تثبيت تبعيات PXT وإنشائها 
 npm install
npm run build
cd ..
  1. استنساخ مستودع حزم PXT-Common 
 git clone https://github.com/microsoft/pxt-common-packages
cd pxt-common-packages
npm install
  1. ربط حزم PXT-Common إلى PXT 
 npm link ../pxt
cd ..
  1. استنساخ هذا المستودع. 
 git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit
  1. قم بتثبيت سطر أوامر PXT (إضافة sudo لقذائف Mac/Linux). 
 npm install -g pxt
  1. تثبيت تبعيات pxt-microbit. 
 npm install
  1. ارتباط pxt-microbit مرة أخرى إلى قاعدة pxt base (إضافة sudo لقذائف mac/linux). هذه الخطوة مطلوبة فقط إذا كنت تنوي إجراء تغييرات على PXT و/أو PXT-Common Packages Repos. إذا كان كل ما تريده هو خدمة makececode المحلية ، فيمكنك تخطي هذه الخطوة. 
 npm link ../pxt ../pxt-common-packages

لاحظ أن الأمر أعلاه يفترض بنية المجلد من 

       makecode
          |
  ----------------------------------
  |       |                        |
 pxt      pxt-common-packages  pxt-microbit

جري

قم بتشغيل هذا الأمر من Inside PXT-Microbit لفتح خادم ويب محلي 

 pxt serve

إذا فتح الخادم المحلي في المتصفح الخطأ ، فتأكد من نسخ عنوان URL الذي يحتوي على الرمز المميز المحلي. خلاف ذلك ، لن يتمكن المحرر من تحميل المشاريع.

إذا كنت بحاجة إلى تعديل ملفات .cpp (وقمت بتثبيت yotta) ، قم بتمكين تجميع Yotta باستخدام علم --localbuild : 

 pxt serve --local

إذا كنت ترغب في تسريع البناء ، فيمكنك استخدام خيار rebundle ، الذي يتخطى البناء ويقوم ببساطة بتحديث المعلومات المستهدفة 

 pxt serve --rebundle

تنظيف

في بعض الأحيان ، قد يكون المجلد المبني في حالة سيئة ، وتنظيفه وحاول مرة أخرى. 

 pxt clean

بناء مع كود محلي

الأوامر التالية تجبر بناء محلي باستخدام Codal. 

 pxt buildtarget --local

لتعطيل Docker ، قم بالتشغيل 

 export PXT_NODOCKER=1

إذا كنت تعدل أيضًا برمجية ، ففكر في تشغيل pxt clean لضمان التقاط الفرع المناسب.

تعديل DAL/codal محليا

  • اتبع التعليمات أعلاه حتى pxt serve
  • محرر مفتوح على مضيف محلي وإنشاء مشروع
  • هل export PXT_FORCE_LOCAL=1 PXT_RUNTIME_DEV=1 PXT_ASMDEBUG=1 ؛ يمكنك إضافة PXT_NODOCKER=1 ؛ pxt help لديها مساعدة في هذه
  • ابحث عن مجلد المشروع ضمن pxt-microbit/projects pxt-microbit/projects/Untitled-42
  • إذا كنت ستقوم بتعديل ملفات .cpp في pxt ، استبدل "core": "*" في pxt.json مع "core": "file:../../libs/core" ؛ وبالمثل "radio": "file:../../libs/radio" و "microphone": "file:../../libs/microphone"
  • يمكنك تحرير main.ts لتغيير الجانب PXT من البرنامج ؛ يمكنك أيضًا تحريره من محرر المضيف المحلي ؛ لاحظ أن Download في محرر LocalHost سيؤدي إلى إنتاج ثنائي مختلف عن سطر الأوامر ، حيث أنه يبني في السحابة ويستخدم الإصدار الموسومة من Codal
  • في هذا المجلد تشغيل pxt build - سيستنسخ هذا الترميز في مكان ما تحت built/ (يعتمد على بناء محرك و Docker)
  • يمكن أن تكون هناك مشكلة في تصدير المتغيرات IE PXT_Force ، لذلك يمكن أن يساعد تضمينها في أمر build في حل المشكلات sudo PXT_NODOCKER=1 PXT_ASMDEBUG=1 PXT_RUNTIME_DEV=1 PXT_DEBUG=1 PXT_FORCE_LOCAL=1 PXT_COMPILE_SWITCHES=csv---mbcodal pxt build
  • إذا لم يتم إنشاء الهدف ، فاحذف الملفات في hexcache الموجودة في pxt-microbit/built/hexcache لإجبار البناء المحلي
  • يمكن العثور binary.hex سداسي بنيت في pxt-microbit/projects/<your project name>/built
  • وبالمثل ، يمكنك تشغيل pxt deploy (أو فقط pxt وهو نفسه) - سيتم إنشاءه ونسخه إلى MICROBIT Drive
  • على افتراض أن مجلد الإنشاء تحت built/codal ، انتقل إلى built/codal/libraries و Run code *
  • في علامة تبويب GIT ، الخروج من الفروع المناسبة (كلها في حالة رأس منفصلة إلى الطريقة التي نضع بها علامات على الإصدارات)
  • تعديل الملفات ، تشغيل pxt ، انظر التأثيرات
  • يمكنك أيضًا تشغيل pxt gdb للتصحيح ؛ هذا يتطلب openocd
  • الأوامر الأخرى التي تستخدم openocd هي pxt dmesg التي تتفصل عن DMESG(...) HUMPER و pxt heap التي يمكن استخدامها لتصور كومة PXT (وواحد Codal إلى حد ما)

تحديث dal.d.ts 

 cd libs/blocksprj
rm -rf built
PXT_FORCE_LOCAL=1 PXT_COMPILE_SWITCHES=csv---mbcodal pxt build
PXT_FORCE_LOCAL=1 PXT_COMPILE_SWITCHES=csv---mbcodal pxt builddaldts
mv dal.d.ts ../core

التحديثات

تأكد من سحب التغييرات من جميع عمليات إعادة التجميع بانتظام. المزيد من التعليمات موجودة في https://github.com/microsoft/pxt#running-a-target-from-localhost

تحديث قوائم التشغيل في Markdown

لإضافة قائمة تشغيل جديدة ، أضف إدخالًا في /playlists.json ، وقم بتجديد التخفيض (انظر الفقرة أدناه). سيكون لديك الآن ملف معرض Markdown جديد يسرد مقاطع الفيديو التي يمكنك الرجوع إليها في /targetconfig.json .

احصل على مفتاح Google API وقم بتخزينه في متغيرات بيئة GOOGLE_API_KEY (قم بتشغيل البيانات من التطبيق). 

 pxt downloadplaylists

repos

يعتمد هدف pxt-microbit على العديد من عمليات إعادة الشراء الأخرى. الرئيسية هي:

  • https://github.com/microsoft/pxt ، إطار عمل PXT
  • https://github.com/microsoft/pxt-common-packages ، واجهات برمجة التطبيقات الشائعة تراكم مختلف محرري makecode
  • https://github.com/lancaster-university/microbit ، غلاف أساسي حول الدال
  • https://github.com/lancaster-university/microbit-dal

تاريخ

انظر مدونة MakeCode.

مدونة لقواعد السلوك

اعتمد هذا المشروع رمز سلوك المصدر المفتوح Microsoft. لمزيد من المعلومات ، راجع مدونة الشهادة الأسئلة الشائعة أو الاتصال بـ [email protected] مع أي أسئلة أو تعليقات إضافية.

علامات تجارية

Microsoft و Microsoft Logo و Makecode هي علامات تجارية مسجلة لشركة Microsoft Corporation. لا يمكن استخدامها إلا للأغراض الموضحة في الإرشادات التجارية والعلامة التجارية الخاصة بـ Microsoft المنشورة على https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. إذا لم يتم تغطية الاستخدام في الإرشادات المنشورة لـ Microsoft أو لم تكن متأكدًا ، فيرجى استشارة مستشارك القانوني أو فريق Makecode ([email protected]).

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل