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...
Компіляція для iOS
Дивись також
На цій сторінці описано, як скомпілювати двійкові файли шаблону експорту iOS із джерела. Якщо ви натомість хочете експортувати свій проект до iOS, прочитайте Експорт для iOS.
Вимоги
SCons 4.4+ build system.
- 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, як в офіційних збірках, вам потрібно використовувати шаблон, розташований у misc/dist/ios_xcode. Бібліотеки випуску та налагодження слід розмістити в libgodot.ios.debug.xcframework та libgodot.ios.release.xcframework відповідно. Цей процес можна автоматизувати за допомогою опції generate_bundle=yes у останній команді SCons, яка використовується для створення шаблонів експорту (щоб можна було включити всі двійкові файли).
Статичну папку MoltenVK .xcframework слід також помістити в папку ios_xcode після її створення. MoltenVK завжди статично пов’язаний на iOS; немає доступної опції динамічного зв’язування, на відміну від macOS.
Попередження
The iOS simulator only supports the Compatibility renderer.
Apple Silicon Macs can run iOS apps natively, so you can run exported iOS projects directly on an Apple Silicon Mac without iOS simulator limitations.
Запустити
Щоб запустити на пристрої, виконайте такі інструкції: Експорт для iOS.
Експорт iOS можна запускати безпосередньо на Apple Silicon Mac. Щоб запустити експортований проект 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 і повторіть спробу.