Up to date

This page is up to date for Godot 4.2. If you still find outdated information, please open an issue.

Експорт для iOS

Дивись також

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

Це кроки для завантаження проєкту Godot в Xcode. Це дозволяє створювати та розгортати (проєкт) на пристрої iOS, створювати випуск (реліз) для App Store та робити все інше, що зазвичай можна зробити з Xcode.

Увага

Projects written in C# can be exported to iOS as of Godot 4.2, but support is experimental and some limitations apply.

Вимоги

  • Ви повинні експортувати на iOS з комп'ютера під управлінням macOS із встановленим Xcode.

  • Завантажити шаблони експортування Godot. Використовуйте меню Godot: Редактор> Керування шаблонами експорту

Експорт проєкта Godot на Xcode

В редакторі Godot відкрийте вікно Експорт з меню Проєкт. Натисніть Додати.. і виберіть iOS.

Обов'язковими є параметри App Store Team ID та (Bundle) Identifier у категорії Application. Якщо залишити їх порожніми, експортер видасть помилку.

Примітка

If you encounter an error during export similar to
JSON text did not start with array or object and option to allow fragments not set
then it might be due to a malformated App Store Team ID!
The exporter expects a (10 characters long) code like ABCDE12XYZ and not, e.g., your name as Xcode likes to display in the Signing & Capabilities tab.
You can find the code over at developer.apple.com next to your name in the top right corner.

Після натискання кнопки Експорт проєкту залишаються ще два важливі параметри:

  • Path (Шлях) - це порожня папка, яка буде містити експортовані файли проєкту Xcode.

  • File (Файл) буде назвою проєкту Xcode та кількох конкретних файлів та каталогів.

../../_images/ios_export_file.png

Примітка

Це керівництво використовує exported_xcode_project_name, але ви будете використовувати ім'я вашого проєкту. Коли на наступних етапах ви побачите ім'я exported_xcode_project_name, замініть його на ім'я, яке ви використали замість нього.

Примітка

Уникайте використання пробілів, коли ви вибираєте exported_xcode_project_name, оскільки це може призвести до пошкодження вашого файлу проєкта XCode.

Після завершення експорту папка виводу повинна виглядати так:

../../_images/ios_export_output.png

Відкриття exported_xcode_project_name.xcodeproj дозволяє створювати та розгортати, як будь-який інший додаток для iOS.

Міркування щодо розвитку

Вищевказаний метод створює експортований проєкт, який ви можете створити для випуску, але вам доведеться переекспортовувати його кожного разу, коли ви вносите зміни в Godot.

Під час розробки ви можете пришвидшити цей процес, зв'язавши файли проєкту Godot безпосередньо з вашим додатком.

У наступному прикладі:

  • exported_xcode_project_name - це назва експортованої програми iOS (як зазначено вище).

  • godot_project_to_export - це назва проєкту Godot.

Примітка

Щоб запобігти проблемам з підписом в Xcode уникайте співпадіння godot_project_to_export з exported_xcode_project_name.

Плаґіни для iOS

У Godot можна використовувати спеціальні плаґіни iOS. Перегляньте сторінку Плаґіни для iOS.

Змінні середовища

You can use the following environment variables to set export options outside of the editor. During the export process, these override the values that you set in the export menu.

iOS export environment variables

Export option

Environment variable

Encryption / Encryption Key

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