Blockly использует некоторые инструменты и библиотеки для разработки, включая Git, npm и Closure Compiler. В этом разделе представлены некоторые основные описания каждого инструмента, а также ссылки, где можно найти дополнительную информацию о каждом инструменте.
Многие из этих инструментов мы используем посредством сценариев. Возможно, вам никогда не понадобится запускать их напрямую. Знание имен может быть полезно для отладки, регистрации проблем или запросов функций.
Гит
Git — это система контроля версий, которую мы используем для отслеживания и управления изменениями в файлах.
GitHub
GitHub — это хостинг-платформа для контроля версий, совместной работы и распространения кода с открытым исходным кодом. Git отслеживает файлы; GitHub предоставляет удобные интерфейсы для проверки кода, отслеживания проблем и просмотра истории изменений.
Начало работы . Если вы новичок в Git и GitHub, ознакомьтесь с краткими руководствами GitHub, чтобы освоиться с основами.
Узел
Node.js — это способ запуска JavaScript на сервере (а не в браузере). npm (см. ниже) работает на Node.
НПМ
npm — это две вещи:
- Инструмент командной строки, который мы используем для установки зависимостей и запуска сценариев.
- Онлайн-реестр, в котором мы публикуем наш код, что позволяет другим разработчикам легко использовать Blockly.
Начало работы : установите Node и npm.
Компилятор замыканий
Компилятор Closure — это инструмент, позволяющий ускорить загрузку и запуск JavaScript. Мы используем его для объединения всех наших файлов JavaScript в одну библиотеку; мы также используем его для проверки синтаксиса и типов.
Начало работы : вам не нужно напрямую устанавливать или запускать компилятор Closure: мы устанавливаем и запускаем его через npm.
Подробнее : Документация компилятора замыканий по типам JavaScript и аннотациям типов .
ESLint
ESLint — статический анализатор, который находит проблемы в коде JavaScript. Мы используем его для определения и обеспечения единообразия стиля во всей нашей кодовой базе. Небольшие проблемы с кодом (отсутствующие точки с запятой, несоответствующие интервалы и т. д.) часто называют lint . ESLint автоматически запускается, когда вы отправляете нам запрос на включение. Вы также можете запустить его локально.
Начало работы : как в Blockly core, так и в Blockly-Samples вы можете запустить ESLint с помощью npm run lint . Многие редакторы кода также имеют интеграцию ESLint, позволяющую отображать проблемы по мере ввода.
Подробнее : Каждое правило ESLint имеет страницу документации , на которой описывается правило и приводятся примеры правильного и неправильного кода.
Мокко
Mocha — это среда тестирования JavaScript. Мы используем его для запуска тестов в браузере и на Node.js (для случаев автономного использования).
Начало работы : как в Blockly core, так и в Blockly-Samples вы можете запускать наши тесты Mocha с помощью npm run test . В ядре Blockly это также запускает другие тесты. Тесты Mocha Blockly Core определяются в каталогеtests /mocha .
Подробнее : Mocha позволяет разработчикам определять перехватчики , которые позволяют вам определять функции централизованной настройки и удаления для ваших тестов.
Чай
Chai — это библиотека утверждений, которую мы используем в наших тестах Mocha.
Подробнее : Chai имеет несколько «разновидностей» синтаксиса, что упрощает интеграцию с существующими проектами. Blockly использует вариант Assert .