PXT-Microbit adalah target Microsoft Programming Experience Toolkit (PXT) yang memungkinkan Anda memprogram BBC Micro: Bit.
PXT-Microbit Beta , v3.0.* Membutuhkan
PXT-MICROBIT v2.0.* , Cabang stable2.0 , membutuhkan PXT V5.15.*. Ini adalah cabang servis untuk editor langsung.
PXT-MICROBIT v1.* Membutuhkan PXT V4.4, yang saat ini berada di cabang stabil4.4 dari PXT.
PXT-MICROBIT v0.* Ada di cabang V0 dari repositori ini
Cobalah langsung
Harap tambahkan masalah jika Anda menemukan bug (tidak dilaporkan).
Menulis dan menguji ekstensi baru dapat dilakukan langsung dari editor web. Lihat dokumentasi kami tentang cara memulai. Jika Anda ingin menjalankan editor secara lokal, teruslah membaca.
Server lokal memungkinkan Anda menjalankan editor dan melayani dokumentasi dari komputer Anda sendiri. Ini dimaksudkan untuk pengembang tunggal yang digunakan dan tidak dirancang untuk melayani editor kepada sejumlah besar pengguna.
git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit
sudo untuk shell mac/linux). npm install -g pxt
npm install
Pergi ke bagian lari .
Ini adalah pengaturan khas yang digunakan oleh tim MakeCode untuk mengerjakan microbit.
.cpp . git clone https://github.com/microsoft/pxt
cd pxt
npm install
npm run build
cd ..
git clone https://github.com/microsoft/pxt-common-packages
cd pxt-common-packages
npm install
npm link ../pxt
cd ..
git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit
sudo untuk shell mac/linux). npm install -g pxt
npm install
sudo untuk mac/linux shells). Langkah ini hanya diperlukan jika Anda bermaksud melakukan perubahan pada repo PXT dan/atau PXT-Common-Packages. Jika semua yang Anda inginkan adalah melayani MakEcode lokal, Anda dapat melewatkan langkah ini. npm link ../pxt ../pxt-common-packages
Perhatikan perintah di atas mengasumsikan struktur folder
makecode
|
----------------------------------
| | |
pxt pxt-common-packages pxt-microbit
Jalankan perintah ini dari dalam pxt-microbit untuk membuka server web lokal
pxt serve
Jika server lokal terbuka di browser yang salah, pastikan untuk menyalin URL yang berisi token lokal. Kalau tidak, editor tidak akan dapat memuat proyek.
Jika Anda perlu memodifikasi file .cpp (dan telah menginstal yotta), aktifkan kompilasi yotta menggunakan bendera --localbuild :
pxt serve --local
Jika Anda ingin mempercepat build, Anda dapat menggunakan opsi rebundle , yang melewatkan membangun dan hanya menyegarkan informasi target
pxt serve --rebundle
Terkadang, folder yang Anda bangun mungkin dalam keadaan buruk, bersihkan dan coba lagi.
pxt clean
Perintah berikut memaksa bangunan lokal menggunakan Codal.
pxt buildtarget --local
Untuk menonaktifkan Docker, jalankan
export PXT_NODOCKER=1
Jika Anda juga memodifikasi kode, pertimbangkan untuk menjalankan pxt clean untuk memastikan cabang yang tepat diambil.
pxt serveexport PXT_FORCE_LOCAL=1 PXT_RUNTIME_DEV=1 PXT_ASMDEBUG=1 ; Anda dapat menambahkan PXT_NODOCKER=1 ; pxt help memiliki bantuan untuk inipxt-microbit/projects , biasanya pxt-microbit/projects/Untitled-42.cpp di pxt, ganti "core": "*" di pxt.json dengan "core": "file:../../libs/core" ; Demikian pula "radio": "file:../../libs/radio" dan "microphone": "file:../../libs/microphone"main.ts untuk mengubah sisi PXT program; Anda juga dapat mengeditnya dari editor LocalHost; Perhatikan bahwa Download di editor localhost akan menghasilkan biner yang berbeda dari baris perintah, karena dibangun di cloud dan menggunakan versi tagged codalpxt build - ini akan mengkloning codal di suatu tempat di bawah built/ (tergantung pada mesin build dan docker)sudo PXT_NODOCKER=1 PXT_ASMDEBUG=1 PXT_RUNTIME_DEV=1 PXT_DEBUG=1 PXT_FORCE_LOCAL=1 PXT_COMPILE_SWITCHES=csv---mbcodal pxt buildhexcache yang ditemukan di pxt-microbit/built/hexcache untuk memaksa build lokalpxt-microbit/projects/<your project name>/built bernama binary.hexpxt deploy (atau hanya pxt yang sama) - itu akan membangun dan menyalin ke drive MICROBITbuilt/codal , buka built/codal/libraries dan jalankan code *pxt , Lihat Efekpxt gdb untuk men -debug; Ini membutuhkan openocdopenocd adalah pxt dmesg yang membuang buffer DMESG(...) dan pxt heap yang dapat digunakan untuk memvisualisasikan heap pxt (dan codal satu sampai batas tertentu) 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
Pastikan untuk menarik perubahan dari semua repo secara teratur. Instruksi lebih lanjut di https://github.com/microsoft/pxt#running-a-target-from-localhost
Untuk menambahkan daftar putar baru, tambahkan entri di /playlists.json , dan meregenerasi markdown (lihat paragraf di bawah). Sekarang Anda akan memiliki file Galeri Markdown baru yang mencantumkan video yang dapat Anda referensi di /targetconfig.json .
Dapatkan kunci Google API dan simpan di variabel lingkungan GOOGLE_API_KEY (nyalakan data dari aplikasi).
pxt downloadplaylists
Target PXT-Microbit tergantung pada beberapa repo lainnya. Yang utama adalah:
Lihat blog MakeCode.
Proyek ini telah mengadopsi kode perilaku open source Microsoft. Untuk informasi lebih lanjut, lihat FAQ Kode Perilaku atau hubungi [email protected] dengan pertanyaan atau komentar tambahan.
Microsoft, Logo Microsoft, dan MakeCode adalah merek dagang terdaftar dari Microsoft Corporation. Mereka hanya dapat digunakan untuk tujuan yang dijelaskan dalam dan sesuai dengan merek dagang Microsoft dan pedoman merek yang diterbitkan di https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. Jika penggunaannya tidak tercakup dalam pedoman Microsoft yang diterbitkan atau Anda tidak yakin, silakan berkonsultasi dengan penasihat hukum Anda atau tim Makecode ([email protected]).