scratch vm

scratch-vm

Scratch VM é uma biblioteca para representar, executar e manter o estado de programas de computador escritos usando Scratch Blocks.

Instalação

Isso requer que você tenha Git e Node.js instalados.

Para instalar como uma dependência do seu próprio aplicativo:

npm install scratch-vm

Para configurar um ambiente de desenvolvimento para editar o scratch-vm você mesmo:

git clone https://github.com/scratchfoundation/scratch-vm.git
cd scratch-vm
npm install

Servidor de desenvolvimento

Isso requer que o Node.js esteja instalado.

Por conveniência, incluímos um servidor de desenvolvimento com a VM. Às vezes, isso é útil ao executar em um ambiente que carrega recursos remotos (por exemplo, SVGs do servidor Scratch). Se você quiser usar sua VM modificada com a GUI completa do Scratch 3.0, siga as instruções para vincular a VM à GUI.

Executando o servidor de desenvolvimento

Abra um prompt de comando ou terminal no repositório e execute:

npm start

Parque infantil

Para visualizar o Playground, certifique-se de que o servidor de desenvolvimento esteja em execução e acesse http://localhost:8073/playground/ - você será direcionado ao playground, que demonstra diversas ferramentas e estado interno.

Construção autônoma

npm run build

 < script src =" /path/to/dist/web/scratch-vm.js " > </ script >
< script >
    var vm = new window . VirtualMachine ( ) ;
    // do things
</ script > 

Como incluir em um aplicativo Node.js

Para obter um exemplo de configuração estendida, verifique o diretório /src/playground, que inclui uma instância de VM totalmente em execução.

 var VirtualMachine = require ( 'scratch-vm' ) ;
var vm = new VirtualMachine ( ) ;

// Block events
Scratch . workspace . addChangeListener ( vm . blockListener ) ;

// Run threads
vm . start ( ) ; 

Árvore de sintaxe abstrata

Visão geral

A Máquina Virtual constrói e mantém o estado de uma Árvore de Sintaxe Abstrata (AST) ouvindo eventos emitidos pelo espaço de trabalho de blocos de rascunho por meio do blockListener . Cada alvo (objeto de execução de código, por exemplo, um sprite) mantém um AST para seus blocos. A qualquer momento, o estado atual de um AST pode ser visualizado inspecionando o objeto vm.runtime.targets[...].blocks .

Anatomia de um Bloco

A representação em bloco da VM contém todas as informações importantes para execução e armazenamento. Aqui está um exemplo que representa o script "quando a tecla é pressionada" em um espaço de trabalho:

{
  "_blocks" : {
    "Q]PK~yJ@BTV8Y~FfISeo" : {
      "id" : " Q]PK~yJ@BTV8Y~FfISeo " ,
      "opcode" : " event_whenkeypressed " ,
      "inputs" : {
      },
      "fields" : {
        "KEY_OPTION" : {
          "name" : " KEY_OPTION " ,
          "value" : " space "
        }
      },
      "next" : null ,
      "topLevel" : true ,
      "parent" : null ,
      "shadow" : false ,
      "x" : -69.333333333333 ,
      "y" : 174
    }
  },
  "_scripts" : [
    " Q]PK~yJ@BTV8Y~FfISeo "
  ]
}

Teste

npm test 

npm run coverage

Publicando nas páginas do GitHub

npm run deploy

Isso enviará o playground atualmente construído para a ramificação gh-pages do controle remoto atualmente rastreado. Se você quiser alterar para onde enviar push, adicione um argumento repo url:

npm run deploy -- -r < your repo url > 

Doar

Fornecemos o Scratch gratuitamente e queremos mantê-lo assim! Considere fazer uma doação para apoiar nossos esforços contínuos de engenharia, design, comunidade e desenvolvimento de recursos. Doações de qualquer tamanho são apreciadas. Obrigado!