Depurar com blocos e amostras do Blockly

Às vezes, ao desenvolver um plug-in em amostras de bloco, você precisará fazer as alterações correspondentes no próprio Blockly. A maioria dos plug-ins está configurada para buscar o Blockly no registro do npm. Assim, você só poderá usar o código que já foi lançado no npm. Isso dificultaria a depuração das mudanças do Blockly. Quando você quiser fazer e testar mudanças em amostras de blocos e de blocos, use npm link para testar as mudanças não lançadas juntas.

Você pode dizer ao npm para usar um pacote da sua máquina em vez de buscar o pacote no registro do npm. Com esse método, você terá acesso aos mapas de origem que facilitam a depuração em blocos. É possível usar esse método com mudanças no núcleo que ainda não foram enviadas por push ao GitHub.

  1. Na bifurcação do blockly:

    $ npm run package
    $ cd dist
    $ npm link

    Estas etapas criam o núcleo do Blockly, empacotam-no e criam um link simbólico para os arquivos empacotados.

  2. Na sua bifurcação de amostras em bloco, na raiz:

    $ npm link blockly

    Essa etapa instrui o npm a procurar o link simbólico criado anteriormente em vez de buscar o pacote no npm.

  3. npm run start no diretório do plug-in para testar seu plug-in.

Ao fazer alterações no Core, será necessário recriar e reempacotar esses elementos.

Quando terminar o teste, execute npm ci no nível raiz das amostras em bloco para redefinir o estado do repositório.