入门

配置开发环境

操作系统(任意一种)

Windows 10（仅限64位版本）
macOS 10.11 或更高版本
Linux Ubuntu 18.04.5 或更高版本

配置 Android 环境

依赖环境	版本
JDK	JDK 1.8.0 及以上
Android SDK	API Level 29 及以上
Android NDK	NDK 21.4.7075529及以上
软件版本号(ro.build.display.id)

Linux 配置

配置 NDK SDK，打开 ~/.bashrc 添加如下：
//21.4.7075529 是你要使用的 NDK 版本号
NDK=~/Android/Sdk/ndk/21.4.7075529 

//SDK的安装目录
export ANDROID_SDK_ROOT=/home/[username]/Android/Sdk

//JDK的安装目录
//如果需要用java11，可以用android-studio自带的java11，配置如下：
export JAVA_HOME=/home/[username]/tools/android-studio/jre
export PATH=${PATH}:$NDK:$JAVA_HOME/bin:$JAVA_HOME/jre/bin

Windows 配置

在 Windows 系统环境变量添加
//NDK 安装目录
ANDROID_NDK_HOME  C:\Users\[username]\AppData\Local\Android\Sdk\ndk\21.0.6113669

//SDK 配置可以添加到 XrSamples/HelloXR/Projects/Android/local.properties下面
sdk.dir=C\:\\Users\\[username]\\AppData\\Local\\Android\\Sdk

//JDK的安装目录
//如果需要用 java11， 可以用 android-studio 自带的 java11
JAVA_HOME C:\Program Files\Android\Android Studio\jre
PATH 后面添加 %JAVA_HOME%\bin 和 %JAVA_HOME%\jre\bin

YVR 设备(任意一种)

YVR1
YVR2

系统最低配置要求

2.0+ GHz processor
2GB System RAM

开发软件IDE

推荐 AndroidStudio 使用如下版本或更高版本：

Android Studio Chipmunk | 2021.2.1 Patch 1 Build #AI-212.5712.43.2112.8609683, built on May 19, 2022 Runtime version: 11.0.12+7-b1504.28-7817840 amd64

启用设备用于开发与测试

启用 Android 调试桥调试

Android 调试桥（ADB） 是一个命令行工具，帮助开发者执行各种操作，如安装和调试应用程序，运行 shell 命令，管理 YVR 设备上的文件。ADB 应该与 Android SDK 一起安装，并位于 Android SDK 的 platform-tools 子文件中。

在终端使用 ADB 工具时，它的路径应该配置在系统环境中。当 ADB 系统环境的变量配置正确时，打开计算机终端并运行 adb --version 命令，输出应该如下所示：

Android Debug Bridge version 1.0.41
Version 30.0.5-6877874
Installed as <adb path>

首先在 YVR 设备的 Settings > System > Developer 打开 USB 调试，然后连接到电脑。

当你的 YVR 设备已连接到你的电脑时，在终端运行 adb 设备 命令，连接设备的 ID 应该显示在终端中，看着如下：

List of devices attached
d13de720        device

安装应用

当你构建 OpenXR 应用程序时，它会创建一个 .apk 文件，这是一个 Android 应用的安装文件。通过 ADB 命令，.apk 文件可以安装在 YVR 设备上。打开电脑的终端并运行 adb install -r <apk_Path> 命令，例如：

adb install -r .\YVRDemo.apk

应用安装成功后应该会输出以下内容：

Performing Streamed Install
Success

如果你使用 AndroidStudio 编译运行会自动帮你安装应用

编译运行 HelloXR（任意一种）

使用 AndroidStudio 编译

首先下载 YVRMobileSDK，打开 AndroidStudio 选择 Open, 打开 HelloXR 的 Android 目录

设置好编译的类型（Active Build Variant），连接好设备，点击运行

使用脚本编译

Windows 环境

编译 release版本：YVRMobileSDK\XrSamples\HelloXR\Projects\Android> .\build.bat release
编译 debug版本：YVRMobileSDK\XrSamples\HelloXR\Projects\Android> .\build.bat debug

Linux 环境

编译 release版本：~/YVRMobileSDK$ python3 XrSamples/HelloXR/Projects/Android/build.py release
编译 debug版本：~/YVRMobileSDK$ python3 XrSamples/HelloXR/Projects/Android/build.py debug

脚本编译出来的 .apk 路径：YVRMobileSDK\XrSamples\HelloXR\Projects\Android\build\outputs\apk\

手动安装 adb 命令

adb install path/xxx.apk