pxt microbit

Micro: Bit Target para PXT

O PXT-Microbit é um alvo Microsoft Programming Experience Toolkit (PXT) que permite programar um BBC Micro: Bit.

• PXT-Microbit beta , v3.0.* Requer

  • pxt-microbit#stable3.0
  • pxt#stable6.0.
  • PXT-COMMON-Packages#stable6.0.

• PXT-Microbit v2.0.* , ramo stable2.0 , requer pxt v5.15.*. É o ramo de manutenção para editor ao vivo.

• PXT-Microbit v1.* Requer PXT v4.4, que está atualmente na filial estável4.4 do PXT.

• pxt-microbit v0.* está na filial V0 deste repositório

• Experimente ao vivo

Rastreamento de problemas

Adicione um problema se descobrir um bug (não relatado).

Desenvolvendo novas extensões

A criação e o teste de novas extensões podem ser feitas diretamente no editor da web. Veja nossa documentação sobre como começar. Se você deseja executar o editor localmente, continue lendo.

Configuração do servidor local

O servidor local permite executar o editor e servir a documentação do seu próprio computador. É destinado a um único desenvolvedor usado e não projetado para servir o editor a uma grande quantidade de usuários.

1. Instale o node.js 8.9.4 ou superior.
2. Clone este repositório.

 git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit

3. Instale a linha de comando PXT (adicione sudo para conchas Mac/Linux).

 npm install -g pxt

4. Instale as dependências PXT-Microbit.

 npm install

Vá para a seção em execução .

Configuração do desenvolvedor

Esta é a configuração típica usada pela equipe Makecode para trabalhar no microbit.

1. Instale o node.js 8.9.4 ou superior.
2. Instale o Docker se você planeja criar arquivos .cpp .
3. Clone o repositório PXT.

 git clone https://github.com/microsoft/pxt
cd pxt

4. Instale as dependências do PXT e construa -o

 npm install
npm run build
cd ..

5. Clone o repositório PXT-Common-Packages

 git clone https://github.com/microsoft/pxt-common-packages
cd pxt-common-packages
npm install

6. Link pxt-common-packages para pxt

 npm link ../pxt
cd ..

7. Clone este repositório.

 git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit

8. Instale a linha de comando PXT (adicione sudo para conchas Mac/Linux).

 npm install -g pxt

9. Instale as dependências PXT-Microbit.

 npm install

10. Link PXT-Microbit de volta ao repo Base PXT (adicione sudo para conchas Mac/Linux). Esta etapa é necessária apenas se você pretende fazer alterações nos repositores PXT e/ou PXT-Common-Packages. Se tudo o que você quiser é servir um Makecode local, você pode pular esta etapa.

 npm link ../pxt ../pxt-common-packages

Observe o comando acima assume a estrutura da pasta de

       makecode
          |
  ----------------------------------
  |       |                        |
 pxt      pxt-common-packages  pxt-microbit

Correndo

Execute este comando de dentro do PXT-Microbit para abrir um servidor da web local

 pxt serve

Se o servidor local abrir no navegador errado, copie o URL que contém o token local. Caso contrário, o editor não poderá carregar os projetos.

Se você precisar modificar os arquivos .cpp (e instalar YOTTA), ative a compilação YOTTA usando o sinalizador --localbuild :

 pxt serve --local

Se você deseja acelerar a compilação, pode usar a opção rebundle , que ignora a construção e simplesmente refresca as informações de destino

 pxt serve --rebundle

Limpeza

Às vezes, sua pasta construída pode estar em um estado ruim, limpá -lo e tentar novamente.

 pxt clean

Construindo com codal localmente

Os seguintes comandos forçam uma compilação local usando o codal.

 pxt buildtarget --local

Para desativar o Docker, corra

 export PXT_NODOCKER=1

Se você também está modificando o Codal, considere executar pxt clean para garantir que a ramificação adequada seja recolhida.

Modificando dal/codal localmente

• Siga as instruções acima até pxt serve
• editor aberto no localhost e crie um projeto
• export PXT_FORCE_LOCAL=1 PXT_RUNTIME_DEV=1 PXT_ASMDEBUG=1 ; você pode adicionar PXT_NODOCKER=1 ; pxt help tem ajuda neles
• Encontre a pasta do projeto em pxt-microbit/projects , tipicamente pxt-microbit/projects/Untitled-42
• Se você vai modificar os arquivos .cpp no PXT, substitua "core": "*" em pxt.json com "core": "file:../../libs/core" ; Da mesma forma, "radio": "file:../../libs/radio" e "microphone": "file:../../libs/microphone"
• Você pode editar main.ts para alterar o lado PXT do programa; Você também pode editá -lo do editor de localhost; Observe que o Download no editor de localhost produzirá uma linha de comando binária diferente, pois ela se constrói na nuvem e usa a versão marcada do codal
• Nessa pasta Run pxt build - isso clonará Codal em algum lugar em built/ (depende do mecanismo de construção e do Docker)
• Pode haver um problema na exportação das variáveis, ou seja, PXT_FORCE; portanto, incluí-las no comando de construção pode ajudar a resolver problemas sudo PXT_NODOCKER=1 PXT_ASMDEBUG=1 PXT_RUNTIME_DEV=1 PXT_DEBUG=1 PXT_FORCE_LOCAL=1 PXT_COMPILE_SWITCHES=csv---mbcodal pxt build
• Se o alvo não estiver construindo, exclua arquivos no hexcache encontrado em pxt-microbit/built/hexcache para forçar a construção local
• O hexadecimal construído pode ser encontrado em pxt-microbit/projects/<your project name>/built denominado binary.hex
• Da mesma forma, você pode executar pxt deploy (ou apenas pxt , que é o mesmo) - ele criará e copiará para MICROBIT Drive
• built/codal built/codal/libraries code *
• Na guia Git, check -out apropriados (eles estão todos no estado de cabeça isolada para a maneira como marcamos lançamentos)
• Modificar arquivos, executar pxt , ver efeitos
• Você também pode executar pxt gdb para depurar; Isso requer openocd
• Outros comandos usando openocd são pxt dmesg , que despeja o buffer DMESG(...) e pxt heap que podem ser usados para visualizar o pilheiro PXT (e o Codal's One em certa medida)

Atualizando dal.d.ts

 cd libs/blocksprj
rm -rf built
PXT_FORCE_LOCAL=1 PXT_COMPILE_SWITCHES=csv---mbcodal pxt build
PXT_FORCE_LOCAL=1 PXT_COMPILE_SWITCHES=csv---mbcodal pxt builddaldts
mv dal.d.ts ../core

Atualizações

Certifique -se de retirar as alterações de todos os repositórios regularmente. Mais instruções estão em https://github.com/microsoft/pxt#running-a-target-from-localhost

Atualize listas de reprodução em Markdown

Para adicionar uma nova lista de reprodução, adicione uma entrada em /playlists.json e regenere o Markdown (consulte o parágrafo abaixo). Agora você terá um novo arquivo da Galeria de Markdown listando os vídeos que você pode fazer referência em /targetconfig.json .

Obtenha uma chave da API do Google e armazene -a nas variáveis do ambiente GOOGLE_API_KEY (ligue os dados do aplicativo).

 pxt downloadplaylists

Repos

O alvo PXT-Microbit depende de vários outros repositórios. Os principais são:

• https://github.com/microsoft/pxt, a estrutura PXT
• https://github.com/microsoft/pxt-common-packages, APIs comuns que acumulam vários editores do Makecode
• https://github.com/lancaster-university/microbit, invólucro básico em torno do dal
• https://github.com/lancaster-university/microbit-dal

História

Veja o blog Makecode.

Código de Conduta

Este projeto adotou o Código de Conduta Open Microsoft. Para obter mais informações, consulte o Código de Conduta Perguntas frequentes ou entre em contato com [email protected] com quaisquer perguntas ou comentários adicionais.

Marcas comerciais

A Microsoft, o logotipo da Microsoft e o Makecode são marcas registradas da Microsoft Corporation. Eles só podem ser usados para os propósitos descritos em e de acordo com as diretrizes de marca registrada da Microsoft e publicadas em https://www.microsoft.com/en-us/legal/intelectualproperty/trademarks/usage/gener.aspx. Se o uso não for coberto nas diretrizes publicadas da Microsoft ou você não tiver certeza, consulte seu consultor jurídico ou equipe do Makecode ([email protected]).