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

Configuring the build

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

../../../_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**构建选项的详细信息,请参见:ref:doc_introduction_to_the_buildsystem。将**Clean project/target**字段中的``scons --clean``命令添加到项目的默认命令中也很有用。

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

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

Windows example:

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

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

Configuring the run

一旦**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**,点击绿色箭头按钮,或者按:kbd:Ctrl + F10

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

Adding files to the project

要将所有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>`__ 中寻求帮助。