pxt

Microsoft MakeCode

• Probieren Sie die Editoren in Ihrem Browser aus...

Microsoft MakeCode basiert auf dem Open-Source-Projekt Microsoft Programming Experience Toolkit (PXT). Microsoft MakeCode ist der Name in den benutzerorientierten Editoren, PXT wird in allen GitHub-Quellen verwendet.

PXT ist ein Framework zum Erstellen spezieller Programmiererfahrungen für Anfänger, das sich insbesondere auf die Informatikausbildung konzentriert. Die zugrunde liegende Programmiersprache von PXT ist eine Teilmenge von TypeScript (ohne dynamische JavaScript-Funktionen).

Die Hauptmerkmale von PXT sind:

• ein Blockly-basierter Code-Editor zusammen mit einem Konverter in das Textformat
• Ein Monaco-Code-Editor, der VS Code unterstützt. Die Funktionen des Editors sind hier aufgeführt.
• Erweiterbarkeitsunterstützung zum Definieren neuer Blöcke in TypeScript
• ein ARM-Thumb-Maschinencode-Emitter
• ein Befehlszeilen-Paketmanager

Weitere Informationen:

• Um
• Dokumentation

Beispiele für mit MakeCode erstellte Editoren:

• https://makecode.microbit.org
• https://arcade.makecode.com
• https://makecode.adafruit.com
• https://minecraft.makecode.com
• https://makecode.mindstorms.com
• https://makecode.chibitronics.com
• Weitere Editoren unter https://makecode.com/labs

Zweige

• master ist der aktive Entwicklungszweig, derzeit werden v3.* Builds erstellt
• v* ist der Wartungszweig für v*.* Builds

Ausführen eines Ziels von localhost

Bitte folgen Sie den Anweisungen hier.

Verknüpfen eines Ziels mit PXT

Wenn Sie Ihre eigene Instanz von PXT ändern und möchten, dass ein Ziel (z. B. pxt-microbit) Ihre lokale Version verwendet, wechseln Sie mit cd zum Verzeichnis des Ziels (in unserem Beispiel pxt-microbit, das ein Geschwisterverzeichnis von pxt sein sollte). ) und durchführen

 pxt link ../pxt

Wenn Sie pxt mehrfach ausgecheckt haben, können Sie Folgendes tun:

• Führen Sie npm i in pxt und dem Ziel aus
• Führen Sie im Ziel pxt link ..some-other-pxt aus (möglicherweise müssen Sie zuerst Ihre CLI aktualisieren, indem Sie npm install -g pxt ausführen).

Wenn Sie npm i anschließend ausführen (entweder im Ziel oder im pxt), müssen Sie diese Schritte möglicherweise wiederholen.

Bauen

Installieren Sie zunächst Node: Mindestversion 8.

So erstellen Sie die PXT-Befehlszeilentools:

 npm install
npm run build

Installieren Sie dann das pxt -Befehlszeilentool (muss nur einmal ausgeführt werden):

 npm install -g pxt

Dann installieren Sie gulp (muss nur einmal durchgeführt werden):

 npm install -g gulp

Danach können Sie pxt von überall im Build-Baum ausführen.

Um den lokalen Webserver zu starten, führen Sie pxt serve im Stammverzeichnis eines App-Ziels aus (z. B. pxt-microbit). PXT öffnet den Editor in Ihrem Standard-Webbrowser.

Wenn Sie gegen pxt entwickeln, können Sie gulp watch im Stammverzeichnis des pxt-Repositorys ausführen, um auf Änderungen zu achten und eine Neuerstellung durchzuführen.

 gulp watch

Wenn Sie ausschließlich an der CLI arbeiten,

 gulp watchCli

Wenn Sie die Suite der zugehörigen Webapps (Skillmap, Multiplayer usw.) nicht erstellen müssen, können Sie diese überspringen und Ihren Build etwas beschleunigen:

 gulp --no-webapps

Symbole

Im Verzeichnis svgicons/ gibt es eine Reihe benutzerdefinierter Symbole (die zusätzlich zu http://semantic-ui.com/elements/icon.html verwendet werden können). Diese müssen 1000x1000px sein. Beginnen Sie am besten mit einem vorhandenen. Um die verfügbaren Symbole anzuzeigen, gehen Sie zu http://localhost:3232/icons.html (diese Datei wird zusammen mit der icons.css , die die generierte WOFF-Symbolschriftart enthält, während der Erstellung erstellt).

Wenn Sie Probleme mit der Anzeige des von Ihnen erstellten Symbols haben, versuchen Sie Folgendes:

 npm install -g svgo
svgo svgicons/myicon.svg

Gemeinsames Styling

Beim Hinzufügen einer CSS-Farbe oder eines anderen Stilelements, das von allen Editorzielen (z. B. micro:bit, Arcade) und Unteranwendungen (auch „CRAs“ genannt, wie Skillmap, Teachertool usw.) gemeinsam genutzt wird. Deklarieren Sie dafür eine CSS-Variable in theme/themepacks.less :

1. Fügen Sie die neue Variable zur Pseudoklasse :root hinzu. Wählen Sie einen angemessenen Standardwert gemäß den Richtlinien in der Datei.
2. Fügen Sie die neue Variable allen in dieser Datei definierten Designklassen hinzu. Zum Zeitpunkt des Verfassens dieses Artikels ist nur theme-highcontrast definiert. Wählen Sie einen Wert, der für das jeweilige Thema gut funktioniert.
3. Fügen Sie die neue Variable zu den Designüberschreibungen für jedes Ziel hinzu. Dies erfolgt in der Datei theme/themepacks.less des Ziel-Repos (z. B. pxt-microbit, pxt-arcade).

Auf diese Weise deklarierte Variablen stehen CRAs zur Laufzeit zur Verfügung und werden mit den Überschreibungswerten initialisiert, die vom Ziel definiert werden, in dem sie ausgeführt werden.

Hervorhebung der Dokumentation

In der Dokumentation wird zum Hervorheben von Codeausschnitten highlight.js (hljs) verwendet. Derzeit sind folgende Sprachen enthalten:

• Typoskript
• Python
• JavaScript
• HTML, XML
• Abschlag

Wenn Sie weitere Sprachen hinzufügen oder bestehende aktualisieren müssen, finden Sie die Distribution unter https://highlightjs.org/download/; Wählen Sie alle Sprachen aus, die Sie einbinden möchten (einschließlich der oben genannten!), laden Sie sie herunter, entpacken Sie sie und kopieren Sie schließlich highlight.pack.js nach webapp/public/highlight.js/ .

Tests

Die Tests befinden sich im Unterverzeichnis tests/ und sind eine Kombination aus Knoten- und Browsertests. Um sie auszuführen, führen Sie npm run test:all im Stammverzeichnis aus.

Lizenz

MIT-Lizenz

Verhaltenskodex

Dieses Projekt hat den Microsoft Open Source Verhaltenskodex übernommen. Weitere Informationen finden Sie in den häufig gestellten Fragen zum Verhaltenskodex oder wenden Sie sich bei weiteren Fragen oder Kommentaren an [email protected].

Kontaktieren Sie uns

Nehmen Sie Kontakt auf

Marken

MICROSOFT, das Microsoft-Logo und MAKECODE sind eingetragene Marken der Microsoft Corporation. Sie dürfen nur für die Zwecke verwendet werden, die in den unter https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx veröffentlichten Marken- und Markenrichtlinien von Microsoft beschrieben sind. Wenn die Verwendung nicht in den veröffentlichten Richtlinien von Microsoft abgedeckt ist oder Sie sich nicht sicher sind, wenden Sie sich bitte an Ihren Rechtsberater oder das MakeCode-Team ([email protected]).