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)**选项卡, 搜索 **标头搜索路径(标头搜索路径).

  • 将"标题搜索路径"设置为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可以识别的名字,例如:

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社区论坛 中寻求帮助.