Ferramentas para desenvolvedores do Blockly
é uma ferramenta para desenvolvedores baseada na Web que automatiza partes da configuração do Blockly
incluindo a criação de blocos personalizados, a criação da caixa de ferramentas,
e configurar seu espaço de trabalho do Blockly para Web.
O processo do desenvolvedor do Blockly com a ferramenta consiste em três partes:
- Crie blocos personalizados usando Block Factory e Block Exporter.
- criar uma caixa de ferramentas e um espaço de trabalho padrão usando o Workspace Factory;
- Configure seu espaço de trabalho usando o Workspace Factory, que atualmente é um modelo ).
Bloquear guia de fábrica
A guia "Block Factory" ajuda a criar definições de bloco e geradores de código de bloco para blocos personalizados. Nessa guia, é possível criar, modificar e salvar facilmente blocos personalizados.
Definição de um bloco
Este vídeo mostra em detalhes as etapas para definir um bloco. A interface saiu data, mas os elementos de bloco destacados ainda são precisos.
Como gerenciar a biblioteca
Os blocos são referenciados por seus nomes, portanto, cada bloco que você deseja criar deve ter um nome exclusivo. A interface aplica isso e deixa claro quando você está "salvando" um novo bloco ou uma "atualização" um bloco que já existe.
É possível alternar entre os blocos salvos anteriormente ou criar um novo clique no botão "Biblioteca". Alterar o nome de um bloco existente é outra maneira de criar rapidamente vários blocos com definições semelhantes.
Como exportar e importar uma biblioteca
Os blocos são salvos no armazenamento local do navegador. Como limpar a configuração local do navegador vai excluir os blocos. Para salvar seus blocos indefinidamente, você deve fazer o download da sua biblioteca. O download da sua Biblioteca de blocos é feito como um XML que pode ser importado para definir a biblioteca de blocos para o estado em que estava quando você fez o download do arquivo. A importação de uma biblioteca de blocos substitui suas então talvez você queira exportar primeiro.
Os recursos de importação e exportação também são a forma recomendada de manter e compartilhar diferentes conjuntos de blocos personalizados.
Guia "Bloquear exportador"
Depois de projetar seus blocos, você precisará exportar as definições de bloco e stubs de gerador para usar em apps. Isso é feito Guia "Bloquear exportador".
Todos os blocos armazenados na Biblioteca são exibidos no seletor de bloqueio. Clique no bloco para selecioná-lo ou desmarcá-lo para exportação. Se você quiser selecionar todos os blocos na sua biblioteca, use as opções "Selecionar" → "Todos os blocos armazenados no bloco Biblioteca". Se você criou sua caixa de ferramentas ou configurou seu espaço de trabalho usando na guia Workspace Factory, também é possível selecionar todos os blocos usados por clicando em "Selecionar" → "Todos os usados na fábrica do Workspace".
As configurações de exportação permitem escolher qual idioma gerado você quer segmentar e se deseja as definições, os stubs de gerador, ou ambos, para os blocos selecionados. Depois de selecioná-las, clique em "Exportar" para fazer o download .
Guia "Workspace Factory"
O Workspace Factory facilita a configuração de uma caixa de ferramentas e os padrões de blocos em um espaço de trabalho. Você pode alternar entre a edição da caixa de ferramentas iniciando o espaço de trabalho com a "Toolbox" e "Workspace" botões.
Como criar uma caixa de ferramentas
Ela ajuda a criar o XML de uma caixa de ferramentas. O material presume Familiaridade com recursos da Caixa de ferramentas. Se você já tiver o XML para uma caixa de ferramentas que queira editar aqui, poderá clique em "Carregar para editar".
Caixa de ferramentas sem categorias
Se você tem alguns blocos e quer exibi-los sem nenhuma categoria, arraste-os para o espaço de trabalho. Seus blocos vão aparecer na caixa de ferramentas. na visualização.
Caixa de ferramentas com categorias
Se você quiser exibir blocos em categorias, clique no botão "+" e selecione a opção para a nova categoria. Isso adicionará uma categoria à sua lista que você pode selecionar e editar. Selecione "Categoria padrão" para adicionar uma pessoa padrão Blockly (Lógica, Loops etc.) ou "Standard Toolbox" para adicionar todos categorias padrão do Blockly. Use os botões de seta para reordenar as categorias.
Para mudar o nome ou a cor da categoria selecionada, use o botão "Editar categoria" no menu suspenso. Arrastar um bloco para o espaço de trabalho fará com que ele seja adicionado à categoria.
Blocos avançados
Por padrão, é possível adicionar qualquer um dos blocos padrão ou qualquer bloco à sua biblioteca na caixa de ferramentas. Se você tiver blocos definidos em JSON que não estão na sua biblioteca, use o botão "Importar blocos personalizados" .
Alguns blocos devem ser usados juntos ou incluir padrões. Isso é feito com grupos e sombras. Qualquer um os blocos conectados no editor serão adicionados à caixa de ferramentas como um grupo. Blocos anexados a outro bloco também podem ser transformados em blocos sombra selecionando o bloco filho e clicando no botão "Make shadow" . Observação: somente blocos filhos que não contêm uma variável podem ser alterados para sombra blocos.
Se você incluir um bloco de variável ou função na caixa de ferramentas, inclua um na categoria “Variáveis” ou “Funções” da caixa de ferramentas, para que os usuários tenham o bloco. Saiba mais sobre "Variáveis" ou "funções" de classificação.
Como configurar um espaço de trabalho (para o Blockly para Web)
Para configurar diferentes partes do seu espaço de trabalho, acesse "Workspace Factory" e selecione "Espaço de trabalho".
Escolha "Opções do Workspace"
Defina valores diferentes para opções de configuração e conferir o resultado na área de visualização. Ativando grid ou zoom mostra mais opções para configurar. Além disso, mudar para o uso de categorias geralmente requer uma abordagem workspace; uma lixeira e barras de rolagem são adicionadas automaticamente primeira categoria.
Adicionar blocos pré-carregados ao espaço de trabalho
Isso é opcional, mas pode ser necessário se você deseja exibir um conjunto de blocos em espaço de trabalho:
- Quando o aplicativo é carregado.
- Quando um evento é acionado, como avançar um nível, clicar em um botão de ajuda etc.
Arraste os blocos para o espaço de edição para vê-los no seu espaço de trabalho na visualização. É possível criar grupos de blocos, desativar ou fazer com que determinados blocos sejam ocultados blocos ao selecioná-los.
Você pode exportar esses blocos como XML (veja abaixo). Adicione-os ao seu espaço de trabalho com
Blockly.Xml.domToWorkspace, imediatamente após a criação do espaço de trabalho:
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);
Este exemplo de código adiciona um único bloco math_number ao espaço de trabalho.
Exportando
O Workspace Factory oferece as seguintes opções de exportação:
- Código inicial: produz html e javascript iniciais para injetar seus códigos Workspace do Blockly.
- Toolbox: produz XML para especificar sua caixa de ferramentas.
- Workspace Blocks: produz XML que pode ser carregado em um espaço de trabalho.