Code::Blocks

Code::Blocks 是一款免费开源且跨平台的IDE.

创建一个新项目

在 Code::Blocks 的主界面, 点击 创建一个新的项目 或选择 文件 > 新建 > 项目... .

../../../_images/code_blocks_file_new_project.png

打开 新建模板(New from template) 窗口中, 从 项目(Projects) 中, 选择 空项目(Empty project) , 然后点击 前往(Go) .

../../../_images/code_blocks_new_empty_project.png

单击 "下一步", 将欢迎传递到新的空项目向导中.

../../../_images/code_blocks_wizard_welcome.png

项目文件应该在克隆的项目文件夹的根目录下创建. 要做到这一点, 首先, 确保 项目标题 与Godot被克隆到的文件夹名称相同. 除非你将项目克隆到一个不同名称的文件夹中, 否则将是 godot .

其次, 确保 创建项目的文件夹 是你运行Git克隆命令的文件夹, 而不是 godot 项目文件夹. 确认 结果文件名 字段将在克隆的项目文件夹的根目录下创建项目文件.

../../../_images/code_blocks_project_title_and_location.png

编译器和配置设置是通过 SCons 管理的, 稍后将进行配置. 然而, 值得取消选择 Create "Release" 配置 选项;因此在点击 Finish 之前, 只创建一个构建目标.

../../../_images/code_blocks_compiler_and_configuration.png

配置构建

第一步是更改项目属性. 右击新项目, 选择 属性... .

../../../_images/code_blocks_open_properties.png

勾选 This is a custom Makefile 属性. 单击 "确定" 保存更改.

../../../_images/code_blocks_project_properties.png

下一步是更改构建选项. 右键点击新项目, 选择 构建选项... .

../../../_images/code_blocks_open_build_options.png

选择 "Make "命令 选项卡, 删除所有构建目标的所有现有命令. 对于每个构建目标, 在 Build project/target 字段中输入用于创建所需构建的 SCons 命令. 最小值为 scons . 关于 SCons 构建选项的详细信息, 请参见 构建系统介绍 . 将 Clean project/target 字段中的 scons --clean 命令添加到项目的默认命令中也很有用.

如果你使用的是Windows, 所有的命令都需要在前面加上 cmd /c 来启动命令解释器.

../../../_images/code_blocks_scons_minimum.png
../../../_images/code_blocks_scons_clean.png

Windows示例:

../../../_images/code_blocks_scons_windows.png

Code::Blocks现在应该被配置为构建Godot;所以选择 Build > Build , 点击齿轮按钮, 或者按 Ctrl + F9.

配置运行

一旦 SCons 成功构建了所需的目标, 重新打开项目 Properties... 并选择 Build targets 选项卡. 在 输出文件名 字段, 浏览到 bin 文件夹, 选择编译文件.

取消这 Auto-generate filename prefix and [自动生成文件名前缀]*Auto-generate filename extension*[自动生成文件名扩展名 选项.

../../../_images/code_blocks_build_targets.png

Code::Blocks现在应该被配置为运行你的编译后的Godot可执行文件;所以选择 Build > Run , 点击绿色箭头按钮, 或者按 Ctrl + F10.

还有两点值得注意. 首先, 如果需要, Execution working dir 字段可用于测试特定项目, 将其设置为包含 project.godot 文件的文件夹. 其次, Build targets 选项卡可用于添加和删除构建目标, 以便使用和创建不同的构建.

将文件添加到项目

要将所有Godot代码文件添加到项目中, 右击新项目, 选择 递归添加文件... .

../../../_images/code_blocks_add_files_recursively.png

它应该会自动选择项目文件夹;所以单击 打开 . 默认情况下, 所有的代码文件都已被包含在内, 所以只需单击 确定 即可.

../../../_images/code_blocks_select_files.png

代码风格配置

在编辑任何文件以前, 请记住, 所有的代码文件都应该遵守 代码风格指南 . 与Godot中的一个很大的不同是tab缩进的使用. 因此, 需要启用Code::Blocks编辑器设置中的tab缩进. 该设置可以在 Settings > Editor 中找到.

../../../_images/code_blocks_update_editor_settings.png

General Settings(常规设置) --> Editor Settings(编辑器设置) --> tab选项 下单击 Use TAB character(使用TAB字符) .

../../../_images/code_block_use_tab_character.png

这样一来,你就可以开始使用 Code::Blocks IDE 来向 Godot 贡献代码了。记得保存项目文件和 Workspace 。如果遇到了问题,可以在 Godot 的社区频道 中求助。