开发指南

该文档介绍了 Wide 的核心设计原理与实现。

如果您要看 Wide 的源码或者要进行修改、二次开发等,请先仔细阅读该文档。

关键设计

工作空间

Wide 是一个多用户的集成开发环境,每个用户的工作空间是完全隔离的:

例如在执行“构建 & 运行”时,Wide 会设置命令 go build 执行的环境变量 $GOPATH 为用户的工作空间,这样编译过程就是在该用户的工作空间中进行,保证其隔离性。

Wide 会话

在 UI 上存在两种 tab:浏览器 tab;编辑器 tab。 用户可以在一个浏览器 tab 中打开多个编辑器 tabs,但输出窗口只有一个。这意味着一个浏览器 tab 只能有一个正在运行的用户代码的程序进程。 需要同时运行多个程序进程的场景可以通过打开多个浏览器 tabs 达成。

一个浏览器 tab 对应一个 Wide 会话:只要打开/刷新一个 tab,就会新建一个 Wide 会话。

WebSocket

WebSocket 用于后端推送数据给前端:

通道和会话一对一关联,也就是说如果用户新开浏览器 tab,则新建通道何其关联。

事件与通知

每个会话都有一个对应的事件队列,当接收到事件时取出该事件并转为通知,再通过通知窗口通道推送给前端。 还存在一个全局事件队列,入队的事件将分发到每个用户的事件队列中,以便进行通知广播。

通知中的消息需要国际化处理。在语言配置文件中以 notification_ 为前缀,事件代码(event code)为后缀的项即通知消息。

代码辅助

代码辅助功能必须满足工作空间隔离。

编码规范