Экспорт для iOS

См. также

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

Это шаги для загрузки проекта Godot в Xcode. Это позволяет вам создавать и развёртывать на устройстве iOS, создавать выпуск для App Store и делать всё остальное, что вы обычно можете делать с Xcode.

Внимание

Проекты, написанные на C#, можно экспортировать в Android, начиная с Godot 4.2, но поддержка является экспериментальной и присутствуют некоторые ограничения.

Требования

• Вы должны экспортировать для iOS с компьютера под управлением macOS с установленным Xcode.

• Загрузите шаблоны экспорта Godot. Используйте меню Godot: Editor > Manage Export Templates (Редактор> Управление шаблонами экспорта)

Экспорт проекта Godot в Xcode

В редакторе Godot откройте окно Export (Экспорт) из меню Project (Проект). Когда откроется окно экспорта, нажмите Add.. (Добавить..) и выберите iOS.

Требуются следующие параметры экспорта: App Store Team ID и**Identifier** в категории Application. Если их не заполнить, экспортёр выдаст ошибку.

Примечание

Если во время экспорта вы столкнулись с ошибкой, похожей на

JSON text did not start with array or object and option to allow fragments not set

то это может быть связано с некорректным App Store Team ID!

Экспортер ожидает код (длиной 10 символов), например ABCDE12XYZ, а не, например, ваше имя, как Xcode любит отображать на вкладке Signing & Capabilities.

Код можно найти на сайте developer.apple.com рядом с вашим именем в правом верхнем углу.

После того, как вы нажмете Export Project (экспорт проекта), останутся два важных параметра:

• Path (Путь) - это пустая папка, которая будет содержать экспортированные файлы проекта Xcode.

• File (Файл) будет именем проекта Xcode и нескольких файлов и каталогов, относящихся к проекту.

Примечание

В этом руководстве используется exported_xcode_project_name, но вы будете использовать имя вашего проекта. Когда вы увидите exported_xcode_project_name на следующих шагах, замените его именем, которое вы использовали вместо этого.

Примечание

Избегайте использования пробелов при выборе exported_xcode_project_name, так как это может привести к повреждению вашего файла проекта XCode.

Когда экспорт завершится, выходная папка должна выглядеть так:

Открытие exported_xcode_project_name.xcodeproj позволяет создавать и развёртывать, как и любое другое приложение iOS.

Действующие соглашения о разработке

Вышеупомянутый метод создаёт экспортированный проект, который вы можете создать для выпуска, но вам придется повторно экспортировать каждый раз, когда вы вносите изменения в Godot.

Во время разработки вы можете ускорить этот процесс, связав файлы проекта Godot непосредственно с вашим приложением.

В следующем примере:

• exported_xcode_project_name - имя экспортированного приложения iOS (как указано выше).

• godot_project_to_export - это название проекта Godot.

Примечание

godot_project_to_export не должен совпадать с exported_xcode_project_name для предотвращения проблем с подписью в Xcode.

Шаги по привязке папки проекта Godot к Xcode

1. Начните с экспортированного проекта iOS (следуйте инструкциям выше).

2. В Finder перетащите папку проекта Godot в браузер файлов Xcode.

3. In the dialog, make sure Create folder references is selected. This means you will be able to continue to edit your Godot project in its current location.

4. См. папку godot_project_to_export в браузере файлов Xcode.

5. Удалите exported_xcode_project_name.pck из проекта Xcode.

6. Open exported_xcode_project_name-Info.plist and add a string property named godot_path (this is the real key name) with a value godot_project_to_export (this is the name of your project)

Вот так! Теперь вы можете редактировать свой проект в редакторе Godot и создавать его в Xcode, если хотите запустить его на устройстве.

Плагины для iOS

В Godot можно использовать специальные iOS плагины. Посетите страницу doc_services_for_ios.

Переменные среды

Вы можете использовать следующие переменные окружения, чтобы задавать опции экспорта вне редактора. Во время процесса экспорта, они переопределяют значения, которые были заданы в меню экспорта.

Переменные среды экспорта iOS

Опции экспорта	Переменная окружения
Шифрование / Ключ шифрования	GODOT_SCRIPT_ENCRYPTION_KEY
Options / Application / Provisioning Profile UUID Debug	GODOT_IOS_PROVISIONING_PROFILE_UUID_DEBUG
Options / Application / Provisioning Profile UUID Release	GODOT_IOS_PROVISIONING_PROFILE_UUID_RELEASE

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

xcode-select points at wrong SDK location

xcode-select — это инструмент, входящий в состав Xcode и, помимо прочего, указывающий на iOS SDK на вашем Mac. Если вы установили Xcode, открыли его, приняли лицензионное соглашение и установили инструменты командной строки, xcode-select должен указывать на правильное расположение iPhone SDK. Если это не так, Godot не сможет экспортировать данные в iOS, выдавая ошибку, которая может выглядеть примерно так:

MSB3073: The command ""clang" <LOTS OF PATHS AND COMMAND LINE ARGUMENTS HERE>
"/Library/Developer/CommandLineTools/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS.sdk"" exited with code 1.

В этом случае Godot пытается найти папку Platforms, содержащую iPhone SDK, внутри папки /Library/Developer/CommandLineTools/, но на самом деле папка Platforms с iPhone SDK находится в /Applications/Xcode.app/Contents/Developer. Чтобы убедиться в этом, откройте Терминал и выполните следующую команду, чтобы увидеть, на что указывает xcode-select:

xcode-select -p

Чтобы исправить ошибку xcode-select, указывающую на неправильное местоположение, введите в Терминале следующую команду:

sudo xcode-select -switch /Applications/Xcode.app

После выполнения этой команды Godot должен успешно выполнить экспорт в iOS.

Опции экспорта

You can find a full list of export options available in the EditorExportPlatformIOS class reference.