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.

Checking the stable version of the documentation...

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, это библиотечный модуль, который организует Java- и нативный код Godot и делает его доступным в виде переиспользуемой Android-библиотеки.
- Сгенерированная Android-библиотека Godot доступна для других Android-модулей / проектов через MavenCentral вместе с её документацией.
editor модуль:
- Расположенный в <корневой каталог Godot>/platform/android/java/editor, это модуль приложения, который содержит исходный код Android- и XR-портов редактора Godot.
- Этот модуль зависит от модуля lib.
app модуль:
- Расположенный в <корневой каталог Godot>/platform/android/java/app, это модуль приложения, который содержит исходный код для Android-шаблонов сборки.
- Этот модуль зависит от модуля lib.

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

Чтобы собрать модуль редактор:
- Выберите раскрывающийся список Конфигурации запуска/отладки и выберите редактор.
- Выберите Run > Run 'editor' в верхнем меню или нажмите значок "Run".
Для отладки модуля editor:
- Откройте окно Build Variants, выбрав View > Tools Windows > Build Variants в верхнем меню.
- В окне Build Variants убедитесь, что в столбце Active Build Variant запись :editor установлена в один из вариантов Debug.
- Откройте окно Run/Debug Configurations, нажав Run > Edit Configurations... в верхнем меню.
- В окне Run/Debug Configurations выберите запись editor и в разделе Debugger убедитесь, что для Debug Type установлено значение Dual (Java + Native)
- Нажмите знак + в разделе Symbol Directories и добавьте каталог platform/android/java/lib/libs/tools/debug.
- Выберите Run > Debug 'editor' в верхнем меню или щелкните значок "Debug".

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

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

Чтобы собрать модуль app:
- Выберите раскрывающийся список Run/Debug Configurations и выберите app.
- Выберите Run > Run 'app' в верхнем меню или нажмите значок «Выполнить» <https://developer.android.com/studio/run/rundebugconfig#running>`_.
Для отладки модуля app:
- Откройте окно Build Variants, выбрав View > Tools Windows > Build Variants в верхнем меню.
- В окне Build Variants убедитесь, что в столбце Active Build Variant запись :app установлена в один из вариантов Debug.
- Откройте окно Run/Debug Configurations, нажав Run > Edit Configurations... в верхнем меню.
- В окне Run/Debug Configurations выберите запись app и в разделе Debugger убедитесь, что для Debug Type установлено значение Dual (Java + Native)
- Нажмите знак + в разделе Symbol Directories и добавьте каталог platform/android/java/lib/libs/debug.
- Выберите Run > Debug 'app' в верхнем меню или` щелкните значок «Отладка» <https://developer.android.com/studio/run/rundebugconfig#running>`_.

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