Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

Qt Creator

Qt Creator 是一个自由、开源的 IDE，适用于所有桌面平台。

导入项目

  • 在Qt Creator的主屏幕上选择 New Project > Import Project > Import Existing Project .

../../../_images/qtcreator-new-project.png

  • 在 Location 项下选择 Godot 源代码目录的绝对路径.

../../../_images/qtcreator-set-project-path.png

  • 接下来, 你可以选择哪些文件夹和文件将对项目可见. 虽然C/C++文件是自动添加的, 但其他扩展名也可能是有用的. *.glsl 用于着色器文件, *.py 用于构建系统文件, *.java 用于Android平台开发, *.mm 用于MacOS平台开发.

../../../_images/qtcreator-apply-import-filter.png

备注

你可以在之后通过在你的项目上右键选择 编辑文件.. 选项来更改此配置.

../../../_images/qtcreator-edit-files-menu.png

  • 完成导入.

  • 打开 project_name.includes 文件, 并在其中添加包含 . 的行, 以正确启用代码自动完成功能.

../../../_images/qtcreator-project-name-includes.png

  • 从左侧菜单选择 Projects , 并打开 Build 标签.

  • 删除预定义的 make 构建步骤.

../../../_images/qtcreator-projects-build.png

  • 单击 Add Build Step > Custom Process Step , 以添加具有以下设置的新构建步骤:

    命令

    scons

    参数

    参见 构建系统介绍, 获取完整的参数列表.
../../../_images/qtcreator-set-scons-command.png

备注

如果编译失败, Could not start process "scons" , 这可能意味着 scons 不在你的 PATH 环境变量中. 在这种情况下, 你必须指定SCons可执行文件的完整路径.

调试项目

  • 从左侧菜单选择 项目 , 并打开 运行 选项卡.

  • 在 可执行文件（Executable） 一栏中，指定位于 <Godot root directory>/bin 文件夹下的可执行文件路径。文件名取决于你的编译配置，例如，针对 64 位 LinuxBSD 平台，并使用了 platform=editor 和 dev_build=yes 参数编译时，文件名会是 godot.linuxbsd.editor.dev.x86_64 。你可以使用 %{buildDir} 来引用项目的根目录，例如： %{buildDir}/bin/godot.linuxbsd.editor.dev.x86_64 。

  • 如果你想运行一个特定的项目, 在 工作目录 下指定其根文件夹.

  • 如果你想运行编辑器, 请在 命令行参数 栏中添加 -e .

../../../_images/qtcreator-run-command.png

要了解更多的命令行参数, 请参考 命令行教程 .

代码风格配置

开发者必须遵循项目的 code style ，而 IDE 也应该辅助他们遵守这些规范。默认情况下，Qt Creator 使用空格来进行缩进，但这并不符合 Godot 的代码风格指南。你可以通过在 Tools > Options > C++ 中更改 Code Style 来修改这一行为。

../../../_images/qtcreator-options-cpp.png

点击 Edit 来改变当前的设置, 然后点击 Copy Built-in Code Style 按钮来设置一个新的代码风格. 为它设置一个名称(如Godot), 并将Tab策略改为 Tabs Only .

../../../_images/qtcreator-edit-codestyle.png

如果遇到问题, 也可在 Godot 社区论坛 中寻求帮助.