Android Studio

Android Studio <https://developer.android.com/studio> — это бесплатная IDE для разработки приложений под Android, разработанная компаниями Google <https://about.google/> и JetBrains <https://www.jetbrains.com/>. Она основана на IntelliJ IDEA <https://www.jetbrains.com/idea/> и имеет многофункциональный редактор, поддерживающий Java и C/C++. Её можно использовать как для работы с основным движком Godot, так и с кодовой базой платформы Android.

Импортирование проекта

  • В окне приветствия Android Studio выберите Open.

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

Приветственное окно Android Studio.

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

  • Android Studio импортирует и проиндексирует проект.

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

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

  • Модуль lib:
    • Расположенный в <корневой каталог Godot>/platform/android/java/lib, это модуль библиотеки, который организует

      код Godot java и нативный код и сделать его доступным как повторно используемая зависимость/артефакт.

    • Артефакт, созданный этим модулем, доступен для использования в качестве зависимости другими модулями/проектами Android через MavenCentral.

  • Модуль editor:
    • Расположенный в <корневой каталог Godot>/platform/android/java/editor, это модуль приложения, который содержит

      исходный код для Android-порта Godot Editor.

    • Этот модуль зависит от модуля lib.

  • Модуль app:
    • Расположенный в <корневой каталог Godot>/platform/android/java/app, это модуль приложения, который содержит

      исходный код шаблонов сборки Android.

    • Этот модуль зависит от модуля lib.

Сборка и отладка модуля редактора

  • Чтобы собрать модуль редактор:
    ../../../_images/android_studio_editor_configurations_drop_down.webp
  • Для отладки модуля editor:
    • Откройте окно Build Variants, выбрав View > Tools Windows > Build Variants в верхнем меню.

    • В окне Build Variants убедитесь, что в столбце Active Build Variant запись :editor установлена на один из вариантов Dev.

    ../../../_images/android_studio_editor_build_variant.webp
    • Откройте окно Run/Debug Configurations, нажав Run > Edit Configurations... в верхнем меню.

    • В окне Run/Debug Configurations выберите запись editor и в разделе Debugger убедитесь, что для Debug Type установлено значение Dual (Java + Native)

    • Нажмите знак + под разделом Symbol Directories (Каталоги символов) и добавьте каталог модуля lib: platform/android/java/lib

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

Сборка и отладка модуля приложения

The app module requires the presence of a Godot project in its assets directory (<Godot root directory>/platform/android/java/app/src/main/assets) to run. This is usually handled by the Godot Editor during the export process. While developing in Android Studio, it's necessary to manually add a Godot project under that directory to replicate the export process. Once that's done, you can follow the instructions below to run/debug the app module:

  • Чтобы собрать модуль app:
    ../../../_images/android_studio_app_configurations_drop_down.webp
  • Для отладки модуля app:
    • Откройте окно Build Variants, выбрав View > Tools Windows > Build Variants в верхнем меню.

    • В окне Build Variants убедитесь, что в столбце Active Build Variant запись :app установлена на один из вариантов Dev.

    ../../../_images/android_studio_app_build_variant.webp
    • Откройте окно Run/Debug Configurations, нажав Run > Edit Configurations... в верхнем меню.

    • В окне Run/Debug Configurations выберите запись app и в разделе Debugger убедитесь, что для Debug Type установлено значение Dual (Java + Native)

    • Нажмите знак + под разделом Symbol Directories (Каталоги символов) и добавьте каталог модуля lib: platform/android/java/lib

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

Если у вас возникнут какие-либо проблемы, обратитесь за помощью на канале разработчиков Android Godot.