Narzędzia dla programistów

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.