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

Дивись також

На цій сторінці описано, як скомпілювати двійкові файли шаблону експорту iOS із джерела. Якщо ви натомість хочете експортувати свій проект до iOS, прочитайте Експорт для iOS.

Вимоги

  • Python 3.8+.

  • SCons 4.0+ будувати систему.

  • xcode.

    • Запустіть Xcode один раз і встановіть підтримку iOS. Якщо ви вже запустили Xcode і вам потрібно інсталювати підтримку iOS, перейдіть до Xcode -> Налаштування... -> Платформи.

    • Перейдіть до Xcode -> Налаштування... -> Розташування -> Інструменти командного рядка та виберіть встановлену версію. Навіть якщо один із них уже вибрано, виберіть його ще раз.

  • Завантажте та дотримуйтесь інструкцій README, щоб створити статичний .xcframework з MoltenVK SDK.

Примітка

Якщо у вас встановлено Homebrew, ви можете легко встановити SCons за допомогою такої команди:

brew install scons

Встановлення Homebrew також призведе до автоматичного отримання інструментів командного рядка для 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 (необов’язково):

scons platform=ios target=template_debug ios_simulator=yes arch=arm64
scons platform=ios target=template_debug ios_simulator=yes arch=x86_64 generate_bundle=yes

Ці бібліотеки симулятора не можна використовувати для запуску експортованого проекту на цільовому пристрої. Замість цього їх можна використовувати для запуску експортованого проекту безпосередньо на вашому Mac, одночасно тестуючи функціональні можливості платформи iOS.

Щоб створити проект Xcode, як в офіційних збірках, вам потрібно використовувати шаблон, розташований у misc/dist/ios_xcode. Бібліотеки випуску та налагодження слід розмістити в libgodot.ios.debug.xcframework та libgodot.ios.release.xcframework відповідно. Цей процес можна автоматизувати за допомогою опції generate_bundle=yes у останній команді SCons, яка використовується для створення шаблонів експорту (щоб можна було включити всі двійкові файли).

Статичну папку MoltenVK .xcframework слід також помістити в папку ios_xcode після її створення. MoltenVK завжди статично пов’язаний на iOS; немає доступної опції динамічного зв’язування, на відміну від macOS.

Запустити

Щоб запустити на пристрої чи симуляторі, виконайте ці інструкції: Експорт для iOS.

Вирішення проблем

Fatal error: 'cstdint' file not found

If you get a compilation error of this form early on, it's likely because the Xcode command line tools installation needs to be repaired after a macOS or Xcode update:

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

Run these two commands to reinstall Xcode command line tools (enter your administrator password as needed):

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

If it still does not work, try updating Xcode from the Mac App Store and try again.