跳到主要内容

使用VS Code开发应用

安装 VS Code

VS Code 是一个轻量级编辑器。

安装 clx-language 插件

  1. 打开 VS Code

  2. 打开 View > Command Palette…

    你也可以使用快捷按键Ctrl / Cmd + Shift + U

  3. 输入「install」,然后选择 Extensions: Install Extensions

    你也可以使用快捷按键Ctrl / Cmd + Shift + P

  4. 在扩展搜索输入框中输入「clx」或「coloplay」,然后在列表中选择 clx-language 并单击 Install

  5. 点击 Reload to Activate 以重新启动 VS Code。

您可以使用本插件开发基于LUA扩展语法的CLX程序,该程序可在Lifesmart发布的ColoPlay设备上运行,本插件提供了开发调试相关环境,您可以使用本插件实现:

  • CLX语法高亮、语法提示
  • ColoX相关接口提示
  • 编译文件并在ColoX模拟器中运行
  • 断点调试

插件的运行环境

本插件目前仅支持Win32和OSX环境,并且需要预先配置好JAVA_HOME环境,目前支持Java11及以上版本,如果您不希望修改系统环境中原有的的JAVA_HOME变量,也可以修改本插件的相关配置项

插件的配置项

  • Select debugger,本插件内置了ColoPlay和Nature两种模拟器程序
    • Default,本插件会根据文件首行标识的设备规格选择(推荐)
    • Nature,会无条件使用Nature模拟器程序(win32暂不支持)
    • Custom,根据配置项Custom debugger path使用用户指定的程序(一般用户无需使用)
  • Custom debugger path,用户指定模拟器程序路径
  • JAVA_HOME,上述运行环境中提到的自定义配置项

使用

新建文件

新建clx后缀的文件,可以输入template,插件会提示内置的应用初始模板

create

在模拟器中运行文件

当鼠标焦点处于clx文件时,点击右上角运行按钮(也可使用F5快捷键)运行文件,即可打开模拟器并运行该文件,同时会在同级目录下生成rom文件

image

调试

模拟器内置了调试器,本插件提供简单的断点及命令行调试功能

  1. 左边栏切换到 Debug
  2. 点击 Run and Debug,会启动模拟器并打开一个名为 debug_temp.clx 的新文件,该文件包含lua区域包含的所有代码
  3. 基于 debug_temp.clx 文件进行断点调试
  4. 也可以在 DEBUG CONSOLE 中进行命令行调试 输入 help 可查看使用帮助

image