pxt
1.0.0
O Microsoft MakeCode é baseado no projeto de código aberto Microsoft Programming Experience Toolkit (PXT). Microsoft MakeCode é o nome nos editores voltados para o usuário, PXT é usado em todas as fontes do GitHub.
PXT é uma estrutura para a criação de experiências de programação com fins especiais para iniciantes, especialmente focada no ensino de ciência da computação. A linguagem de programação subjacente do PXT é um subconjunto do TypeScript (deixando de fora os recursos dinâmicos do JavaScript).
As principais características do PXT são:
Mais informações:
Exemplos de editores construídos com MakeCode:
master é o branch de desenvolvimento ativo, atualmente compilações v3.*v* é o branch de serviço para compilações v*.* Por favor, siga as instruções aqui.
Se você estiver modificando sua própria instância do PXT e quiser que um destino (como pxt-microbit) use sua versão local, faça cd para o diretório do destino (pxt-microbit, em nosso exemplo, que deve ser um diretório irmão de pxt ) e realizar
pxt link ../pxt
Se você tiver vários checkouts de pxt, poderá fazer o seguinte:
npm i em pxt e o destinopxt link ..some-other-pxt (talvez seja necessário atualizar sua CLI primeiro executando npm install -g pxt ) Se você executar npm i posteriormente (no destino ou no pxt), talvez seja necessário repetir essas etapas.
Primeiro, instale o Node: versão mínima 8.
Para construir as ferramentas de linha de comando PXT:
npm install
npm run build
Em seguida, instale a ferramenta de linha de comando pxt (só é necessário fazer isso uma vez):
npm install -g pxt
Em seguida, instale gulp (só é necessário fazer isso uma vez):
npm install -g gulp
Depois disso, você pode executar pxt de qualquer lugar da árvore de construção.
Para iniciar o servidor web local, execute pxt serve na raiz de um destino de aplicativo (por exemplo, pxt-microbit). PXT abrirá o editor em seu navegador padrão.
Se você estiver desenvolvendo em pxt, poderá executar gulp watch na raiz do repositório pxt para observar alterações e reconstruir.
gulp watch
Se você estiver trabalhando exclusivamente na CLI,
gulp watchCli
Se você não precisa construir o conjunto de webapps associados (skillmap, multiplayer, etc.), você pode ignorá-los e acelerar um pouco sua construção:
gulp --no-webapps
Existem vários ícones personalizados (para usar além de http://semantic-ui.com/elements/icon.html) no diretório svgicons/ . Eles precisam ter 1000x1000px . Melhor começar com um já existente. Para ver os ícones disponíveis, acesse http://localhost:3232/icons.html (este arquivo, junto com icons.css contendo a fonte do ícone WOFF gerada, é criado durante a construção).
Se você estiver tendo problemas para exibir o ícone que criou, tente:
npm install -g svgo
svgo svgicons/myicon.svg
Ao adicionar uma cor CSS ou outro elemento de estilo que será compartilhado entre os alvos do editor (por exemplo, micro:bit, Arcade) e subaplicativos (também conhecidos como "CRAs", como mapa de habilidades, ferramenta de professor, etc.). Declare uma variável CSS para ele em theme/themepacks.less :
:root . Escolha um valor padrão razoável de acordo com as diretrizes do arquivo.theme-highcontrast estava definido. Escolha um valor que funcione bem para o tema específico.theme/themepacks.less do repositório de destino (por exemplo, pxt-microbit, pxt-arcade).As variáveis declaradas desta forma estarão disponíveis para CRAs em tempo de execução e serão inicializadas com os valores de substituição definidos pelo destino em que estão sendo executadas.
Na documentação, o destaque de trechos de código usa destaque.js (hljs). Atualmente, os seguintes idiomas estão incluídos:
Caso precise adicionar outros idiomas ou atualizar os existentes, você pode encontrar a distribuição em https://highlightjs.org/download/; selecione todos os idiomas que deseja incluir (incluindo os acima!), baixe e descompacte e, finalmente, copie highlight.pack.js para webapp/public/highlight.js/ .
Os testes estão localizados no subdiretório tests/ e são uma combinação de testes de nó e navegador. Para executá-los, execute npm run test:all no diretório raiz.
Licença MIT
Este projeto adotou o Código de Conduta de Código Aberto da Microsoft. Para obter mais informações, consulte as Perguntas frequentes sobre o Código de Conduta ou entre em contato com [email protected] com perguntas ou comentários adicionais.
Entre em contato
MICROSOFT, o logotipo da Microsoft e MAKECODE são marcas registradas da Microsoft Corporation. Eles só podem ser usados para os fins descritos e de acordo com as diretrizes de marca registrada e marca da Microsoft publicadas em https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. Se o uso não estiver coberto pelas diretrizes publicadas pela Microsoft ou se você não tiver certeza, consulte seu consultor jurídico ou a equipe MakeCode ([email protected]).
