CodeCanvas 使用手册

简介...........................................................................................................................................2 启动CodeCanvas ......................................................................................................................2 CodeCanvas界面说明 ..............................................................................................................2

CodeCanvas菜单 ..............................................................................................................3 CodeCanvas项目树 ..........................................................................................................4 CodeCanvas代码窗口 ......................................................................................................4

项目的使用...............................................................................................................................4 新建一个项目...................................................................................................................4 新建文件到项目...............................................................................................................5 加入文件到项目...............................................................................................................6 从项目删除文件...............................................................................................................8 编译（Compile） .............................................................................................................9 构建(Build) .......................................................................................................................9 项目设置...........................................................................................................................9

Java项目设置............................................................................................................9 设置Java开发环境....................................................................................................9 在CodeCanvas中进行设置.....................................................................................10 在windows中设置path环境变量............................................................................10 C/C++项目设置......................................................................................................11 设置C/C++开发环境..............................................................................................12

自定义项目的设置.........................................................................................................13 代码色彩设置.................................................................................................................13

简介

CodeCanvas(代码编辑器)提供了一个编写各种程序代码的环境。AIROBOT 使用它作为默认

的机器人开发环境，它也可以用来编写普通的应用程序。CodeCanvas 还可以和第三方开发

工具配合使用，提供更加完善的程序开发功能。 在使用 CodeCanvas 的过程中，根据各人使用的不同操作系统以及 AI-CODE 的不同版本或

者更换了不同的皮肤，以下出现的界面图片与实际情况可能有所差异。

启动 CodeCanvas

有以下几种启动 CodeCanvas 的方式： 1. 在 AIROBOT 中，选择工具->代码编辑器。 2. 运行安装目录中的 codecanvas.exe，这时 CodeCanvas 将作为一个单独的程序来运行。 3. 桌面或开始菜单中的快捷方式。(只有特定版本的 AIROBOT 提供)。

CodeCanvas 界面说明

启动 CodeCanvas,我们将看到 CodeCanvas 的主窗体

上图各部分的说明如下表:

界面 说明

菜单栏 显示 CodeCanvas 的快捷菜单

项目树 此窗口显示所有打开的项目的树状结构

代码窗口 显示打开的代码文件

CodeCanvas 菜单

CodeCanvas 的菜单栏共包含 六个一级主菜单：文件，编辑，项目，构建，设置，帮助。简

单说明见下表：

主菜单 子菜单 功能说明

新建项目.. 打开新建项目子菜单

新建文件.. 打开新建文件对话框

打开 打开文本文件

保存 保存当前文件

另存为.. 把当前文件另存为

全部保存 保存全部打开的文件

关闭 关闭当前文件

全部关闭 关闭所有打开的文件

文件

退出 退出 CodeCanvas

撤销 撤销上一次代码编辑操作

重做 重做上次被撤销的操作

剪切 把选中的代码剪切到剪贴板

复制 把选中的代码复制到剪贴板

粘贴 把剪贴板中的内容复制到指定

位置

删除 删除选中的代码

查找 查找编辑器中的文本

编辑

替换 用指定文本替换选中的文本

打开项目 打开一个工程项目

关闭项目 关闭当前的工程项目

新建.. 打开新建项目子菜单

项目

环境设置 设置当前项目的环境

编译文件 编译当前打开的文件

构建项目 构建当前打开的项目

构建

运行 运行当前打开的项目

字体 设置显示代码的字体

Java 环境设置 设置 Java 编译环境

设置

C/C++环境设置 设置 C/C++编译环境

帮助 打开帮助文档 帮助

关于 打开 CodeCanvas 关于信息

CodeCanvas 的菜单栏 还包含一个个二级主菜单：新建项目。简单说明见下表：

Java 项目 新建一个 Java 项目

C/C++项目 新建一个 C/C++项目

新建项目..

自定义项目 新建一个自定义项目

CodeCanvas 项目树

项目树显示了所有打开的项目工程的一个树状结构，并且也以树状结构显示项目工程里面的

内容。 见 CodeCanvas 界面说明中 CodeCanvas 主窗体的图示，可以看到，上面有一个打开

的项目，其中 mine.MyProject 是项目名，其下的 mine 是其中的一个包（子文件夹），mine中有个 MyProject.java 是项目中 mine 包下的文件。更详细的信息请见第二节，CodeCanvas项目工程的使用。

CodeCanvas 代码窗口

代码窗口就是显示和编辑程序代码的窗口，对于已知的程序代码，代码窗口会对关键字彩色

显示，代码自动缩进等，更详细的信息请见第三节，程序语言的语法设置。

项目的使用

CodeCanvas 提供一个简单的项目工程模式，可以通过项目工程的模式管理自己的程序开发。 下面介绍怎样使用 CodeCanvas 的这项功能。

新建一个项目

新建 Java 项目：选择菜单 项目->新建->Java 项目 创建一个 Java 项目，首先会让你选择项

目所在的文件夹，如下图：

选取文件夹后，会让你输入项目名称，见下图：

之后，项目就建成了，如果我选择 E:\projects 为项目所在文件夹，项目名为 FirstProject，你

会在项目树看到这个工程，如下图：

C/C++项目，自定义项目的创建过程和这完全一样。

新建文件到项目

上一步完成后，我们建立了一个 Java 项目，但是这个项目还是一个空的项目，要往项目中

新建文件，可以通过鼠标右键点击项目，在弹出的菜单中选择新建文件..如下图：（或者通过

菜单 文件-〉新建文件 也一样）

选择了新建文件..后会弹出新建文件对话框，如下图：

你需要输入文件名，选择文件类型，文件类型<Auto>代表根据文件后缀名来自动判断，文

件位置是这个文件需要放置的目录路径，下面的加入到项目选项是指这个文件是否需要加入

到指定的项目中，如果是，那么前面设置的文件位置必须在这个项目的工作目录下才行。

后点击确定，文件机会被创建和打开。

加入文件到项目

要往项目中加入文件，可以通过鼠标右键点击项目，在弹出的菜单中选择添加文件..如下图：

选择了添加文件..后会弹出对话框让你选择要添加的文件，你可以选择一个已经存在的文件，

也可以输入一个文件名，然后确定，CodeCanvas 会创建这个文件并加入项目中，如下图：

这里输入了 utils\Util.java，意思是要加入 utils 子文件夹中的 Util.java 文件，如果此目录和文

件存在，则 CodeCanvas 会加入此文件，如果不存在，CodeCanvas 会创建目录和文件，然后

加入文件到项目。此时双击项目树展开项目树就可以看到此文件，双击文件可打开编辑此文

件，如下图：

用刚才的方法我又继续加入了 utils\next\Next.java 和 utils\next\First.java。

从项目删除文件

如果此时我要删除一些文件或者文件夹，可以在项目树中选中你要删除的元素，右键菜单中

选择删除,如下图：

同样在文件夹 utils.next 上此功能也管用，但是注意删除动作有两种，一个是只是删除项目

中的索引，文件不会被删除，一个是删除索引同时也删除文件，根据删除动作弹出的对话框

你可以选择，还有文件夹和项目的删除不一定会把目录中的所有文件删除，如果目录中存在

着其他不 在项目索引（也就是项目树）中的文件，这些文件可能不会被删除。

编译（Compile）

动作正如菜单名编译文件一样，是针对文件的，打开需要编译的文件，选择菜单或者按快捷

键 F5 即可编译此打开的文件

构建(Build)

动作正如菜单名构建项目一样，是针对项目的，打开需要建建的项目，选择菜单或者按快捷

键 F7 即可编译构建此打开的项目。

项目设置

编译和构建动作要成功，必须要有正确的项目设置，不同类型的项目有不同的设置选项，通

过选择菜单 项目->项目设置 或者右键点击项目，在弹出菜单中选择项目设置，就可以看到

对应项目的环境设置对话框。

Java 项目设置

如图：

类路径（classpath）是你所用到的类的路径。 注意要使 Java 项目能够编译，还必须设置好

Java 环境，参见设置 Java 开发环境。

设置 Java 开发环境

编译 java 程序必须使用 java 编译器，有两种方式可以对其进行设置。你可以在 CodeCanvas中进行设置，也可以直接在 windows 的环境变量中进行设置。这里假设您的 JDK 安装在

C:\j2sdk1.4.2

在 CodeCanvas 中进行设置

打开CodeCanvas，在CodeCanvas中选择 设置-〉java环境设置，然后在出现的java环境设置

对话框中输入jdk的安装路径C:\j2sdk1.4.2，也可以通过浏览/browse按钮在文件系统中查找。

在 windows 中设置 path 环境变量

我的电脑-〉右键-〉高级-〉环境变量。

如果您的系统系统中已经存在名为 path 的环境变量，则编辑这个变量（点击编辑按钮），在

原有路径的后面添加 C:\j2sdk1.4.2（路径之间用分号隔开）。

如果您的系统中没有名为 path 的环境变量就新建一个（点击新建按钮），添加 C:\j2sdk1.4.2。

在 windows 中设置 path 环境变量后，您既可以在 codecanvas 中使用 java 编译器，也可以在

命令行中使用这个编译器以及其他 java 工具。

C/C++项目设置

如图：

如图所示 C/C++环境设置比 java 的要复杂些，其中"build.bat"是我们默认提供的一个编译脚

本，它适用于大多数项目和常用的 C/C++编译器。注意要使 C/C++项目能够正确编译，还必

须设置好 C/C++环境，参见设置 C/C++开发环境。当然您也可以根据实际需要在这里进行相

应的设置，或则编写自己的编译脚本。

设置 C/C++开发环境

在使用 CodeCanvas 来开发 C/C++项目之前，要为其配置 C/C++开发环境。CodeCanvas 实际

上只是提供了一个代码编辑的功能，并没有提供编译 C/C++程序的功能，所以 CodeCanvas必须与第三方 C/C++开发工具配合使用。CodeCanvas 可以直接和下列工具配合使用： 公司 工具 类型

Microsoft Visual Studio .NET 2003 IDE

Microsoft Visual Studio 6.0 IDE

Borland C++ Builder 6 IDE

Microsoft Visual C++ Toolkit 2003 命令行

Borland C++ Compiler 5.5 命令行

GNU GCC 命令行 表中列出的的几种命令行工具都是免费的，而且占用空间小，使用简单。一般命令行开发工

具都不提供代码编辑和项目管理的功能，而 CodeCanvas 正好提供了这些功能，两者正好形

成互补，建议不熟悉 IDE 开发环境的初学者选择命令行工具配合 CodeCanvas 来进行开发。

当然，如果您的系统里已经安装了某个 IDE 开发环境，也可以在 CodeCanvas 中直接使用它。

如果您的系统当中没有安装 CodeCanvas 所支持的 C/C++开发工具，请先安装其中一个。 打开CodeCanvas，在CodeCanvas中选择 设置-〉C/C++环境设置，在工具下拉列表中选择

其中一个工具，然后在安装目录里输入该工具的安装路径，点击完成按钮。

对于这些开发工具，无需设置任何环境变量，也不需要对项目的构建器路径进行设置，这里

的设置也不会影响到第三方开发工具。对于这里没有给列出的开发工具，需要在环境变量和

项目设置里面进行相应的设置，才能与 CodeCanvas 配合使用。

自定义项目的设置

如图：

可以看出，实际上这是一个简化的 C/C++环境设置，为了更好的兼容不同的编译器，所以才

做此简化，当然你完全可以在这里设置 C/C++的环境，并用此编译建造 C/C++工程，如果你

要这么做，你就要把 C/C++环境中的需要构建的源文件属性并和到自定义构建参数中，当然，

这是可行的但是比较麻烦。不光是 C/C++，其他语言应该也能通过正确的设置达到在

CodeCanvas 中编写编译的目的。

代码色彩设置

CodeCanvas 目前支持四种语法,普通文本(Text)、Java、C/C++、ActionScript，如果你打开这

四种类型的文档，就会得到对应的语法彩色显示，代码缩进等功能，当然，你也可以自己添

加或者修改语法，在 CodeCanvas 的安装目录下的 property\editor\syntaxs 子目录下可以找到

一些 syn 为后缀明的文件，这些就是语法定义文件，如果你要修改定义，打开相应的的 syn文件修改保存，重起 CodeCanvas，修改就会生效，如果你要增加一个语言的语法，打开

LANGUAGE EXAMPLE.txt，这是一个语法模版，修改此模版为你想要的语法定义，然后保

存为 syn 后缀的文件到 property\editor\syntaxs 目录，重起 CodeCanvas 你就会在文件->新建

文件..菜单中看到你定义的语言的菜单项了。