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.

Android Studio

Android Studio — це безкоштовне середовище розробки для Android, розроблене Google і JetBrains. Він заснований на IntelliJ IDEA і має багатофункціональний редактор, який підтримує Java і C/C++. Його можна використовувати для роботи з основним двигуном Godot, а також з кодовою базою платформи Android.

Імпорт проекту

  • У вікні привітання Android Studio виберіть Відкрити.

../../../_images/android_studio_setup_project_1.png

Вітальне вікно Android Studio.

  • Перейдіть до <кореневого каталогу Godot>/platform/android/java і виберіть файл settings.gradle.

  • Android Studio імпортує та індексує проект.

Макет проекту Android Studio

Проект організовано з використанням модулів Android Studio:

  • lib module:

    • Located under <Godot root directory>/platform/android/java/lib, this is a library module that organizes the Godot java and native code and make it available as a reusable Android library.

    • The generated Godot Android library is made available for other Android modules / projects via MavenCentral, along with its documentation.

  • editor module:

    • Located under <Godot root directory>/platform/android/java/editor, this is an application module that holds the source code for the Android and XR ports of the Godot Editor.

    • This module has a dependency on the lib module.

  • app module:

    • Located under <Godot root directory>/platform/android/java/app, this is an application module that holds the source code for the Android build templates.

    • This module has a dependency on the lib module.

Збірка та налагодження модуля редактора

  • Щоб створити модуль редактор:

    ../../../_images/android_studio_editor_configurations_drop_down.webp
  • Щоб налагодити модуль редактор:

    • Відкрийте вікно Варіанти збірки за допомогою Перегляд > Вікна інструментів > Варіанти збірки у верхньому меню.

    • In the Build Variants window, make sure that in the Active Build Variant column, the :editor entry is set to one of the Debug variants.

    ../../../_images/android_studio_editor_build_variant.webp
    • Відкрийте вікно Запуск/налагодження конфігурацій, натиснувши Виконати > Редагувати конфігурації... у верхньому меню.

    • У вікні Налаштування запуску/налагодження виберіть запис редактор і в розділі Налагоджувач переконайтеся, що для Типу налагодження встановлено значення Подвійний (Java + Native)

    • Click the + sign under the Symbol Directories section, and add the platform/android/java/lib/libs/tools/debug directory.

    ../../../_images/android_studio_editor_debug_type_setup.webp

Створення та налагодження модуля програми

Для роботи модуля app потрібна наявність проекту Godot у його каталозі assets (<кореневий каталог Godot>/platform/android/java/app/src/main/assets). Зазвичай це обробляється редактором Godot під час процесу експорту. Під час розробки в Android Studio необхідно вручну додати проект Godot у цей каталог, щоб відтворити процес експорту. Після цього ви можете виконати наведені нижче інструкції для запуску/налагодження модуля app:

  • Щоб створити модуль app:

    ../../../_images/android_studio_app_configurations_drop_down.webp
  • Щоб налагодити модуль app:

    • Відкрийте вікно Варіанти збірки за допомогою Перегляд > Вікна інструментів > Варіанти збірки у верхньому меню.

    • In the Build Variants window, make sure that in the Active Build Variant column, the :app entry is set to one of the Debug variants.

    ../../../_images/android_studio_app_build_variant.webp
    • Відкрийте вікно Запуск/налагодження конфігурацій, натиснувши Виконати > Редагувати конфігурації... у верхньому меню.

    • У вікні Налаштування запуску/налагодження виберіть запис програма і в розділі Налагоджувач переконайтеся, що для Типу налагодження встановлено значення Подвійний (Java + Native)

    • Click the + sign under the Symbol Directories section, and add the platform/android/java/lib/libs/debug directory.

    ../../../_images/android_studio_app_debug_type_setup.webp

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