Microsoft MakeCode 基于开源项目 Microsoft 编程体验工具包 (PXT)。 Microsoft MakeCode
是面向用户的编辑器中的名称, PXT
用于所有 GitHub 源代码中。
PXT 是一个为初学者创建专用编程体验的框架,特别专注于计算机科学教育。 PXT 的底层编程语言是 TypeScript 的子集(不包括 JavaScript 动态功能)。
PXT的主要特点是:
更多信息:
使用 MakeCode 构建的编辑器示例:
master
是活跃的开发分支,当前构建为v3.*
v*
是v*.*
构建的服务分支请按照此处的说明进行操作。
如果您正在修改自己的 PXT 实例并希望目标(例如 pxt-microbit)使用您的本地版本,请 cd 到目标目录(在我们的示例中为 pxt-microbit,它应该是 pxt 的同级目录) )并执行
pxt link ../pxt
如果您有多次签出 pxt,您可以执行以下操作:
npm i
pxt link ..some-other-pxt
(您可能需要首先通过运行npm install -g pxt
来更新 CLI)如果您随后运行npm i
(在目标或 pxt 中),您可能需要重复这些步骤。
首先,安装 Node:最低版本 8。
要构建 PXT 命令行工具:
npm install
npm run build
然后安装pxt
命令行工具(只需执行一次):
npm install -g pxt
然后安装gulp
(只需执行一次):
npm install -g gulp
之后,您可以从构建树中的任何位置运行pxt
。
要启动本地 Web 服务器,请从应用程序目标的根目录(例如 pxt-microbit)运行pxt serve
。 PXT 将在您的默认 Web 浏览器中打开编辑器。
如果您正在针对 pxt 进行开发,则可以从 pxt 存储库的根目录中运行gulp watch
来监视更改和重建。
gulp watch
如果您专门使用 CLI,
gulp watchCli
如果您不需要构建相关的网络应用程序套件(技能图、多人游戏等),您可以跳过它们并稍微加快构建速度:
gulp --no-webapps
svgicons/
目录中有许多自定义图标(除了 http://semantic-ui.com/elements/icon.html 之外还可以使用)。这些需要是1000x1000px
。最好从现有的开始。要查看可用图标,请访问 http://localhost:3232/icons.html(此文件以及包含生成的 WOFF 图标字体的icons.css
是在构建期间创建的)。
如果您在显示创建的图标时遇到问题,请尝试:
npm install -g svgo
svgo svgicons/myicon.svg
添加将在编辑器目标(例如 micro:bit、Arcade)和子应用程序(又名“CRA”,如技能图、教师工具等)之间共享的 CSS 颜色或其他样式元素时。在theme/themepacks.less
中为其声明一个 CSS 变量:
:root
伪类中。根据文件中的指南选择合理的默认值。theme-highcontrast
。选择适合给定主题的值。theme/themepacks.less
文件(例如 pxt-microbit、pxt-arcade)中完成。以这种方式声明的变量将在运行时可供 CRA 使用,并且它们将使用它们运行的目标定义的覆盖值进行初始化。
在文档中,代码片段的突出显示使用highlight.js (hljs)。目前,包括以下语言:
如果您需要添加其他语言或更新现有语言,您可以在 https://highlightjs.org/download/ 找到发行版;选择您想要包含的所有语言(包括上面的语言!),下载并解压缩,最后将highlight.pack.js
复制到webapp/public/highlight.js/
中。
测试位于tests/
子目录中,是节点测试和浏览器测试的组合。要执行它们,请在根目录中运行npm run test:all
。
麻省理工学院许可证
该项目采用了微软开源行为准则。有关详细信息,请参阅行为准则常见问题解答或联系 [email protected] 提出任何其他问题或意见。
联系我们
MICROSOFT、Microsoft 徽标和 MAKECODE 是 Microsoft Corporation 的注册商标。它们只能用于 https://www.microsoft.com/en-us/legal/intellectualproperty/trademarks/usage/general.aspx 上发布的 Microsoft 商标和品牌指南中描述的目的。如果 Microsoft 发布的指南中未涵盖该用途,或者您不确定,请咨询您的法律顾问或 MakeCode 团队 ([email protected])。