3.7 包含以下更新。

重大更新

统一 Python 环境

太多选择，有时候是一种心理负担

CodeLab Adapter 的扩展系统之前最大的问题是: Python 环境不统一。一会儿是 Adapter 内置的 Python（用于打包），一会儿是用户本地的 Python（用于运行 Adapter Node），一会儿又是完整版里自带的 Python（内置 Node 的依赖）。当事情有太多的选择，时常让人不知所措，很多用户在选择困难中，花费了许多时间。

3.7 版本中(完整版)， Adapte 内部只有一个 Python(>=3.7), 这个环境内置了许多常用第三方库，在自定义插件时，可以使用到它们:

codelab-adapter-client
Flask
ipython
jupyterlab
mcpi
numpy
opencv-contrib-python
paho-mqtt
Pillow
prompt-toolkit
protobuf
PyAutoGUI
pyserial
pyzmq
requests
uflash
websockets
…

更多的内置库参考: CodeLab Adapter wiki

Extension 与 Node

在新的 Python 环境中， Adapter Extension 和 Adapter Node 有什么区别呢？

它们处于同样的 Python 环境。唯一的区别是，Adapter Extension 以线程方式启动， Adapter Node 所在的脚本以进程启动: python xxx.py，在类结构上，Adapter Extension 是 Adapter Node 的子类。Adapter Node 只是普通的 Python 脚本，可以使用本地 Python 启动它（这对于调试很有帮助）。也可以在多台机器上分布式运行（可以是局域网，也可以运行在互联网）。目前Neverland 2.0就是一个范例: 在文档里的简单 demo 中，涉及 3 台计算机直接的消息通信，整个过程简单而快速。

小图标

有若干用户来信提到这个需求: 让 CodeLab Adapter 像 Scratch Link 一样，运行的时候在桌面显示一个小图标，以便于用户管理它（手动关闭它或者打开 WebUI 界面）。

Windows 下：

MacOS 下：

右键小图标，可以做到:

打开 WebUI
关闭 CodeLab Adapter

前端更新提醒

之前 Adapter 搭配的 CodeLab Scratch 因为缓存问题，需要用户主动刷新。这造成许多困扰，用户无从直到我们何时更新了积木，每次清楚浏览器缓存又导致加载缓慢。

在当前版本之后的版本中，前端 UI 会主动提醒用户何时应该更新

ps：如果你之前打开过 CodeLab Scratch，此次需要做最后一次手动浏览器缓存刷新

内置 mDNS 服务

Adapter 3.7 中内置了 mDNS 服务，方便在局域网中以可编程方式发现设备。

Neverland 2.0 插件中使用到它:

当 Adapter 以 NEVERLAND_HUB 模式启动时，Adapter 将作为空间中的主节点，并广播出自己的 mDNS 服务。我们可以在 Scratch 中发现了连接它。

只要安装codelab_adapter_client，你可以让自定义的 Adapter Node 也拥有广播和发现 mDNS 的能力，这对于提供 C 端产品很有用。

这部分相关源码参考: codelab-mdns-*

内置 OSC 服务

OSC (Open Sound Control)是一种用于将声音合成器、计算机和其他多媒体设备联网的协议，用于音乐表演或表演控制等目的。OSC 的优势包括互操作性，准确性，灵活性以及增强的组织和文档。

Adapter 同时内置 OSC server 和 OSC client！

通过兼容这个标准协议，我们可以使用几乎所有市面上主流的 OSC client。

如此一来，CodeLab Adapter 甚至可以接管整个音乐厅！

以下是利用 OSC client 做的一个例子(高速刷新):

如果你使用 iPhone 或者其他支持压力输入的屏幕，可以通过按压力度控制画笔粗细。

建恩同学将 CodeLab Adapter 的 OSC 消息桥接到了 midi 协议, 进而可以与所有主流的专业音乐软件交互：

目前正与 Rick 一起探索在音乐领域的可能性（诸如与 vvvv 协同）。

可编程的固件刷入接口

1
2
3


from codelab_adapter.utils import flash_usb_microbit, flash_makecode_file
# flash_usb_microbit(py_file_path)
# flash_makecode_file(makecode_hex_path)