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...

Xcode

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

  • Відкрийте головну ціль у розділі Цілі та виберіть вкладку Інформація.

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

  • Заповніть форму з такими параметрами:

    Аргументи

    Перегляньте Знайомство з системою побудови повний список аргументів.

    Довідник

    Повний шлях до кореневої папки Godot

  • Додайте ціль інструмента командного рядка, який використовуватиметься для індексування проекту, вибравши Файл > Створити > Ціль....

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

  • Виберіть macOS > Програма > Інструмент командного рядка.

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

Примітка

Назвіть його як-небудь, щоб ви знали, що не компілювати з цією метою (наприклад, GodotXcodeIndex).

  • Для цієї цілі відкрийте вкладку Налаштування збірки та знайдіть Шляхи пошуку заголовків.

  • Встановіть Шляхи пошуку заголовків на абсолютний шлях до кореневої папки Godot. Вам також потрібно включити підкаталоги. Для цього додайте дві дві зірочки (**) у кінець шляху, наприклад. /Users/me/repos/godot-source/**.

  • Додайте джерело Godot до проекту, перетягнувши його в браузер файлів проекту.

  • Виберіть Створити групи для параметра Додані папки та позначте лише ціль індексування командного рядка в розділі Додати до цілей.

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

  • Тепер Xcode проіндексує файли. Це може зайняти кілька хвилин.

  • Коли Xcode завершить індексування, ви повинні мати перехід до визначення, автозавершення та повне підсвічування синтаксису.

Налагодження проекту

Щоб увімкнути підтримку налагодження, вам потрібно відредагувати схеми збирання та запуску зовнішньої цілі збірки.

  • Відкрийте редактор схем зовнішньої цілі збірки.

  • Знайдіть розділ Build > Post Actions.

  • Додайте нову дію запуску сценарію

  • У розділі Надати налаштування збірки з виберіть свій проект. Це дозволяє посилатися на каталог проекту в сценарії.

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

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

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

  • Знову відкрийте редактор схем і виберіть Виконати.

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

  • Установіть Виконуваний файл для файлу, який ви зв’язали у своєму сценарії дії після збирання.

  • Перевірте Debug executable.

  • Ви можете додати два аргументи на вкладці Аргументи: прапорець -e відкриває редактор замість менеджера проекту, а аргумент --path повідомляє виконуваному файлу відкрити вказаний проект ( необхідно надати як абсолютний шлях до кореня проекту, а не до файлу project.godot).

Щоб перевірити, чи все працює, поставте точку зупину в platform/macos/godot_main_macos.mm і запустіть проект.

Якщо у вас виникнуть проблеми, зверніться по допомогу в один із каналів спільноти Godot <https://godotengine.org/community>__.