Xcоde

Xcode — бесплатная IDE, доступная только для macOS. Вы можете скачать её из Mac App Store.

Импортирование проекта

  • На главном экране Xcode создайте новый проект, используя шаблон Other > External Build System (Другое > Внешняя система сборки).

../../../_images/xcode_1_create_external_build_project.webp

  • Теперь выберите имя для вашего проекта и укажите путь к исполняемому файлу scons в инструменте сборки (чтобы узнать путь, введите where scons в терминале).

../../../_images/xcode_2_set_external_build_project_parameters.webp

  • Откройте основную цель из раздела Targets (Цели) и выберите вкладку Info (Информация).

../../../_images/xcode_3_configure_scons.webp

  • Заполните форму, указав следующие параметры:

    Аргументы

    Полный список аргументов см. в документе Введение в систему сборки.

    Каталог

    Полный путь к корневой папке Godot

  • Добавьте Целевой Инструмент Командной Строки, который будет использоваться для индексации проекта, выбрав File > New > Target... (Файл > Создать > Цель...).

../../../_images/xcode_4_add_new_target.webp

  • Выберите macOS > Application > Command Line Tool.

../../../_images/xcode_5_select_command_line_target.webp

Примечание

Назовите его так, чтобы вы знали, что не нужно компилировать с этой целью (например, GodotXcodeIndex).

  • Для этой цели откройте вкладку Build Settings и найдите Header Search Paths.

  • Установите в Header Search Paths абсолютный путь к корневой папке Godot. Вам также нужно включить подкаталоги. Для этого добавьте две звездочки (**) в конец пути, например /Users/me/repos/godot-source/**.

  • Добавьте исходный файл Godot в проект, перетащив его в обозреватель файлов проекта.

  • Выберите Create groups для параметра Added folders и отметьте только вашу цель индексирования командной строки в разделе Add to targets.

../../../_images/xcode_6_after_add_godot_source_to_project.webp

  • Xcode сейчас проиндексирует файлы. Это может занять несколько минут.

  • После того как Xcode завершит индексацию, у вас должны появиться переход к определению, автодополнение и полная подсветка синтаксиса.

Отладка проекта

Чтобы включить поддержку отладки, вам необходимо отредактировать схемы сборки и запуска внешней цели сборки.

  • Откройте редактор схемы внешней цели сборки.

  • Найдите раздел Build > Post Actions.

  • Добавить новое действие запуска скрипта

  • В разделе Provide build settings from (Предоставить параметры сборки из) выберите свой проект. Это позволит ссылаться на каталог проекта в скрипте.

  • Создайте скрипт, который даст двоичному файлу имя, которое Xcode может распознать, например:

ln -f ${PROJECT_DIR}/godot/bin/godot.macos.tools.64 ${PROJECT_DIR}/godot/bin/godot
../../../_images/xcode_7_setup_build_post_action.webp

  • Соберите внешнюю цель сборки.

  • Откройте редактор схем снова и выберите Run.

../../../_images/xcode_8_setup_run_scheme.webp

  • Установите Executable на файл который вы присоединили к вашему скрипту сборки.

  • Проверьте Debug executable.

  • На вкладке Аргументы можно добавить два аргумента: флаг -e открывает редактор вместо Менеджера Проектов, а аргумент --path указывает исполняемому файлу открыть указанный проект (должен быть указан как абсолютный путь к корню проекта, а не к файлу project.godot).

Чтобы проверить, что все работает, поставьте точку останова в platform/macos/godot_main_macos.mm и запустите проект.

Если у вас возникнут какие-либо проблемы, обратитесь за помощью в один из каналов сообщества Godot.