pxt

Microsoft MakeCode

• Cobalah editor di browser Anda...

Microsoft MakeCode didasarkan pada proyek sumber terbuka Microsoft Programming Experience Toolkit (PXT). Microsoft MakeCode adalah nama di editor yang berhubungan dengan pengguna, PXT digunakan di semua sumber GitHub.

PXT adalah kerangka kerja untuk menciptakan pengalaman pemrograman tujuan khusus untuk pemula, khususnya yang berfokus pada pendidikan ilmu komputer. Bahasa pemrograman yang mendasari PXT adalah bagian dari TypeScript (tanpa menyertakan fitur dinamis JavaScript).

Fitur utama PXT adalah:

• editor kode berbasis Blockly bersama dengan konverter ke format teks
• editor kode Monaco yang mendukung VS Code, fitur editor tercantum di sini.
• dukungan ekstensibilitas untuk menentukan blok baru di TypeScript
• pemancar kode mesin ARM Thumb
• manajer paket baris perintah

Informasi lebih lanjut:

• Tentang
• Dokumentasi

Contoh Editor yang dibuat dengan 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
• Editor lainnya di https://makecode.com/labs

Cabang

• master adalah cabang pengembangan aktif, saat ini v3.* sedang dibangun
• v* adalah cabang layanan untuk v*.* build

Menjalankan target dari localhost

Silakan ikuti instruksi di sini.

Menghubungkan target ke PXT

Jika Anda memodifikasi instance PXT Anda sendiri dan ingin target (seperti pxt-microbit) menggunakan versi lokal Anda, cd ke direktori target (pxt-microbit, dalam contoh kita, yang seharusnya merupakan direktori saudara dari pxt ) dan lakukan

 pxt link ../pxt

Jika Anda memiliki beberapa pembayaran pxt, Anda dapat melakukan hal berikut:

• jalankan npm i di pxt dan target
• di target, jalankan pxt link ..some-other-pxt (Anda mungkin perlu memperbarui CLI terlebih dahulu dengan menjalankan npm install -g pxt )

Jika Anda menjalankan npm i setelahnya (baik dalam target atau pxt), Anda mungkin perlu mengulangi langkah-langkah ini.

Membangun

Pertama, instal Node: versi minimum 8.

Untuk membuat alat baris perintah PXT:

 npm install
npm run build

Kemudian instal alat baris perintah pxt (hanya perlu melakukannya sekali):

 npm install -g pxt

Kemudian instal gulp (hanya perlu melakukannya sekali):

 npm install -g gulp

Setelah ini, Anda dapat menjalankan pxt dari mana saja di dalam pohon build.

Untuk memulai server web lokal, jalankan pxt serve dari dalam root target aplikasi (misalnya pxt-microbit). PXT akan membuka editor di browser web default Anda.

Jika Anda mengembangkan terhadap pxt, Anda dapat menjalankan gulp watch dari dalam root repositori pxt untuk melihat perubahan dan membangun kembali.

 gulp watch

Jika Anda bekerja pada CLI secara eksklusif,

 gulp watchCli

Jika Anda tidak perlu membuat rangkaian aplikasi web terkait (peta keterampilan, multipemain, dll.), Anda dapat melewatinya dan sedikit mempercepat pembuatan Anda:

 gulp --no-webapps

Ikon

Ada sejumlah ikon khusus (untuk digunakan selain http://semantic-ui.com/elements/icon.html) di direktori svgicons/ . Ini harus berukuran 1000x1000px . Awal terbaik dengan yang sudah ada. Untuk melihat ikon yang tersedia, kunjungi http://localhost:3232/icons.html (file ini, bersama dengan icons.css berisi font ikon WOFF yang dihasilkan, dibuat selama pembuatan).

Jika Anda mengalami masalah dengan tampilan ikon yang Anda buat, coba:

 npm install -g svgo
svgo svgicons/myicon.svg

Gaya Bersama

Saat menambahkan warna CSS atau elemen gaya lain yang akan dibagikan ke seluruh target editor (misalnya mikro:bit, Arkade) dan sub-aplikasi (alias "CRA", seperti peta keterampilan, alat guru, dll.). Deklarasikan variabel CSS untuknya di theme/themepacks.less :

1. Tambahkan variabel baru ke :root kelas semu. Pilih nilai default yang masuk akal sesuai dengan pedoman dalam file.
2. Tambahkan variabel baru ke semua kelas tema yang ditentukan dalam file itu. Pada saat penulisan ini, hanya theme-highcontrast yang didefinisikan. Pilih nilai yang sesuai dengan tema yang diberikan.
3. Tambahkan variabel baru ke penggantian tema untuk setiap target. Ini akan dilakukan di file theme/themepacks.less repo target (misalnya pxt-microbit, pxt-arcade).

Variabel yang dideklarasikan dengan cara ini akan tersedia untuk CRA saat runtime, dan variabel tersebut akan diinisialisasi dengan nilai override yang ditentukan oleh target di mana variabel tersebut dijalankan.

Sorotan Dokumentasi

Dalam dokumentasi, penyorotan cuplikan kode menggunakan highlight.js (hljs). Saat ini, bahasa-bahasa berikut disertakan:

• skrip ketikan
• ular piton
• JavaScript
• HTML,XML
• Penurunan harga

Jika Anda perlu menambahkan bahasa lain atau memperbarui bahasa yang sudah ada, Anda dapat menemukan distribusinya di https://highlightjs.org/download/; pilih semua bahasa yang ingin Anda sertakan (termasuk yang di atas!), unduh dan unzip, dan terakhir salin highlight.pack.js ke webapp/public/highlight.js/ .

Tes

Pengujian terletak di subdirektori tests/ dan merupakan kombinasi pengujian node dan browser. Untuk menjalankannya, jalankan npm run test:all di direktori root.

Lisensi

Lisensi MIT

Kode Etik

Proyek ini telah mengadopsi Kode Etik Sumber Terbuka Microsoft. Untuk informasi lebih lanjut lihat FAQ Pedoman Perilaku atau hubungi [email protected] jika ada pertanyaan atau komentar tambahan.

Hubungi kami

Hubungi kami

Merek Dagang

MICROSOFT, Logo Microsoft, dan MAKECODE adalah merek dagang terdaftar dari Microsoft Corporation. Mereka hanya dapat digunakan untuk tujuan yang dijelaskan dalam dan sesuai dengan pedoman Merek Dagang dan Merek Microsoft yang dipublikasikan di https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. Jika penggunaan tidak tercakup dalam pedoman yang diterbitkan Microsoft atau Anda tidak yakin, silakan berkonsultasi dengan penasihat hukum Anda atau tim MakeCode ([email protected]).