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.

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可执行文件的完整路径.

调试项目

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

  • Under Executable specify the path to your executable located in the <Godot root directory>/bin folder. The name depends on your build configuration, e.g. godot.linuxbsd.editor.dev.x86_64 for 64-bit LinuxBSD platform with platform=editor and dev_build=yes. You can use %{buildDir} to reference the project root, e.g: %{buildDir}/bin/godot.linuxbsd.editor.dev.x86_64.

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

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

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

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

代码风格配置

开发人员必须遵循项目的代码风格,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 社区论坛 中寻求帮助.