Инструменты разработчика Blockly
— это веб-инструмент разработчика, который автоматизирует части процесса настройки Blockly, включая создание пользовательских блоков, построение набора инструментов и настройку рабочего пространства Blockly.
Процесс разработки Blockly с использованием инструмента состоит из трех частей:
- Создавайте собственные блоки с помощью Block Factory и Block Exporter.
- Создайте набор инструментов и рабочее пространство по умолчанию с помощью Workspace Factory.
- Настройте свое рабочее пространство с помощью Workspace Factory (в настоящее время это только веб-функция).
Вкладка «Блок-фабрика»
Вкладка Block Factory помогает вам создавать определения блоков и генераторы кодов блоков для пользовательских блоков. На этой вкладке вы можете легко создавать, изменять и сохранять пользовательские блоки.
Определение блока
В этом видео подробно рассматриваются шаги определения блока. Пользовательский интерфейс устарел, но функции блока, которые он выделяет, по-прежнему точны.
Управление библиотекой
Блоки ссылаются по их имени, поэтому каждый блок, который вы хотите создать, должен иметь уникальное имя. Пользовательский интерфейс обеспечивает это и дает понять, когда вы «сохраняете» новый блок или «обновляете» существующий блок.
Вы можете переключаться между ранее сохраненными блоками или создать новый пустой блок, нажав кнопку «Библиотека». Изменение имени существующего блока — еще один способ быстро создать несколько блоков с похожими определениями.
Экспорт и импорт библиотеки
Блоки сохраняются в локальном хранилище браузера. Очистка локального хранилища браузера приведет к удалению ваших блоков. Чтобы сохранить ваши блоки на неопределенный срок, вы должны загрузить вашу библиотеку. Ваша библиотека блоков загружается как XML-файл, который можно импортировать, чтобы установить вашу библиотеку блоков в то состояние, в котором она была при загрузке файла. Обратите внимание, что импорт библиотеки блоков заменяет вашу текущую, поэтому вам может потребоваться сначала выполнить экспорт.
Функции импорта и экспорта также являются рекомендуемым способом сохранения и совместного использования различных наборов пользовательских блоков.
Вкладка «Блокировать экспортер»
После того, как вы спроектировали свои блоки, вам нужно будет экспортировать определения блоков и заглушки генераторов, чтобы использовать их в приложении. Это делается на вкладке Block Exporter.
Каждый блок, сохраненный в вашей библиотеке блоков, будет показан в селекторе блоков. Щелкните по блоку, чтобы выбрать или отменить выбор для экспорта. Если вы хотите выбрать все блоки в вашей библиотеке, используйте опцию «Выбрать» → «Все сохраненные в библиотеке блоков». Если вы создали свой набор инструментов или настроили свое рабочее пространство с помощью вкладки Workspace Factory, вы также можете выбрать все используемые вами блоки, нажав «Выбрать» → «Все используемые в Workspace Factory».
Настройки экспорта позволяют вам выбрать, какой сгенерированный язык вы хотите использовать в качестве целевого, и нужны ли вам определения, заглушки генератора или и то, и другое для выбранных блоков. После того, как вы их выбрали, нажмите «Экспорт», чтобы загрузить файлы.
Вкладка «Рабочая область: Фабрика»
Workspace Factory упрощает настройку набора инструментов и набора блоков по умолчанию в рабочем пространстве. Вы можете переключаться между редактированием набора инструментов и начального рабочего пространства с помощью кнопок «Toolbox» и «Workspace».
Создание ящика для инструментов
Эта вкладка помогает создать XML для Toolbox. Материал предполагает знакомство с функциями Toolbox . Если у вас уже есть XML для toolbox, который вы хотите здесь редактировать, вы можете загрузить его, нажав «Загрузить для редактирования».
Ящик для инструментов без категорий
Если у вас есть несколько блоков и вы хотите отобразить их без каких-либо категорий, просто перетащите их в рабочую область, и вы увидите, как ваши блоки появятся на панели инструментов в предварительном просмотре.
Ящик с инструментами с категориями
Если вы хотите отобразить блоки в категориях, нажмите кнопку "+" и выберите раскрывающийся элемент для новой категории. Это добавит категорию в ваш список категорий, которую вы можете выбрать и редактировать. Выберите "Стандартная категория", чтобы добавить отдельную стандартную категорию Blockly (логика, циклы и т. д.), или "Стандартный набор инструментов", чтобы добавить все стандартные категории Blockly. Используйте кнопки со стрелками, чтобы изменить порядок категорий.
Чтобы изменить название или цвет выбранной категории, используйте раскрывающийся список «Изменить категорию». Перетаскивание блока в рабочую область добавит его в выбранную категорию.
Продвинутые блоки
По умолчанию вы можете добавить любой из стандартных блоков или любые блоки в вашей библиотеке в панель инструментов. Если у вас есть блоки, определенные в JSON, которых нет в вашей библиотеке, вы можете импортировать их с помощью кнопки «Импорт пользовательских блоков».
Некоторые блоки должны использоваться вместе или включать значения по умолчанию. Это делается с помощью групп и теней . Любые блоки, которые связаны в редакторе, будут добавлены на панель инструментов как группа. Блоки, которые прикреплены к другому блоку, также можно изменить на блоки тени, выбрав дочерний блок и нажав кнопку «Создать тень». Примечание: только дочерние блоки, которые не содержат переменную, можно изменить на блоки тени.
Если вы включаете переменную или функциональный блок в их набор инструментов, включите категорию «Переменные» или «Функции» в свой набор инструментов, чтобы позволить пользователям в полной мере использовать блок. Узнайте больше о категориях «Переменные» или «Функции» .
Настройка рабочего пространства
Чтобы настроить различные части вашего рабочего пространства, перейдите на вкладку «Workspace Factory» и выберите «Workspace».
Выберите параметры рабочего пространства
Установите различные значения для параметров конфигурации и посмотрите результат в области предварительного просмотра. Включение сетки или масштабирования открывает больше параметров для настройки. Кроме того, переключение на использование категорий обычно требует более сложного рабочего пространства; мусорная корзина и полосы прокрутки добавляются автоматически при добавлении первой категории.
Добавить предварительно загруженные блоки в рабочую область
Это необязательно, но может быть необходимо, если вы хотите отобразить набор блоков в рабочей области:
- При загрузке приложения.
- При возникновении события (продвижение на следующий уровень, нажатие кнопки справки и т. д.).
Перетащите блоки в область редактирования, чтобы увидеть их в рабочей области в предварительном просмотре. Вы можете создавать группы блоков, отключать блоки и делать определенные блоки теневыми при их выборе.
Вы можете экспортировать эти блоки как XML (см. ниже). Добавьте их в свое рабочее пространство с помощью Blockly.Xml.domToWorkspace сразу после создания рабочего пространства:
var xmlText = '<xml xmlns="https://developers.google.com/blockly/xml">' +
'<block type="math_number"></block></xml>';
Blockly.Xml.domToWorkspace(Blockly.utils.xml.textToDom(xmlText), workspace);
Этот пример кода добавляет один блок math_number в рабочую область.
Экспорт
Workspace Factory предоставляет вам следующие возможности экспорта:
- Начальный код: создает начальный HTML-код и JavaScript-код для внедрения вашего настроенного рабочего пространства Blockly.
- Панель инструментов: создает XML-файл для указания панели инструментов.
- Блоки рабочего пространства: создают XML, который можно загрузить в рабочее пространство.