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

代码风格配置

在编辑任何文件以前,请记住,所有的代码文件都应该遵守ref:doc_code_style_guidelines .与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做贡献了.记得保存项目文件和 工作区 . 如果遇到任何问题,请在 `Godot的社区频道<https://godotengine.org/community>`__ 中寻求帮助.