Blockly używa do programowania niektórych narzędzi i bibliotek, takich jak Git, npm i Closure Compiler. W tej sekcji zamieściliśmy podstawowe opisy poszczególnych narzędzi oraz linki do stron z dodatkowymi informacjami.
Wiele z tych narzędzi używamy w formie skryptów. Możliwe, że nie trzeba będzie uruchamiać ich bezpośrednio. Znajomość nazw może być nadal przydatna przy debugowaniu, zgłaszaniu problemów lub zgłaszaniu próśb o dodanie funkcji.
Git
Git to system kontroli wersji, którego używamy do śledzenia zmian w plikach i zarządzania nimi.
GitHub
GitHub to platforma hostingu służąca do kontroli wersji, współpracy i dystrybucji kodu open source. GitHub śledzi pliki, a GitHub zapewnia bezproblemowe interfejsy do sprawdzania kodu, śledzenia problemów i wyświetlania historii zmian.
Pierwsze kroki: jeśli dopiero zaczynasz korzystać z GitHuba i GitHuba, zapoznaj się z quickstart w tej usłudze, aby poznać jej podstawy.
Węzeł
Node.js to metoda uruchamiania JavaScriptu na serwerze (a nie w przeglądarce). npm (patrz poniżej) działa w węźle.
npm
npm to 2 rzeczy:
- Narzędzie wiersza poleceń, którego używamy do instalowania zależności i uruchamiania skryptów.
- Rejestr online, w którym publikujemy nasz kod, który ułatwia innym programistom korzystanie z Blockly.
Pierwsze kroki: Zainstaluj węzeł i npm.
Kompilator Closure Compiler
Closure Compiler to narzędzie przyspieszające pobieranie i działanie kodu JavaScript. Używamy go do łączenia wszystkich plików JavaScript w jedną bibliotekę oraz do sprawdzania składni i typów.
Pierwsze kroki: nie musisz bezpośrednio instalować ani uruchamiać kompilatora Closure Compiler – instalujemy go i uruchamiamy przez npm.
Więcej informacji: dokumentacja kompilatora Closure (w języku angielskim) dotycząca typów JavaScriptu i adnotacji o typach.
ESLint
ESLint to narzędzie statyczne, które znajduje problemy z kodem JavaScript. Pozwala to zdefiniować i egzekwować spójny styl w całej bazie kodu. Małe problemy z kodem (brakujące średniki, niespójne odstępy itp.) są często nazywane lintami. ESLint uruchamia się automatycznie, gdy wysyłasz do nas żądanie pull. Możesz je też uruchomić lokalnie.
Pierwsze kroki: zarówno w głównej aplikacji Blockly, jak i w próbkach blokowych, możesz uruchomić ESLint z użyciem npm run lint
. Wiele edytorów kodu ma również integracje ESLint, które wyświetlają problemy podczas pisania.
Więcej informacji: każda reguła ESLint ma stronę z dokumentacją, która opisuje regułę oraz zawiera przykłady prawidłowego i nieprawidłowego kodu.
Mokka
Mocha to platforma do testowania JavaScript. Używamy go do wykonywania testów w przeglądarce i w środowisku Node.js (w przypadkach użycia bez interfejsu graficznego).
Pierwsze kroki: w głównej i blokowej instancji Blockly możesz przeprowadzać testy Mocha za pomocą npm run test
. W Blockly core uruchomimy też inne testy.
Testy Mocha rdzenia Blockly są zdefiniowane w katalogu tests/mokha.
Więcej informacji: Mocha umożliwia programistom definiowanie punktów zaczepienia, które umożliwiają zdefiniowanie scentralizowanych funkcji konfiguracji i demontażu na potrzeby testów.
Czaj
Chai to biblioteka asercji, której używamy w testach Mocha.
Więcej informacji: Chai ma różne „rodzaje” składni, co ułatwia integrację z istniejącymi projektami. Blockly używa rodzaju assert.