Eclipse是一款广泛用于Java开发的集成开发环境(IDE),但有着强大的插件体系允许自定义开发其它语言及用途。
相对于使用普通的文本编辑器,使用形如Eclipse这样的IDE有着诸多好处,例如:
本文专注于阐述如何将Eclipse配置为AVR软件开发环境,并用于基于QMK代码的开发工作。
注意,在本文编写时,仅在Ubuntu 16.04环境中进行过验证。
在开始之前,你需要确保遵循了新手教程中的新手指引一节。通常,此时你应该具备了通过 qmk complile
命令构建固件文件的能力。
Eclipse为Java程序,因此需要安装Java 8或更高版本才能运行。你可以选择JRE或JDK,后者在进行Java开发时需要用到。
Eclipse有多种可选安装方式,取决于你的使用目标。目前没有完备的AVR开发栈安装包,所以我们需要从Eclipse CDT(C/C++ 开发工具环境)开始并安装对应的插件。
如果系统中已安装了Eclipse CDT,可以跳过本步骤。同时,为了确保版本支持情况,我们推荐保持其更新至最新版。
如果你已安装了Eclipse包,通常也可以在上面再安装CDT插件。但是可能更好的方案是重新全新安装一下,以确保环境轻量,以及防止已安装的工具对后续的工程开发工作产生干扰。
安装很简单:遵循Eclipse安装5步走,并在第三步选择 用于C/C++开发者的Eclipse IDE(Eclipse IDE for C/C++ Developers)。
此外,也可以选择直接下载 用于C/C++开发者的Eclipse IDE(最新版直达链接)并解压至任意目录下(会生成 eclipse
目录)。
在安装完毕后,点击运行按钮。(如果是手动解压的,请在安装目录下双击 eclipse
可执行程序
在提示你选择工作区目录时,选择一个可用于存储Eclipse元数据及工程的目录。不要选择 qmk_firmware
目录,这是你的项目目录。可以使用其父目录,或其它(最好是空)目录(默认目标目录如果未作他用亦可使用)。
启动后,点击右上角的工作台(Workbench)按钮切换到工作台视图(启动时的欢迎页最下方有个确认框可以在下次启动时不再展示欢迎页)。
注意:无需在每个插件安装完成时重启Eclipse,全部安装完毕后重启一次即可。
这是最重要的一个插件,可以帮助Eclipse理解AVR下的C语言代码。参照执行更新网址使用指引,并允许那些未签名内容产生的警告。
该插件可以允许QMK makefile产生的具有颜色标记的构建输出信息能够正确显示。
在插件皆安装完毕后,依照提示重启Eclipse。
¹ 导入工程时若自定义名称有时会遇到些问题,如果行不通,保留默认的工程名(即目录名,通常是 qmk_firmware
)再试一次。
我们将默认构建目标从 all
调整到我们期望构建的键盘及键映射组合上,即 kinesis/kint36:stapelberg
。此时,形如清理、构建等工程级别的操作可以很快地执行完毕,而不至于耗费大量时间且导致Eclipse卡住。
工程
> 属性
窗口, 选择 C/C++构建
菜单项并切至 Behavior
标签。Make build target
选项中的全量构建 all
改为 kinesis/kint41:stapelberg
。工程
> 清理...
以确认配置正确。