使用 Android 编辑器

2023 年，我们添加了 `Android 端的编辑器 <https://godotengine.org/article/android_godot_editor_play_store_beta_release/>`__，可用于在 Android 设备上创建、开发和导出 2D 和 3D 项目。

备注

Android 编辑器目前处于抢先体验阶段，我们将继续完善用户体验。请参阅下面的局限性与已知问题。

Android 设备支持

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

`所有文件访问权限 <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

插件

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

不支持 C#/Mono。
不支持外部脚本编辑器。
Forward+ 渲染器虽然可用，但是由于存在严重的性能问题，所以不推荐使用。
UX 未针对 Android 手机的尺寸进行优化。
Android Go 设备缺少设备读写访问所需的全部文件访问权限。作为变通方法，在使用 Android Go 设备时建议只在 Android 的 Documents 或 Downloads 目录中创建新项目。
在 开发者选项 中启用 不保留活动 后，编辑器将无法正常恢复。
三星键盘存在一个 bug，会导致在编写脚本时随机插入输入。建议使用 Google 键盘（Gboard）替代。

参见