Использование редактора Android

В 2023 году мы добавили Android-порт редактора, который можно использовать для создания, разработки и экспорта 2D- и 3D-проектов на устройствах Android.

Приложение можно загрузить со Godot download page или из магазина Google Play Store.

Примечание

Редактор Android находится в раннем доступе, пока мы продолжаем совершенствовать его. См. Ограничения и известные проблемы ниже.

Поддержка Android устройств

Для редактора Android требуются устройства под управлением Android 5 Lollipop или более поздней версии с поддержкой OpenGL 3 как минимум. Сюда входят (не исчерпывающие):

  • Планшеты Android, складные и большие телефоны

  • Нетбуки на базе Android

  • Устройства Chromebook, поддерживающие приложения для Android

Разрешения времени выполнения

  • Разрешение на доступ ко всем файлам: позволяет редактору создавать, импортировать и читать файлы проекта из любых местоположений файлов на устройстве. Без этого разрешения редактор по-прежнему функционирует, но имеет ограниченный доступ к файлам и каталогам устройства.

  • REQUEST_INSTALL_PACKAGES: позволяет редактору устанавливать экспортированные APK-файлы проекта.

  • RECORD_AUDIO: Запрашивается, когда включен параметр проекта audio/driver/enable_input.

Советы и хитрости

Input (Вход)

  • Для лучшего опыта и высокого уровня производительности рекомендуется подключить клавиатуру и мышь Bluetooth для взаимодействия с редактором Android. Редактор Android поддерживает все обычные сочетания клавиш и сопоставления клавиш.

  • При взаимодействии с клавиатурой и мышью вы можете уменьшить размер полосы прокрутки с помощью настройки редактора interface/touchscreen/increase_scrollbar_touch_area.

  • Для 2D-проектов плагин блочного кодирования может предоставить блочную визуальную альтернативу написанию скриптов при отсутствии подключенной аппаратной клавиатуры.

Multi-tasking (Многозадачность)

  • На небольших устройствах включение и использование режима «картинка в картинке» (PiP) обеспечивает возможность легкого перехода между редактором и окном воспроизведения.

    • PiP можно включить с помощью настройки редактора run/window_placement/play_window_pip_mode.

    • Параметр редактора run/window_placement/android_window можно использовать для указания того, должно ли окно Play всегда запускаться в режиме PiP.

    • Примечание: В режиме PiP окно Воспроизведение не имеет доступа к входным данным.

Projects sync (Синхронизация проектов)

  • Синхронизация проектов через Git может быть выполнена путем загрузки клиента Android Git. Мы рекомендуем Termux terminal, эмулятор терминала Android, который обеспечивает доступ к общим утилитам терминала, таким как Git и SSH.

    • Примечание: Чтобы использовать Git с терминалом Termux, вам нужно предоставить терминалу разрешение WRITE. Это можно сделать, выполнив следующую команду из терминала: termux-setup-storage

Plugins (Плагины)

  • Плагины GDExtension работают как и ожидалось, но требуют от разработчика плагина предоставления собственных двоичных файлов Android.

Ограничения и известные проблемы

Вот известные ограничения и проблемы редактора Android:

  • Поддержка сборки Gradle отсутствует.

  • Нет поддержки плагинов Android, так как для них требуется поддержка сборки Gradle. Поддерживаются плагины GDExtensions.

  • C#/Mono не поддерживается.

  • Внешние редакторы сценариев не поддерживаются.

  • Несмотря на доступность рендерера Vulkan Forward+, его использование не рекомендуется из-за серьезных проблем с производительностью.

  • UX не оптимизирован для форм-фактора телефонов Android.

  • На Android Go devices отсутствует разрешение на Доступ ко всем файлам для редактирования/записи. Для обхода этого ограничения, при использовании устройств Android Go, рекомендуется создавать новые проекты только в папках Documents или Downloads на устройстве.

  • Редактор не возобновляет работу должным образом, если в Developer Options (Параметрах разработчика) включен параметр Don't keep activities (Не сохранять действия).

  • Существует bug с клавиатурой Samsung, который приводит к вставке случайного ввода при написании скриптов. Вместо этого рекомендуется использовать Google keyboard (Gboard).

См. также

Посмотрите список нерешенных проблем на GitHub связанных с редактором Android для получения списка известных ошибок.