Microsoft MakeCode est basé sur le projet open source Microsoft Programming Experience Toolkit (PXT). Microsoft MakeCode
est le nom utilisé dans les éditeurs destinés aux utilisateurs, PXT
est utilisé dans toutes les sources GitHub.
PXT est un framework permettant de créer des expériences de programmation spécifiques pour les débutants, particulièrement axées sur l'enseignement de l'informatique. Le langage de programmation sous-jacent de PXT est un sous-ensemble de TypeScript (en excluant les fonctionnalités dynamiques JavaScript).
Les principales fonctionnalités de PXT sont :
Plus d'informations :
Exemples d'éditeurs construits avec MakeCode :
master
est la branche de développement active, actuellement v3.*
buildsv*
est la branche de maintenance pour les builds v*.*
Veuillez suivre les instructions ici.
Si vous modifiez votre propre instance de PXT et souhaitez qu'une cible (telle que pxt-microbit) utilise votre version locale, accédez au répertoire de la cible (pxt-microbit, dans notre exemple, qui devrait être un répertoire frère de pxt ) et effectuer
pxt link ../pxt
Si vous avez plusieurs extractions de pxt, vous pouvez procéder comme suit :
npm i
dans pxt et la ciblepxt link ..some-other-pxt
(vous devrez peut-être d'abord mettre à jour votre CLI en exécutant npm install -g pxt
) Si vous exécutez npm i
par la suite (dans la cible ou dans le pxt), vous devrez peut-être répéter ces étapes.
Tout d’abord, installez Node : version minimale 8.
Pour créer les outils de ligne de commande PXT :
npm install
npm run build
Installez ensuite l'outil de ligne de commande pxt
(il suffit de le faire une seule fois) :
npm install -g pxt
Ensuite, installez gulp
(il suffit de le faire une seule fois) :
npm install -g gulp
Après cela, vous pouvez exécuter pxt
depuis n'importe où dans l'arborescence de construction.
Pour démarrer le serveur Web local, exécutez pxt serve
à partir de la racine d'une cible d'application (par exemple, pxt-microbit). PXT ouvrira l'éditeur dans votre navigateur Web par défaut.
Si vous développez avec pxt, vous pouvez exécuter gulp watch
depuis la racine du référentiel pxt pour surveiller les modifications et reconstruire.
gulp watch
Si vous travaillez exclusivement sur la CLI,
gulp watchCli
Si vous n'avez pas besoin de build la suite de webapps associées (skillmap, multijoueur, etc.), vous pouvez les ignorer et accélérer un peu votre build :
gulp --no-webapps
Il existe un certain nombre d'icônes personnalisées (à utiliser en plus de http://semantic-ui.com/elements/icon.html) dans le répertoire svgicons/
. Ceux-ci doivent mesurer 1000x1000px
. Mieux vaut commencer par un existant. Pour voir les icônes disponibles, accédez à http://localhost:3232/icons.html (ce fichier, ainsi que icons.css
contenant la police d'icônes WOFF générée, est créé lors de la construction).
Si vous rencontrez des problèmes avec l'affichage de l'icône que vous avez créée, essayez :
npm install -g svgo
svgo svgicons/myicon.svg
Lors de l'ajout d'une couleur CSS ou d'un autre élément de style qui sera partagé entre les cibles de l'éditeur (par exemple micro:bit, Arcade) et les sous-applications (alias "CRA", comme Skillmap, TeacherTool, etc.). Déclarez une variable CSS pour celui-ci dans theme/themepacks.less
:
:root
. Choisissez une valeur par défaut raisonnable selon les directives du fichier.theme-highcontrast
est défini. Choisissez une valeur qui fonctionne bien pour le thème donné.theme/themepacks.less
du dépôt cible (par exemple pxt-microbit, pxt-arcade).Les variables déclarées de cette manière seront disponibles pour les CRA au moment de l'exécution et seront initialisées avec les valeurs de remplacement définies par la cible dans laquelle elles s'exécutent.
Dans la documentation, la mise en évidence des extraits de code utilise highlight.js (hljs). Actuellement, les langues suivantes sont incluses :
Si vous devez ajouter d'autres langues ou mettre à jour celles existantes, vous pouvez trouver la distribution sur https://highlightjs.org/download/ ; sélectionnez toutes les langues que vous souhaitez inclure (y compris celles ci-dessus !), téléchargez et décompressez, et enfin copiez highlight.pack.js
dans webapp/public/highlight.js/
.
Les tests se trouvent dans le sous-répertoire tests/
et sont une combinaison de tests de nœud et de navigateur. Pour les exécuter, exécutez npm run test:all
dans le répertoire racine.
Licence MIT
Ce projet a adopté le code de conduite Microsoft Open Source. Pour plus d’informations, consultez la FAQ sur le code de conduite ou contactez [email protected] pour toute question ou commentaire supplémentaire.
Entrer en contact
MICROSOFT, le logo Microsoft et MAKECODE sont des marques déposées de Microsoft Corporation. Ils ne peuvent être utilisés qu'aux fins décrites dans et conformément aux directives de Microsoft en matière de marques et de marques publiées sur https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx. Si l'utilisation n'est pas couverte par les directives publiées par Microsoft ou si vous n'êtes pas sûr, veuillez consulter votre conseiller juridique ou l'équipe MakeCode ([email protected]).