Adafruit的Microsoft MakeCode简介

什么是MakeCode？

Adafruit的Microsoft MakeCode 是用于物理计算的基于Web的代码编辑器。它提供了类似于Scratch或Code.org的块编辑器，还为更高级的用户提供了JavaScript编辑器。 立即在https://makecode.adafruit.com/上尝试！！

MakeCode的一些关键功能包括：

基于网络的编辑器：无需安装

跨平台：可在大多数现代浏览器中使用，从微型手机到大型触摸屏

在浏览器中进行编译：编译器在您的浏览器中运行，运行速度快且可离线运行

块+ JavaScript：拖放块或键入JavaScript，MakeCode让您

可脱机工作：：一旦加载了编辑器，它就会保留在浏览器中。

基于事件的运行时：轻松响应按钮单击，摇动手势等操作

MakeCode当前支持 Adafruit Circuit Playground Express 。 对于其他板，例如Adafruit Metro M0，请尝试https://maker.makecode.com。

Circuit Playground Express

产品ID：3333

Circuit Playground Express是向电子学和编程学完美介绍的下一步。我们已经采用了原始的Circuit Playground Classic和。..

$ 24.95

入库存

添加到购物车

Circuit Playground Express-Base套件

产品ID：3517

这是Circuit Playground Express基础套件！它提供了开始使用新

$ 29.95

进货

添加到购物车

MakeCode适用于Circuit Playground的Express版本，而不是Classic。

编辑块

块编辑器是开始使用MakeCode的最简单方法。您可以从类别列表中拖放块。每次更改块时，模拟器都会自动重新启动并运行代码。您可以在浏览器中测试您的程序！

尝试我们的入门教程，该教程可以帮助您构建警笛程序

尝试我们的项目之一，以了解有关以下功能的更多信息：

深入研究文档

眨眼！

让我们通过构建一个简单的程序来闪烁MakeCode的工作原理，该程序使10个很棒的NeoPixels闪烁。/p》

通过将所有环形LED都设置为红色，暂停，然后将其关闭，暂停一会，然后重复永远。

让我们收集我们需要的块，将上面的描述转换为电路游乐场可以理解和运行的块：

永远 》在一个循环中运行块，中间有20ms的暂停（类似于Arduino 循环）。

显示环将颜色设置为10新像素

暂停立即阻止当前线程100毫秒。如果正在运行其他事件或永久循环，则它们此时有机会运行。

您要选择还是更改颜色？ 显示环块具有内置的颜色选择器。从色轮中选择颜色以选择颜色，然后单击十个Neopixel环之一以修改其颜色。

如何禁用Neopixel？色轮的中间表示像素不正确。从色轮中选择灰色，然后单击Neopixel环。

您可以在下面的MakeCode编辑器中看到运行中的Blinky块程序。被“放在一起”。单击框中的问号将弹出注释以解释该块的作用。

单击此处以打开此项目的MakeCode编辑器！

在下一部分中，我们将加载将闪烁的代码粘贴到Circuit Playground Express上！

下载和刷新

使用MakeCode将代码轻松导入设备中。您无需在计算机上安装任何软件，该过程分为两个步骤：

步骤1：通过USB连接电路板并进入 bootloader模式

第2步：将.uf2文件编译并下载到您的木板驱动器中

我们将详细介绍这两个步骤。

步骤1：引导加载程序模式

通过USB电缆将电路板连接到计算机。按下重置按钮一次，将板置于引导加载程序模式。

如果这是您第一次运行MakeCode或以前安装了Arduino或CircuitPython的计算机，您可能需要双击重置按钮以使开发板进入引导加载程序模式。

按下重置按钮

当Circuit Playground Express处于Bootloader模式时，所有LED都将变为短暂红色，然后绿色。确认您的状态LED也在红色闪烁 。 您的计算机应显示一个名为“ CPLAYBOOT”的新可移动驱动器

如果所有LED均亮起：计算机仍在安装驱动程序（请稍等，Windows需要一些时间来安装更新。）或USB连接不良。如果您的LED指示灯持续显示红色，请尝试使用新的USB电缆（您可能希望确保USB电缆不仅仅在充电，还需要传输数据）或其他USB端口。

一旦LED都变为绿色，您应该会在文件浏览器的驱动器列表中看到一个CPLAYBOOT驱动器。

我们现在可以编译我们的闪烁代码并将其下载到

div》第2步：编译并下载

让我们首先验证我们的代码是否可以在MakeCode中正确编译。

MakeCode具有内置的模拟器，该模拟器可以在重新启动时重新加载和重新运行代码。这是在将代码移至开发板上之前确保我们的代码进行编译和仿真的一种简便方法。刷新按钮会使用最新版本的块代码重新加载模拟器。

如果收到“我们无法运行此项目”错误，请检查您的代码是否有错误。

如果您的开发板正在模拟器中运行，那么该将其下载到实际开发板上了！点击“下载”按钮。它将生成一个.uf2文件并将其下载到您的计算机（UF2是一种旨在通过USB闪存微控制器的文件格式。）

在程序上复制的常规步骤（并非特定于任何操作系统）

确保您的电路板处于引导加载程序模式。

在您的文件资源管理器中查找由MakeCode生成的.uf2文件。将其复制到“ CPLAYBOOT”卷。

文件传输过程中，板上的状态LED指示灯将闪烁。传输完文件后，开发板将自动重置并开始运行您的代码（就像在模拟器中一样！）

在Mac上，您可以放心地忽略复制.uf2文件后可能出现的“磁盘未正确弹出”通知。

Windows：打开Windows资源管理器（Windows键+ E键），然后找到您生成的“ blinky.uf2”文件。它可能在您的下载文件夹中！

您可以将文件复制/粘贴到您的 CPLAYBOOT 卷中，也可以像在GIF中一样将其拖放到

macOS ：打开Finder并找到“ blinky.uf2”文件。您可以将该文件复制/粘贴到“ cplayboot”卷，或从同一查找程序窗口拖放该文件。

如果要避免复制过程，：您可以将程序直接下载到开发板上。为此，请执行以下操作：将Chrome，Firefox，Safari或Opera中的下载位置更改为“ CPLAYBOOT”卷的主目录。

正在运行已加载的MakeCode

如果您拔下主板，然后再次将其重新插入计算机，则可能不会自动再次运行该程序。如果它显示所有绿色NeoPixels，只需按一下重置按钮，程序就会启动。

保存和共享

是否要更改Blinky程序以显示不同的颜色，或使其播放声音？在Circuit Playground上编辑程序非常简单！

从Circuit Playground提取代码

通过单击MakeCode中的“编译”按钮创建的.uf2文件（CURRENT.UF2）也包含程序的源代码！

您可以打开将该文件拖放到浏览器中以在MakeCode中进行编辑。

分享

您可以通过单击共享按钮来共享代码。确认后，MakeCode将为您的代码创建一个简短的唯一URL。具有该URL的任何人都可以重新加载代码。

这些URL也可以用于将编辑器嵌入您的博客或网页！只需将URL复制粘贴到您的文本编辑器中（如果它支持oEmbed），它将自动将其加载到您的页面中。

编辑JavaScript

如果您已有一定的编码经验，或者准备下一步，MakeCode在浏览器中提供了功能全面的JavaScript编辑器！

阅读JavaScript文档

尝试一下！

您可以也可以通过单击顶部的按钮在块和JavaScript之间切换。

单击此处在MakeCode编辑器中查看此示例！

应用

MakeCode还提供了各种应用，以提供浏览器无法提供的其他功能。

Windows Store

Adafruit Windows Store应用程序的MakeCode。

超级基于HID的快速闪烁：不再需要拖放。

读取调试消息并将其显示在编辑器中（调试消息通过HID发送，而不是CDC Uart/Serial）

Node.JS

（开源）GitHub repo包含有关使用HID闪烁和串行监视运行本地node.js Web服务器的说明。

WebUSB上传

一键式部署

您是否厌倦了一遍又一遍地拖放UF2文件？那么，WebUSB上传适合您！使用WebUSB，您可以将代码直接上传到板上，而无需保存UF2文件，然后将其拖放到闪存驱动器上。只需将USB电缆插入计算机，然后根据需要多次上传代码即可！

要求！

您需要做一些事情才能使用WebUSB

需要使用最新版本的Google Chrome浏览器。 ，Firefox，Safari，Opera，Edge等目前不支持WebUSB。只有Chrome，只有68或更高版本！

运行Windows 10，最新的Mac OS X或Linux。不支持Windows 7或8！

Update Bootloader

您还将需要Circuit Playground Express的最新引导加载程序固件（只需执行一次）。截至2018年7月，我们已在Circuit Playground Expresses上发布了最新的Bootloader，但如果您使用的是旧版本，则不会受到伤害！

点击下载最新的Circuit Playground Express bootloader

更新引导加载程序就像刷新MakeCode程序一样容易。只需按一次（或两次）Reset进入引导加载程序，即可获得一个绿色的NeoPixels环。名为 CPLAYBOOT 的闪存驱动器将显示在操作系统的文件浏览器/查找器中。将通过绿色按钮下载的 update bootloader uf2 文件拖到 CPLAYBOOT 驱动器。此uf2包含一个程序，该程序将解锁引导加载程序部分，更新引导加载程序，然后将其重新锁定。它将覆盖现有的代码，例如CircuitPython或Arduino，因此请确保所有内容都已备份！

特殊的MakeCode URL

启动并运行后，需要转到启用WebUSB的特殊MakeCode链接。使用下面的绿色按钮，或将完整URL复制并粘贴到浏览器中：https://makecode.adafruit.com/？webusb=1#editor

MakeCode WebUSB Beta

项目和扩展

您现有的项目应保留在MakeCode网站，因此您无需复制任何内容。但是，如果安装了任何扩展，则需要重新安装它们。这可以通过单击扩展菜单并选择扩展来完成。

首次设置

一旦您打开chrome和makecode beta URL，就需要将空白程序下载到Circuit Playground Express。在编程区域为空白的情况下，在项目窗口中单击粉红色的下载按钮。将UF2文件保存到硬盘上。按下一次（或两次）“重置”按钮，使Circuit Playground Express进入自举程序模式，以获取绿色的灯光。将板子置于引导加载程序模式时，将UF2文件从硬盘驱动器复制到计算机驱动器列表中显示的CPLAYBOOT驱动器。 UF2文件复制完后，开发板将重置。

这是从Google访问WebUSB功能所必需的铬。第一次，您只需要这样做一次！复制完此UF2之后，希望这将是您最后一次将UF2拖放到设备上！

注意事项

您不必在每次断开USB电缆时都重新配对设备。但是，如果您发现上传按钮停止工作或挂断，则可以尝试使用相同的方法再次配对设备。如果仍然无法连接，请尝试使用其他USB电缆。它必须是USB“ 数据”电缆。如果仍然有问题，请使用右上角齿轮图标旁边问号图标下的 support 链接。

配对设备

将初始UF2复制到闪存驱动器后，单击齿轮右上角Microsoft徽标旁边的滚轮图标。在菜单中找到配对设备链接，然后单击它。

连接PXT设备

单击配对设备后，浏览器URL输入框下方应出现一个弹出窗口。单击蓝色的连接按钮以在您的PXT设备与浏览器之间建立连接。

设备已配对！

您将在屏幕底部附近看到一个不错的通知，告知您设备已成功配对。试试看，然后单击大下载按钮以上传您的代码！

其他好东西

本指南是入门指南，但值得一提的是关于MakeCode的其他功能。..

GitHub软件包

其他块或驱动程序可以打包在github repo中并加载到通过添加软件包对话框进行编辑。软件包可以包含JavaScript，C ++，是的！ ASM！ https://makecode.adafruit.com/packages

我们是开源的在GitHub上

检出https://makecode.com/about，以获取有关各种存储库的更多信息。

责任编辑：wv