Компиляция для iOS

См. также

На этой странице описывается, как скомпилировать двоичные файлы шаблона экспорта для iOS из исходного кода. Если вы хотите экспортировать свой проект в iOS, прочтите документ Экспорт для iOS.

Требования

  • Python 3.8+.

  • SCons 4.0+ система сборки.

  • Xcode.

    • Запустите Xcode один раз и установите поддержку iOS. Если вы уже запустили Xcode и хотите установить поддержку iOS, перейдите в Xcode -> Settings... -> Platforms.

    • Откройте Xcode -> Settings... -> Locations -> Command Line Tools и выберите установленную версию. Даже если она уже выбрана, выберите её повторно.

  • Загрузите и следуйте инструкциям README, чтобы создать статический .xcframework из MoltenVK SDK.

Примечание

Если у вас установлен Homebrew, вы можете легко установить SCons с помощью следующей команды:

brew install scons

Установка Homebrew также автоматически загрузит Command Line Tools для Xcode, если у вас их ещё нет.

Аналогично, если у вас установлен MacPorts, вы можете легко установить SCons с помощью следующей команды:

sudo port install scons

См. также

Чтобы получить исходный код Godot для компиляции, см. Получение исходного кода.

Для общего обзора использования SCons в Godot, смотрите Введение в систему сборки.

Компиляция

Откройте Терминал, перейдите в корневую папку исходного кода движка и введите следующее, чтобы скомпилировать отладочную сборку:

scons platform=ios target=template_debug generate_bundle=yes

Чтобы скомпилировать сборку релиза:

scons platform=ios target=template_release generate_bundle=yes

Чтобы создать проект Xcode, как в официальных сборках, необходимо использовать шаблон, расположенный в misc/dist/ios_xcode. Библиотеки релиза и отладки следует разместить в libgodot.ios.debug.xcframework и libgodot.ios.release.xcframework соответственно. Этот процесс можно автоматизировать, используя опцию generate_bundle=yes в last команде SCons, используемой для сборки шаблонов экспорта (чтобы включить все исполняемые файлы).

Статическую папку .xcframework MoltenVK после её создания также необходимо поместить в папку ios_xcode. В iOS MoltenVK всегда статически линкуется; динамическая линковка, в отличие от macOS, недоступна.

Предупреждение

Compiling for the iOS simulator is currently not supported as per GH-102149.

Apple Silicon Macs can run iOS apps natively, so you can run exported iOS projects directly on an Apple Silicon Mac without needing the iOS simulator.

Запустить

Для запуска на устройстве следуйте этим инструкциям: Экспорт для iOS.

Экспортированные проекты iOS можно запускать непосредственно на компьютерах Mac на базе Apple Silicon. Чтобы запустить экспортированный проект iOS на Mac, откройте его в Xcode и выберите My Mac в раскрывающемся списке Run Destinations.

Устранение неполадок

Фатальная ошибка: файл 'cstdint' не найден

Если на ранней стадии вы получили ошибку компиляции такого рода, скорее всего, это связано с необходимостью исправления установки инструментов командной строки Xcode после обновления macOS или Xcode:

./core/typedefs.h:45:10: fatal error: 'cstdint' file not found
45 | #include <cstdint>
   |          ^~~~~~~~~

Выполните эти две команды, чтобы переустановить инструменты командной строки Xcode (при необходимости введите пароль администратора):

sudo rm -rf /Library/Developer/CommandLineTools
sudo xcode-select --install

Если это не помогло, попробуйте обновить Xcode из Mac App Store и повторите попытку.