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 端的编辑器 <https://godotengine.org/article/android_godot_editor_play_store_beta_release/>`__，可用于在 Android 设备上创建、开发和导出 2D 和 3D 项目。

该应用可以从 Godot 下载页面 或 Google Play 商店 下载。

备注

Android 编辑器目前处于抢先体验阶段，我们将继续完善用户体验。请参阅下面的 :ref:doc_using_the_android_editor_limitations。

Android 设备支持

Android 编辑器需要运行在 Android 5 Lollipop 或更高版本的设备上，并且至少支持 OpenGL 3。 这些设备包括（并非详尽无遗）：

• Android 平板、折叠机、大屏手机

• Android 上网本

• 支持 Android 应用的 Chromebook

运行时权限

• `所有文件访问权限 <https://developer.android.com/training/data-storage/manage-all-files#all-files-access>`__：该权限允许编辑器从设备上的任何文件位置创建、导入和读取项目文件。没有该权限，编辑器仍可运行，但对设备文件和目录的访问受限。

• `REQUEST_INSTALL_PACKAGES <https://developer.android.com/reference/android/Manifest.permission#REQUEST_INSTALL_PACKAGES>`__：允许编辑器安装导出的项目 APK。

• `RECORD_AUDIO <https://developer.android.com/reference/android/Manifest.permission#RECORD_AUDIO>`__：当启用了 `audio/driver/enable_input <https://docs.godotengine.org/en/stable/classes/class_projectsettings.html#class-projectsettings-property-audio-driver-enable-input>`__项目设置时请求该权限。

提示与技巧

输入

• 为了获得最佳体验和高生产力，建议连接蓝牙键盘和鼠标来与 Android 编辑器进行交互。Android 编辑器支持所有 `常用快捷键和键位映射 <https://docs.godotengine.org/en/stable/tutorials/editor/default_key_mapping.html>`__。

• 当使用键盘和鼠标进行交互时，你可以通过 interface/touchscreen/increase_scrollbar_touch_area 编辑器设置来减小滚动条的大小。

• 对于 2D 项目，当缺少连接的硬件键盘时，block coding 插件 可以提供基于块的可视化替代方案来编写脚本。

多任务

• 在较小的设备上，启用并使用画中画（PiP）模式可以让你轻松地在 编辑器 和 Play 窗口 之间切换。

  • PiP 可以通过 run/window_placement/play_window_pip_mode 编辑器设置来启用。

  • run/window_placement/android_window 编辑器设置可用于指定 Play 窗口是否应始终在 PiP 模式下启动。

  • 注意：在画中画模式下，播放窗口无法进行输入。

项目同步

• 通过 Git 同步项目可以通过下载 Android Git 客户端来完成。我们推荐使用 `Termux 终端 <https://termux.dev/cn/>`__，这是一个 Android 终端模拟器，提供了对常见终端工具（如 Git 和 SSH）的访问。

  • 注意：要在 Termux 终端中使用 Git，你需要授予终端写权限。这可以通过在终端中运行以下命令来实现：termux-setup-storage

插件

• GDExtension 插件按预期工作，但需要插件开发者提供原生的 Android 二进制文件。

局限性与已知问题

以下是 Android 编辑器的已知局限性和问题：

• 不支持 gradle 构建。

• 不支持 Android 插件，因为它们需要 gradle 构建支持。支持 GDExtensions 插件。

• 不支持 C#/Mono。

• 不支持外部脚本编辑器。

• Vulkan Forward+ 渲染器虽然可用，但是由于存在严重的性能问题，所以不推荐使用。

• UX 未针对 Android 手机的尺寸进行优化。

• Android Go 设备缺少设备读写访问所需的全部文件访问权限。作为变通方法，在使用 Android Go 设备时建议只在 Android 的 Documents 或 Downloads 目录中创建新项目。

• 在 开发者选项 中启用 不保留活动 后，编辑器将无法正常恢复。

• 三星键盘存在一个 bug，会导致在编写脚本时随机插入输入。建议使用 Google 键盘（Gboard）替代。

参见

请参阅GitHub 上与 Android 编辑器有关的问题列表来了解已知 Bug 列表。