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 модуль:

  • editor модуль:

    • Цей модуль додатка, розташований у папці <кореневий каталог Godot>/platform/android/java/editor, містить вихідний код для портів Godot Editor на Android та XR.

    • Цей модуль залежить від модуля lib.

  • app модуль:

    • Цей модуль додатка, розташований у папці <кореневий каталог Godot>/platform/android/java/app, містить вихідний код шаблонів збірки для Android.

    • Цей модуль залежить від модуля lib.

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

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

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

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

    • У вікні Варіанти збірки переконайтеся, що в стовпці Активний варіант збірки для запису :editor вибрано один із варіантів Debug.

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

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

    • Натисніть на знак + у розділі Каталоги символів і додайте каталог platform/android/java/lib/libs/tools/debug.

    ../../../_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:

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

    • У вікні Варіанти збірки переконайтеся, що в стовпці Активний варіант збірки для запису :app вибрано один із варіантів Debug.

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

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

    • Натисніть на знак + у розділі Каталоги символів і додайте каталог platform/android/java/lib/libs/debug.

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

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