Blockly menggunakan beberapa alat dan library untuk pengembangan, termasuk Git, npm, dan Closure Compiler. Bagian ini akan memberikan beberapa deskripsi dasar dari setiap alat, serta link untuk menemukan informasi selengkapnya tentang setiap alat.
Kami menggunakan banyak alat ini melalui skrip. Anda mungkin tidak perlu menjalankannya secara langsung. Mengetahui nama-nama tersebut mungkin masih berguna untuk melakukan proses debug atau mengajukan masalah atau permintaan fitur.
Git
Git adalah sistem kontrol versi yang digunakan untuk melacak dan mengelola perubahan pada file.
GitHub
GitHub adalah platform hosting untuk kontrol versi, kolaborasi, dan distribusi kode open source. Git melacak file; GitHub menyediakan antarmuka yang lancar untuk meninjau kode, melacak masalah, dan melihat histori perubahan.
Memulai: Jika Anda baru menggunakan Git dan GitHub, ikuti tutorial quickstart GitHub untuk memahami dasar-dasarnya.
Node
Node.js adalah cara untuk menjalankan JavaScript di server (bukan di browser). npm (lihat di bawah) berjalan di Node.
npm
npm adalah dua hal:
- Alat command line yang kita gunakan untuk menginstal dependensi dan menjalankan skrip.
- Registry online tempat kami memublikasikan kode, yang memudahkan developer lain untuk menggunakan Blockly.
Memulai: Node dan npm Instal.
Kompilator Closure
Closure Compiler adalah alat untuk membuat download dan berjalan JavaScript lebih cepat. Kami menggunakannya untuk menggabungkan semua file JavaScript ke dalam satu library; kami juga menggunakannya untuk memeriksa sintaksis dan jenis.
Memulai: Anda tidak perlu menginstal atau menjalankan Closure Compiler secara langsung: kami menginstal dan menjalankannya melalui npm.
Baca selengkapnya: Dokumentasi compiler penutupan tentang jenis JavaScript dan anotasi jenis.
ESLint
ESLint adalah penganalisis statis yang menemukan masalah dengan kode JavaScript. Kami menggunakannya untuk menentukan dan menerapkan gaya yang konsisten di seluruh codebase kami. Masalah kecil pada kode (titik koma tidak ada, spasi yang tidak konsisten, dll.) sering disebut lint. ESLint otomatis berjalan saat Anda mengirimkan permintaan pull kepada kami. Anda juga dapat menjalankannya secara lokal.
Memulai: Di contoh Blockly core dan blockly-samples, Anda dapat menjalankan
ESLint dengan npm run lint. Banyak editor kode juga memiliki integrasi ESLint untuk
menampilkan masalah saat Anda mengetik.
Baca selengkapnya: Setiap aturan ESLint memiliki halaman dokumentasi yang menjelaskan aturan dan memberikan contoh kode yang benar dan salah.
Moka
Mocha adalah framework pengujian JavaScript. Kami menggunakannya untuk menjalankan pengujian di browser dan di Node.js (untuk kasus penggunaan headless).
Memulai: Dalam contoh Blockly core dan blockly, Anda dapat menjalankan pengujian Mocha kami dengan npm run test. Di Blockly core, ini juga akan menjalankan pengujian lainnya.
Pengujian Mocha blockly core ditentukan di direktori
tests/mocha.
Baca selengkapnya: Mocha memungkinkan developer menentukan hook, yang memungkinkan Anda menentukan fungsi penyiapan dan penghentian terpusat untuk pengujian Anda.
Chai
Chai adalah library pernyataan yang kami gunakan dalam pengujian Mocha.
Baca selengkapnya: Chai memiliki beberapa "ragam" sintaksis untuk memudahkan integrasi dengan project yang sudah ada. Blockly menggunakan ragam assert.