部署到 Android
场景布置
多数独立头显运行在 Android 上，并且 OpenXR 支持正在逐步推广到这些平台。
在遵循此处的 OpenXR 特定说明之前，你需要首先设置你的系统以导出到 Android 平台，包括：
安装 OpenJDK 17
安装 Android Studio
Configuring the location of the Android SDK in Godot
详情请参见 为 Android 导出 ，完成所需配置后再返回此处。
警告
虽然 Vulkan 渲染器针对移动设备进行了优化，但目前我们仍在解决适配问题。就现在而言，强烈建议开发者在针对基于 Android 的 XR 设备时使用兼容性渲染器（OpenGL）。
Gradle Android 构建
备注
最初，官方对 Android 平台的支持并未添加到 OpenXR 规范中，这导致各大供应商都创建了自定义加载器以在其头戴设备上实现 OpenXR。尽管从长远角度来看，所有供应商都终将转移到官方的 OpenXR 加载器；但就当下来说，这些加载器需要添加到你的项目中。
为了将特定供应商的 OpenXR 加载器包含到你的项目中，你需要先设置一个 Gradle Android 构建。
在项目菜单中选择安装 Android 构建模板...：
这将在你的项目中创建一个名为 android 的文件夹，包含在 Android 上运行所需的所有运行时文件。现在你可以自定义这个安装，Godot 不会在编辑器中显示这个文件夹，但你可以通过文件浏览器找到它。
你可以在这里阅读更多关于 Gradle 构建的信息：Android 的 Gradle 构建。
安装供应商插件
The vendors plugin can be downloaded from the asset library, search for "OpenXR vendors" and install the one named "Godot OpenXR Vendors plugin for Godot 4.3".
You will find the installed files inside the addons folder. Alternatively you can manually install the vendors plugin by downloading it from the release page here. You will need to copy the assets/addons/godotopenxrvendors folder from the zip file into your projects addons folder.
你可以在 这里 找到 vendors 插件的主仓库。
创建导出预设
不同的设备有不同的加载器，因此你需要为每个设备分别准备导出预设。
打开 Project 并选择 Export... 。点击 Add... 并选择 Android 。接下来，将导出预设的名称更改为你正在设置的设备的名称，比如 Meta Quest 。启用 Use Gradle Build 。如果你想使用一键部署（如下所述），记得启用 Runnable 。
If the vendors plugins were installed correctly you should find entries for the different headsets under XR Features. Change the XR Mode to OpenXR, then select the entry for your headset if you see one. If you don't see one enable the Khronos plugin.
Scroll to the bottom of the list and you'll find additional XR feature sections, currently only Meta XR Features, Pico XR Features, Magicleap XR Features and Khronos XR Features for HTC are available. You will need to select the appropriate settings if you wish to use these features.
通过 Godot 编辑器在设备上运行
如果按照上述说明设置导出预设，且头戴设备已连接到电脑并被正确识别，你可以通过一键部署直接从 Godot 编辑器启动它：
正确识别某些平台上的某些设备，可能需要执行额外步骤，请务必查阅你头戴设备供应商的开发者文档。
例如，对于 Meta Quest 2，你需要在头戴设备上启用开发者模式，并且如果你在 Windows 上开发，还需安装特定 ADB 驱动程序。更多详细信息，请参阅官方 Meta Quest 开发者文档。
如果你在一键部署方面遇到了问题，可参考一键部署的故障排除。