pxt microbit
1.0.0
PXT-Microbit ist ein Microsoft Programming Experience Toolkit (PXT) -Ziel, mit dem Sie ein BBC Micro: Bit programmieren können.
PXT-Microbit Beta , v3.0.* Erfordert
PXT-Microbit v2.0.* , Branch stable2.0 , benötigt PXT v5.15.*. Es ist die Servicebirsche für den Live -Redakteur.
PXT-Microbit v1.* Erfordert PXT v4.4, der sich derzeit in der Stable4.4-Filiale von PXT befindet.
PXT-Microbit v0.* befindet sich im V0-Zweig dieses Repositorys
Versuchen Sie es live
Bitte fügen Sie ein Problem hinzu, wenn Sie einen (nicht gemeldeten) Fehler entdecken.
Das Autorieren und Testen neuer Erweiterungen kann direkt vom Web -Editor durchgeführt werden. Sehen Sie sich unsere Dokumentation zum Einstieg an. Wenn Sie den Editor lokal ausführen möchten, lesen Sie weiter.
Mit dem lokalen Server können Sie den Editor ausführen und die Dokumentation von Ihrem eigenen Computer ausstellen. Es ist für einen einzelnen Entwickler gedacht, der verwendet wird und nicht so ausgelegt ist, dass der Editor einer großen Anzahl von Benutzern dient.
git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit
sudo für Mac/Linux -Shells hinzu). npm install -g pxt
npm install
Gehen Sie zum laufenden Abschnitt.
Dies ist das typische Setup, das das Makecode -Team verwendet hat, um am Mikrobit zu arbeiten.
.cpp -Dateien zu erstellen. git clone https://github.com/microsoft/pxt
cd pxt
npm install
npm run build
cd ..
git clone https://github.com/microsoft/pxt-common-packages
cd pxt-common-packages
npm install
npm link ../pxt
cd ..
git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit
sudo für Mac/Linux -Shells hinzu). npm install -g pxt
npm install
sudo für Mac/Linux-Shells hinzu). Dieser Schritt ist nur erforderlich, wenn Sie Änderungen an PXT- und/oder PXT-Common-Packages-Repos vornehmen möchten. Wenn Sie nur ein lokales Makecode servieren möchten, können Sie diesen Schritt überspringen. npm link ../pxt ../pxt-common-packages
Beachten Sie, dass der obige Befehl die Ordnerstruktur von annimmt
makecode
|
----------------------------------
| | |
pxt pxt-common-packages pxt-microbit
Führen Sie diesen Befehl in PXT-Microbit aus, um einen lokalen Webserver zu öffnen
pxt serve
Wenn der lokale Server im falschen Browser öffnet, kopieren Sie die URL mit dem lokalen Token. Andernfalls kann der Herausgeber die Projekte nicht laden.
Wenn Sie die .cpp -Dateien ändern müssen (und Yotta installiert haben), aktivieren Sie die Yotta -Kompilierung mit der Flagge --localbuild :
pxt serve --local
Wenn Sie den Build beschleunigen möchten, können Sie die Option rebundle verwenden, die den Gebäude überspringt und einfach die Zielinformationen aktualisiert
pxt serve --rebundle
Manchmal kann Ihr gebauter Ordner in einem schlechten Zustand sein, reinigen und es erneut versuchen.
pxt clean
Die folgenden Befehle erzwingen einen lokalen Build mit Codal.
pxt buildtarget --local
Um Docker zu deaktivieren, laufen Sie
export PXT_NODOCKER=1
Wenn Sie auch das Codal modifizieren, sollten Sie pxt clean ausführen, um sicherzustellen, dass der richtige Zweig abgeholt wird.
pxt serveexport PXT_FORCE_LOCAL=1 PXT_RUNTIME_DEV=1 PXT_ASMDEBUG=1 ; Sie können PXT_NODOCKER=1 hinzufügen; pxt help hat Hilfe bei diesenpxt-microbit/projects pxt-microbit/projects/Untitled-42 Ordner finden.cpp -Dateien in PXT ändern möchten, ersetzen Sie "core": "*" in pxt.json durch "core": "file:../../libs/core" ; Ähnlich "radio": "file:../../libs/radio" und "microphone": "file:../../libs/microphone"main.ts bearbeiten, um die PXT -Seite des Programms zu ändern. Sie können es auch vom Lokalhost -Editor bearbeiten. Downloadpxt build - dies wird irgendwo unter built/ abhängt (abhängig von Build Engine und Docker)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 dh pxt_force. Einbeziehung in den Build-Befehl kann dabei helfenpxt-microbit/built/hexcache hexcache löschenpxt-microbit/projects/<your project name>/built namens binary.hex zu findenpxt deploy ausführen (oder nur pxt , die gleich sind) - es wird erstellt und auf MICROBIT -Laufwerk kopiertbuilt/codal ist, gehen Sie zu built/codal/libraries und führen Sie code *pxt ausführen, siehe Effektepxt gdb ausführen, um zu debuggen. Dies erfordert openocdopenocd sind pxt dmesg , mit dem DMESG(...) -Buffer und pxt heap abgelegt werden können, mit denen PXT Heap (und in gewissem Maße das Codals von's Ones) visualisieren kann. 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
Stellen Sie sicher, dass Sie regelmäßig Änderungen von allen Repos ziehen. Weitere Anweisungen finden Sie unter https://github.com/microsoft/pxt#running-a-target-from-localHost
Um eine neue Wiedergabeliste hinzuzufügen, fügen Sie einen Eintrag in /playlists.json hinzu und regenerieren Sie den Markdown (siehe Absatz unten). Sie haben jetzt eine neue Markdown -Galerie -Datei, in der die Videos aufgeführt sind, auf die Sie in /targetconfig.json verweisen können.
Holen Sie sich einen Google -API -Schlüssel und speichern Sie ihn in den Umgebungsvariablen GOOGLE_API_KEY (Daten aus der App einschalten).
pxt downloadplaylists
Das PXT-Microbit-Ziel hängt von mehreren anderen Repos ab. Die wichtigsten sind:
Siehe den Makecode -Blog.
Dieses Projekt hat den Microsoft Open Source -Verhaltenscode übernommen. Weitere Informationen finden Sie im FAQ oder wenden Sie sich an [email protected] mit zusätzlichen Fragen oder Kommentaren.
Microsoft, das Microsoft -Logo und MakeCode sind eingetragene Marken der Microsoft Corporation. Sie können nur für die in und gemäß den Microsoft-Marken- und Markenrichtlinien beschriebenen Zwecke verwendet werden, die unter https://www.microsoft.com/en-us/legal/intellektuelleproperty/trademarks/usage/general.aspx veröffentlicht wurden. Wenn die Verwendung nicht in den veröffentlichten Richtlinien von Microsoft behandelt wird oder Sie sich nicht sicher sind, wenden Sie sich bitte an Ihr Rechtsberater oder Ihr Makecode -Team ([email protected]).
