PXT-Microbit是Microsoft编程体验工具包(PXT)目标,它允许您对BBC Micro:BIT进行编程。
pxt-microbit beta , v3.0.*要求
pxt-microbit v2.0.* ,分支stable2.0 ,需要pxt v5.15。*。这是现场编辑的服务分支。
PXT-Microbit v1.*需要PXT V4.4,该V4.4当前位于PXT的稳定4.4分支中。
pxt-microbit v0.*在此存储库的V0分支中
尝试现场
如果您发现(未报告)错误,请添加问题。
可以直接从Web编辑器完成新扩展的创作和测试。请参阅我们有关如何开始的文档。如果您想在本地运行编辑器,请继续阅读。
本地服务器可让您运行编辑器并从自己的计算机上提供文档。它是针对使用的单个开发人员,而不是为大量用户提供编辑器的设计。
git clone https://github.com/microsoft/pxt-microbit
cd pxt-microbit
sudo )。 npm install -g pxt
npm install
转到运行部分。
这是Makecode团队使用的典型设置,用于在微型机构上工作。
.cpp文件,请安装Docker。 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 )。 npm install -g pxt
npm install
sudo )。仅当您打算更改PXT和/或PXT-Common-Packages Repos时,才需要此步骤。如果您想要的只是为当地的makecode提供服务,则可以跳过此步骤。 npm link ../pxt ../pxt-common-packages
注意以上命令假设文件夹结构
makecode
|
----------------------------------
| | |
pxt pxt-common-packages pxt-microbit
从pxt-microbit内部运行此命令以打开本地Web服务器
pxt serve
如果本地服务器在错误的浏览器中打开,请确保复制包含本地令牌的URL。否则,编辑者将无法加载项目。
如果您需要修改.cpp文件(并已安装了Yotta),请使用--localbuild标志启用Yotta汇编:
pxt serve --local
如果您想加快构建速度,则可以使用rebundle选项,该选项跳过构建并简单地刷新目标信息
pxt serve --rebundle
有时,您的构建文件夹可能处于不良状态,将其清洁并重试。
pxt clean
以下命令迫使使用代号的本地构建。
pxt buildtarget --local
禁用Docker,运行
export PXT_NODOCKER=1
如果您还在修改代码,请考虑运行pxt clean以确保拾取适当的分支。
pxt serveexport PXT_FORCE_LOCAL=1 PXT_RUNTIME_DEV=1 PXT_ASMDEBUG=1 ;您可以添加PXT_NODOCKER=1 ; pxt help对这些有帮助pxt-microbit/projects下查找项目文件夹,通常是pxt-microbit/projects/Untitled-42.cpp文件,请用"core": "*" "core": "file:../../libs/core" pxt.json类似地, "radio": "file:../../libs/radio"和"microphone": "file:../../libs/microphone"main.ts以更改程序的PXT侧;您也可以从Localhost编辑器进行编辑;请注意,在Local主持的编辑器中Download将产生与命令行不同的二进制文件,因为它在云中构建并使用标记版本的codal版本pxt build这将在built/下的某个地方克隆(取决于构建引擎和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 buildpxt-microbit/built/hexcache中删除hexcache中的文件,以强迫本地构建pxt-microbit/projects/<your project name>/built nater binary.hex中找到构建的十六进制pxt deploy (或仅是相同的pxt ) - 它将构建并复制到MICROBIT驱动器built/codal下,请转到built/codal/libraries并运行code *pxt ,查看效果pxt gdb进行调试;这需要openocdopenocd的其他命令是pxt dmesg ,它转储DMESG(...)缓冲区和pxt heap ,可用于可视化PXT Heap(并且在某种程度上是Codal的一个) 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
确保定期从所有存储库中进行更改。更多说明请访问https://github.com/microsoft/pxt#rnunning-a-target-from-localhost
要添加一个新的播放列表,请在/playlists.json中添加一个条目,然后再生降价(请参见下面的段落)。现在,您将拥有一个新的Markdown Gallery文件列出了可以在/targetconfig.json中引用的视频。
获取Google API键并将其存储在GOOGLE_API_KEY环境变量(从应用程序中打开数据)。
pxt downloadplaylists
PXT-Microbit目标取决于其他几个存储库。主要的是:
请参阅Makecode博客。
该项目采用了Microsoft开源的行为代码。有关更多信息,请参见《行为守则常见问题守则》或与其他问题或评论联系[email protected]。
Microsoft,Microsoft徽标和MakeCode是Microsoft Corporation的注册商标。它们只能按照Microsoft的商标和品牌准则在https://www.microsoft.com/en-us/legal/legal/intellectalectualproperty/trademarks/usage/usage/general.aspx上发表。如果Microsoft已发布的准则未涵盖使用,或者您不确定,请咨询您的法律顾问或Makecode团队([email protected])。