pxt

مايكروسوفت ماك كود

• جرب المحررين في متصفحك...

يعتمد Microsoft MakeCode على مشروع مفتوح المصدر لمجموعة أدوات تجربة برمجة Microsoft (PXT). Microsoft MakeCode هو الاسم الموجود في برامج التحرير التي تواجه المستخدم، ويتم استخدام PXT في جميع مصادر GitHub.

PXT هو إطار عمل لإنشاء تجارب برمجة ذات أغراض خاصة للمبتدئين، ويركز بشكل خاص على تعليم علوم الكمبيوتر. لغة البرمجة الأساسية لـ PXT هي مجموعة فرعية من TypeScript (مع ترك ميزات JavaScript الديناميكية).

الملامح الرئيسية لPXT هي:

• محرر تعليمات برمجية مبني على Blockly مع محول إلى تنسيق النص
• محرر أكواد Monaco الذي يقوم بتشغيل VS Code، ميزات المحرر مدرجة هنا.
• دعم القابلية للتوسعة لتحديد كتل جديدة في TypeScript
• باعث رمز آلة الإبهام ARM
• مدير حزم سطر الأوامر

مزيد من المعلومات:

• عن
• التوثيق

أمثلة على المحررين الذين تم تصميمهم باستخدام MakeCode:

• https://makecode.microbit.org
• https://arcade.makecode.com
• https://makecode.adafruit.com
• https://minecraft.makecode.com
• https://makecode.mindstorms.com
• https://makecode.chibitronics.com
• المزيد من المحررين على https://makecode.com/labs

الفروع

• master هو فرع التطوير النشط، وهو حاليًا إصدار v3.*
• v* هو فرع الخدمة للإصدارات v*.*

تشغيل هدف من المضيف المحلي

يرجى اتباع التعليمات هنا.

ربط الهدف بـ PXT

إذا كنت تقوم بتعديل مثيل PXT الخاص بك وتريد أن يستخدم هدف (مثل pxt-microbit) الإصدار المحلي الخاص بك، فقم بإدخال القرص المضغوط إلى دليل الهدف (pxt-microbit، في مثالنا، والذي يجب أن يكون دليلًا شقيقًا لـ pxt ) وأداء

 pxt link ../pxt

إذا كان لديك عمليات سحب متعددة لـ pxt، فيمكنك القيام بما يلي:

• قم بتشغيل npm i في pxt والهدف
• في الهدف، قم بتشغيل pxt link ..some-other-pxt (قد تحتاج إلى تحديث واجهة سطر الأوامر الخاصة بك أولاً عن طريق تشغيل npm install -g pxt )

إذا قمت بتشغيل npm i بعد ذلك (إما في الهدف أو pxt)، فقد تحتاج إلى تكرار هذه الخطوات.

يبني

أولاً، قم بتثبيت Node: الحد الأدنى للإصدار 8.

لإنشاء أدوات سطر أوامر PXT:

 npm install
npm run build

ثم قم بتثبيت أداة سطر الأوامر pxt (تحتاج إلى القيام بذلك مرة واحدة فقط):

 npm install -g pxt

ثم قم بتثبيت gulp (تحتاج إلى القيام بذلك مرة واحدة فقط):

 npm install -g gulp

بعد ذلك يمكنك تشغيل pxt من أي مكان داخل شجرة البناء.

لبدء خادم الويب المحلي، قم بتشغيل pxt serve من داخل جذر هدف التطبيق (على سبيل المثال، pxt-microbit). سيفتح PXT المحرر في متصفح الويب الافتراضي الخاص بك.

إذا كنت تقوم بالتطوير مقابل pxt، فيمكنك تشغيل gulp watch من داخل جذر مستودع pxt لمراقبة التغييرات وإعادة البناء.

 gulp watch

إذا كنت تعمل على CLI حصريًا،

 gulp watchCli

إذا لم تكن بحاجة إلى إنشاء مجموعة من تطبيقات الويب المرتبطة (خريطة المهارات، أو اللعب الجماعي، وما إلى ذلك)، فيمكنك تخطيها وتسريع عملية الإنشاء قليلاً:

 gulp --no-webapps

أيقونات

يوجد عدد من الرموز المخصصة (لاستخدامها بالإضافة إلى http://semantic-ui.com/elements/icon.html) في دليل svgicons/ . هذه يجب أن تكون 1000x1000px . من الأفضل أن تبدأ بواحدة موجودة. لرؤية الرموز المتاحة، انتقل إلى http://localhost:3232/icons.html (يتم إنشاء هذا الملف، بالإضافة إلى icons.css الذي يحتوي على خط رمز WOFF الذي تم إنشاؤه، أثناء الإنشاء).

إذا كنت تواجه مشكلة في عرض الرمز الذي قمت بإنشائه، فجرّب ما يلي:

 npm install -g svgo
svgo svgicons/myicon.svg

التصميم المشترك

عند إضافة لون CSS أو عنصر نمط آخر سيتم مشاركته عبر أهداف المحرر (مثل micro:bit وArcade) والتطبيقات الفرعية (المعروفة أيضًا باسم "CRAs"، مثل Skillmap و teachertool وما إلى ذلك). قم بتعريف متغير CSS له في theme/themepacks.less :

1. أضف المتغير الجديد إلى الفئة الزائفة :root . اختر قيمة افتراضية معقولة وفقًا للإرشادات الموجودة في الملف.
2. أضف المتغير الجديد إلى كافة فئات السمات المحددة في هذا الملف. في وقت كتابة هذه السطور، تم تحديد theme-highcontrast فقط. اختر قيمة تعمل بشكل جيد للموضوع المحدد.
3. أضف المتغير الجديد إلى تجاوزات السمة لكل هدف. سيتم ذلك في ملف theme/themepacks.less الخاص بمستودع الريبو المستهدف (على سبيل المثال pxt-microbit، pxt-arcade).

ستكون المتغيرات المعلنة بهذه الطريقة متاحة لـ CRAs في وقت التشغيل، وستتم تهيئتها بقيم التجاوز المحددة بواسطة الهدف الذي تعمل فيه.

تسليط الضوء على التوثيق

في الوثائق، يستخدم تمييز مقتطفات التعليمات البرمجية Highlight.js (hljs). حاليا، يتم تضمين اللغات التالية:

• تايب سكريبت
• بايثون
• جافا سكريبت
• أتش تي أم أل، أكس أم أل
• تخفيض السعر

إذا كنت بحاجة إلى إضافة لغات أخرى أو تحديث اللغات الموجودة، يمكنك العثور على التوزيع على https://highlightjs.org/download/؛ حدد جميع اللغات التي تريد تضمينها (بما في ذلك اللغات المذكورة أعلاه!)، وقم بتنزيلها وفك ضغطها، وأخيرًا انسخها عبر highlight.pack.js إلى webapp/public/highlight.js/ .

الاختبارات

توجد الاختبارات في tests/ الدليل الفرعي وهي عبارة عن مزيج من اختبارات العقدة والمتصفح. لتنفيذها، قم بتشغيل npm run test:all في الدليل الجذر.

رخصة

رخصة معهد ماساتشوستس للتكنولوجيا

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

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

اتصل بنا

تواصل معنا

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

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