O Blockly usa algumas ferramentas e bibliotecas para desenvolvimento, incluindo Git, npm e o closure Compiler. Esta seção fornecerá algumas descrições básicas de cada ferramenta, além de links para onde você pode encontrar mais informações sobre cada ferramenta.
Usamos muitas dessas ferramentas por meio de scripts. Talvez não seja necessário executá-las diretamente. Conhecer os nomes ainda pode ser útil para depurar ou registrar problemas ou solicitações de recursos.
Git
O Git é um sistema de controle de versões usado para acompanhar e gerenciar alterações em arquivos.
GitHub
O GitHub é uma plataforma de hospedagem para controle de versões, colaboração e distribuição de código aberto. O Git rastreia os arquivos. O GitHub fornece interfaces simples para revisão de código, rastreamento de problemas e visualização do histórico de alterações.
Primeiros passos: se você não conhece o Git e o GitHub, confira os tutoriais do quickstart (em inglês) do GitHub para se familiarizar com os princípios básicos.
Nó
O Node.js é uma maneira de executar o JavaScript no servidor, e não em um navegador. O npm (veja abaixo) é executado no Node.
npm
O npm é duas coisas:
- Uma ferramenta de linha de comando que usamos para instalar dependências e executar scripts.
- Um registro on-line em que publicamos nosso código, que facilita o uso do Blockly por outros desenvolvedores.
Primeiros passos: instale o Node e o npm.
Compilador de fechamento
O closure Compiler é uma ferramenta para acelerar o download do JavaScript e a execução dele. Ele é usado para combinar todos os nossos arquivos JavaScript em uma única biblioteca e para verificar a sintaxe e os tipos.
Como começar: você não precisa instalar ou executar o closure Compiler diretamente. Nós o instalamos e o executamos por meio do npm.
Saiba mais: documentação do closure compilador sobre tipos JavaScript e anotações de tipo (links em inglês).
ESLint
O ESLint é um analisador estático que encontra problemas com o código JavaScript. Usamos esse elemento para definir e aplicar um estilo consistente em toda a base de código. Pequenos problemas com o código (sem ponto e vírgula, espaçamento inconsistente etc.) são geralmente chamados de lint. O ESLint é executado automaticamente quando você nos envia uma solicitação de envio. Também é possível executá-lo localmente.
Como começar: nas amostras principais do Blockly e em blockly, você pode executar
o ESLint com npm run lint. Muitos editores de código também têm integrações ESLint para
mostrar problemas à medida que você digita.
Saiba mais: cada regra ESLint tem uma página de documentação que descreve a regra e fornece exemplos de código correto e incorreto.
Mocha
Mocha é um framework de teste de JavaScript. Nós o usamos para executar testes no navegador e no Node.js (para casos de uso headless).
Como começar: nas amostras principais do Blockly e do blockly, é possível executar nossos
testes do Mocha com npm run test. No Blockly Core, isso também executará outros testes.
Os testes Mocha do núcleo Blockly são definidos no diretório tests/mocha.
Saiba mais: o Mocha permite que os desenvolvedores definam hooks, que permitem definir funções centralizadas de configuração e desmontagem para seus testes.
Chai
Chai é uma biblioteca de declarações que usamos nos nossos testes de Mocha.
Leia mais: Chai tem várias "variações" de sintaxe para facilitar a integração com projetos existentes. O Blockly usa a variação assert.