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

В 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:

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

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

  • While available, the Forward+ renderer is not recommended due to severe performance issues.

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

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

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

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

См. также

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