Xcode

Xcode 是一个免费的macOS专用IDE, 你可以从Mac App Store下载它.

导入项目

  • 在Xcode的主屏幕上, 使用 Other > External Build System [其他>外部构建系统]模板创建一个新项目.

../../../_images/xcode_1_create_external_build_project.png

  • 从 Targets 部分打开您的构建目标, 并选择 Info 标签.

  • 按以下设置填写表格:

    构建工具

    scons 可执行程序一个完整路径, 例如 /usr/local/bin/scons

    参数

    参见 构建系统介绍, 获取完整的参数列表.

    目录

    到Godot根文件夹的完整路径

../../../_images/xcode_2_configure_scons.png

  • 通过选择 File > New > Target… [文件 > 新建 > 目标…], 添加一个命令行工具目标, 它将用于为项目建立索引.

../../../_images/xcode_3_add_new_target.png

  • 选择 OS X > Application > Command Line Tool .

../../../_images/xcode_4_select_command_line_target.png

备注

为它命名, 以使您知道不使用该目标进行编译(例如 GodotXcodeIndex).

  • 前往新创建的目标(target)的 构建设置(Build Settings) 选项卡, 搜索 标头搜索路径(标头搜索路径) .

  • 将 Header Search Paths 设置为 Godot 根文件夹的绝对路径。子目录也需要包含进来，为此，请在路径末尾添加两个星号（**），例如 /Users/me/repos/godot-source/**。

  • 将Godot源码拖放到项目文件浏览器中, 将其添加到项目中.

  • 取消勾选 创建外部构建系统(Create External Build System) .

../../../_images/xcode_5_after_add_godot_source_to_project.png

  • 接下来, 为 添加的文件夹(Added folders) 选项选择 创建组(Create groups) , 并在 添加到目标(Add to targets) 部分中选中 仅 您的命令行索引目标.

../../../_images/xcode_6_after_add_godot_source_to_project_2.png

  • Xcode现在将索引这些文件. 这可能需要几分钟的时间.

  • 一旦Xcode完成了索引, 你应该有跳转定义, 自动完成和完整的语法突出显示.

调试项目

要启用调试支持, 需要编辑外部构建目标的构建和运行方案.

  • 打开外部构建目标的方案编辑器.

  • 定位到 Build > Post Actions 区.

  • 增加一个新的脚本运行操作

  • 在 Provide build settings from [提供构建设置]下选择你的项目. 这允许在脚本中引用项目目录.

  • 创建一个脚本, 给二进制文件起一个Xcode可以识别的名字, 例如:

  1. ln -f ${PROJECT_DIR}/godot/bin/godot.osx.tools.64 ${PROJECT_DIR}/godot/bin/godot

../../../_images/xcode_7_setup_build_post_action.png

  • 构建外部构建目标.

  • 再次打开方案编辑器, 然后选择 运行 .

../../../_images/xcode_8_setup_run_scheme.png

  • 将 可执行文件(Executable) 设置为您在传递构建动作脚本中链接的文件.

  • 勾选 调试可执行文件(Debug executable) (如果还未准备好).

  • 你可以在 Arguments 选项卡上添加两个参数: -e 标志打开编辑器而不是项目管理器, --path 参数告诉可执行文件打开指定的项目(必须提供项目根目录 绝对 路径, 而不是 project.godot 文件).

要检查一切是否正常, 请在 platform/osx/godot_main_osx.mm 中放置一个断点并运行项目.

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