يحتوي هذا الريبو على محرر Arcade الذي تم تصميمه باستخدام Microsoft MakeCode (PXT).
في المحرر ، ستجد أيقونة github بجوار أيقونة حفظ. استخدم تكامل GitHub لإنشاء حزمة مكتبة. لا تحتاج إلى تثبيت خادم DEV المحلي ؛ كل شيء يمكن أن يحدث في المحرر.
يمنحك هذا الإعداد إصدارًا محليًا من المحرر والقدرة على تحميل الحزم من جهازك. هذا هو الإعداد لتطوير حزم جديدة.
pxt-arcade
. على سبيل المثال ، من باش غيت git clone https://github.com/microsoft/pxt-arcade
pxt-arcade
وركض cd pxt-arcade
npm install
لا تنسى أن git pull
npm install
بشكل دوري للحصول على أحدث التغييرات.
git pull
npm install
يقوم هذا الأمر بتشغيل خادم ويب محلي. لاحظ أن خادم الويب هذا مخصص لأغراض التطوير فقط. لم يتم تصميمه أو تأمينه ليتم تشغيله على خادم ويب.
npm run serve
قم بتشغيل هذا الأمر ، ثم تصحيح الوصف ، وتحسين لقطة الشاشة (أو تسجيل صور GIF) إذا لزم الأمر.
pxt ddt featured-game --md docs/community.md
يتطلب هذا الأمر ImageMagick (https://imagemagick.org/index.php) لتثبيته ومتاح في سطر الأوامر باسم "Magick".
عند تغيير إصدار PXT-ARCADE-SIM الذي يشير إليه PXT-ARCADE ، تحتاج إلى تغيير الإصدار في ثلاثة أماكن:
package.json
.github/workflows/pxt-buildmain.yml
.github/workflows/pxt-buildpush.yml
في ملفين YML ، ستجد الإصدار في حقل ref
تحت الخطوة التي تتحقق من PXT-ARCADE-SIM.
احصل على مفتاح Google API وقم بتخزينه في متغيرات بيئة GOOGLE_API_KEY
(قم بتشغيل البيانات من التطبيق).
pxt downloadplaylists
يمكن إضافة حزم من الصور إلى المحرر باستخدام حزم PXT. لإنشاء مجموعة من الصور.
meta.json
في الدليل الذي أنشأته. مثال على ذلك يمكن الاطلاع على meta.json
هنا ويمكن العثور على وثائق حول جميع الخيارات هنا.json
آخر مع نفس الاسم الأساسي مثل spriteshet.frames
التي تقوم بتعيين مجموعة من الأسماء للعفاريت. تبدأ المؤشرات في أعلى اليسار من الورقة وتابع اليسار إلى اليمين. للحصول على عينة ، انظر هناpxt buildsprites SUBDIR
حيث يكون SUBDIR
هو اسم الدليل الذي يحتوي على الأصول..ts
وواحد مع امتداد .jres
. أضف كلاهما إلى pxt.json
الخاص بالحزمةتتيح لك هذه التعليمات اختبار التغييرات على حزم PXT-Core و PXT-Common. إنهم أكثر انخراطًا كما تحتاج إلى استنساخ وربط 3 Repos.
setup.cmd /firsttime
يجب أن تقوم هذه المكالمة تلقائيًا بالخطوات الموضحة في الإعداد اليدوي وسوف تستنسخ وربط جميع عمليات إعادة الشراء الثلاثة.
[sudo] npm install -g pxt
في مجلد مشترك ،
pxt
pxt-common-packages
pxt-arcade
pxt
وركض npm install
npm run build
pxt-common-packages
و Run npm install
npm link ../pxt
pxt-arcade
وركض npm install
npm link ../pxt
npm link ../pxt-common-packages
من مجلد الجذر github ،
cd pxt-arcade
pxt serve --rebundle
المزيد من التعليمات في https://github.com/microsoft/pxt#running-a-target-from-localhost
لإعادة البناء تلقائيًا عند إجراء التغييرات ، نحتاج إلى Gulp.
تثبيت Gulp:
npm install -g gulp
وفي محطة منفصلة من pxt serve
وفي مجلد PXT/ المجلد ، قم بتشغيل:
gulp watch
بدلاً من الاضطرار إلى الانتقال إلى كل ريبو ، اسحب وربط كل واحد بشكل فردي ، يمكنك الآن استخدام ملف setup.cmd
. تم تحديد الاستخدام على النحو التالي مع هذه الخيارات:
/firsttime
Engles Environment-Will Clone 3 REPOS (PXT و PXT-ARCADE و PXT-Common-Packages) ثم قم بتشغيل /خيار الرابط
/pull
يقوم بسحب git على 3 repos (pxt و pxt-arcade و pxt-common packages)
/link
يعمل على تثبيت NPM وربط 3 repos
/run
تشغيل الخادم المحلي والساعات للتغييرات باستخدام Gulp
يتم تقديم المستندات في الخادم ويمكن عرضها عند استلامها من قبل المتصفح. يتم استخدام أنماط خاصة والتنسيق الممتد والتي تمنعهم من تقديمها بشكل صحيح على أنها تخفيض معممة. على الرغم من أنه يمكنك تصفحها هنا في الريبو ، إلا أنها لا تهدف إلى تقديمها بشكل صحيح كوثيقة Github.
اعتمد هذا المشروع رمز سلوك المصدر المفتوح Microsoft. لمزيد من المعلومات ، راجع مدونة الشهادة الأسئلة الشائعة أو الاتصال بـ [email protected] مع أي أسئلة أو تعليقات إضافية.
Microsoft و Microsoft Logo و MakeCode و Makecode Arcade هي علامات تجارية مسجلة لشركة Microsoft Corporation. لا يمكن استخدامها إلا للأغراض الموضحة في الإرشادات التجارية والعلامة التجارية الخاصة بـ Microsoft المنشورة على https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. إذا لم يتم تغطية الاستخدام في الإرشادات المنشورة لـ Microsoft أو لم تكن متأكدًا ، فيرجى استشارة مستشارك القانوني أو فريق Makecode ([email protected]).