Microsoft MakeCode se basa en el proyecto de código abierto Microsoft Programming Experience Toolkit (PXT). Microsoft MakeCode
es el nombre en los editores de cara al usuario, PXT
se usa en todas las fuentes de GitHub.
PXT es un marco para crear experiencias de programación de propósito especial para principiantes, especialmente enfocadas en la educación en informática. El lenguaje de programación subyacente de PXT es un subconjunto de TypeScript (dejando de lado las características dinámicas de JavaScript).
Las principales características de PXT son:
Más información:
Ejemplos de editores creados con MakeCode:
master
es la rama de desarrollo activa, actualmente compilaciones v3.*
v*
es la rama de servicio para las compilaciones v*.*
Siga las instrucciones aquí.
Si está modificando su propia instancia de PXT y desea que un destino (como pxt-microbit) use su versión local, vaya al directorio del destino (pxt-microbit, en nuestro ejemplo, que debería ser un directorio hermano de pxt). ) y realizar
pxt link ../pxt
Si tiene varios pagos de pxt, puede hacer lo siguiente:
npm i
en pxt y el objetivopxt link ..some-other-pxt
(es posible que primero necesite actualizar su CLI ejecutando npm install -g pxt
) Si ejecuta npm i
después (ya sea en el destino o en pxt), es posible que deba repetir estos pasos.
Primero, instale Node: versión mínima 8.
Para construir las herramientas de línea de comando PXT:
npm install
npm run build
Luego instale la herramienta de línea de comando pxt
(solo es necesario hacerlo una vez):
npm install -g pxt
Luego instale gulp
(solo es necesario hacerlo una vez):
npm install -g gulp
Después de esto, puedes ejecutar pxt
desde cualquier lugar dentro del árbol de compilación.
Para iniciar el servidor web local, ejecute pxt serve
desde la raíz de una aplicación de destino (por ejemplo, pxt-microbit). PXT abrirá el editor en su navegador web predeterminado.
Si está desarrollando con pxt, puede ejecutar gulp watch
desde la raíz del repositorio de pxt para observar los cambios y reconstruir.
gulp watch
Si está trabajando exclusivamente en la CLI,
gulp watchCli
Si no necesita crear el conjunto de aplicaciones web asociadas (mapa de habilidades, multijugador, etc.), puede omitirlas y acelerar un poco su compilación:
gulp --no-webapps
Hay varios íconos personalizados (para usar además de http://semantic-ui.com/elements/icon.html) en el directorio svgicons/
. Deben tener 1000x1000px
. Lo mejor es empezar con uno existente. Para ver los iconos disponibles, vaya a http://localhost:3232/icons.html (este archivo, junto con icons.css
que contiene la fuente del icono WOFF generado, se crea durante la compilación).
Si tiene problemas para mostrar el ícono que creó, intente:
npm install -g svgo
svgo svgicons/myicon.svg
Al agregar un color CSS u otro elemento de estilo que se compartirá entre los objetivos del editor (por ejemplo, micro:bit, Arcade) y subaplicaciones (también conocidas como "CRA", como mapa de habilidades, herramienta para profesores, etc.). Declare una variable CSS para ello en theme/themepacks.less
:
:root
. Elija un valor predeterminado razonable de acuerdo con las pautas del archivo.theme-highcontrast
. Elija un valor que funcione bien para el tema determinado.theme/themepacks.less
del repositorio de destino (por ejemplo, pxt-microbit, pxt-arcade).Las variables declaradas de esta manera estarán disponibles para las CRA en tiempo de ejecución y se inicializarán con los valores de anulación definidos por el destino en el que se ejecutan.
En la documentación, el resaltado de fragmentos de código utiliza resaltado.js (hljs). Actualmente, se incluyen los siguientes idiomas:
Si necesita agregar otros idiomas o actualizar los existentes, puede encontrar la distribución en https://highlightjs.org/download/; seleccione todos los idiomas que desea incluir (¡incluidos los anteriores!), descárguelos, descomprímalos y, finalmente, copie highlight.pack.js
en webapp/public/highlight.js/
.
Las pruebas se encuentran en el subdirectorio tests/
y son una combinación de pruebas de nodo y navegador. Para ejecutarlos, ejecute npm run test:all
en el directorio raíz.
Licencia MIT
Este proyecto ha adoptado el Código de conducta de código abierto de Microsoft. Para obtener más información, consulte las preguntas frecuentes sobre el Código de conducta o comuníquese con [email protected] si tiene alguna pregunta o comentario adicional.
Ponte en contacto
MICROSOFT, el logotipo de Microsoft y MAKECODE son marcas comerciales registradas de Microsoft Corporation. Solo se pueden utilizar para los fines descritos y de acuerdo con las pautas de marcas y marcas registradas de Microsoft publicadas en https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. Si el uso no está cubierto en las pautas publicadas por Microsoft o no está seguro, consulte a su asesor legal o al equipo de MakeCode ([email protected]).