开发

构建和打包应用

更新时间: 2026年4月14日

本指南涵盖针对 Meta Quest 设备构建和打包 Unreal 应用程序的相关说明。

概览

搭建好开发环境、配齐相关工具并正确配置项目设置后，您就可以构建面向 Android 平台的 VR 项目，并在 Meta Quest 设备上加载并运行 APK。

前提条件

按照设置开发环境指南来配置您的开发环境，并将设备设置为开发模式。

构建和打包项目

通过 USB 将 Meta Quest 设备连接到电脑。

打开一个 shell 终端，并使用 adb devices 命令验证是否可以与设备通信。

根据使用的设备，可能需要配置连接，以便进行软件安装。如需更多信息，请参阅移动 SDK 开发者指南中的 [ADB](/documentation/native/android/mobile-adb-mirroring/) 部分。

在 Platforms（平台）菜单中，选择 Android > Package Project（打包项目）。在 Flavor Selection（版本选择）下，推荐使用 Android (ASTC) 压缩。

找到希望安装 APK 的目标文件夹。

构建过程完成后，导航到目标文件夹。运行以 Install_ 开头的 .bat 文件（Windows）或对应的 .sh 文件（macOS/Linux）来安装应用程序。

点击应用程序即可启动。

直接在头戴设备上启动项目

还可以直接在 Meta Quest 头戴设备上构建并启动应用，无需在本地保存 APK。

通过 USB 将设备连接到电脑。

从平台菜单中，选择项目启动器。

选择您的项目，然后在下方的窗口中选择头戴设备。

如果在列表中看不到您的设备，请检查 USB 连接，并确认是否需要将连接设置为**以安装程序身份**连接。

点击设备配置右侧的启动此配置图标。

应用将被构建并安装到您的 Meta Quest 设备上。

在电脑上预览内容

您可以通过以下方法在电脑上预览您的 Meta Quest 应用程序：

2D 移动预览：在 Unreal 编辑器中使用移动预览模式，无需部署到头戴设备，即可实现快速迭代调试。

Meta Quest Link：通过 Meta Quest Link 将 Meta Quest 头戴设备连接到电脑，在桌面端以 VR 模式预览应用程序。

设备上运行：构建 APK 并直接在头戴设备上进行部署，或在 Unreal 编辑器中使用 Launch on Device（在设备上启动）功能。

虽然在开发过程中可以使用 Meta Quest Link 预览移动应用，但因为 PC-VR 应用与 Meta Quest 应用的性能要求存在显著差异，这可能无法真正反映应用的体验效果。如需了解更多信息，请参阅 Meta Quest：测试和性能分析中的性能目标。开发者可能会发现在 Unreal 中使用 2D 移动预览，然后在需要以 VR 模式查看应用时构建 APK 或使用 Launch on Device（在设备上启动）功能最为简便。