搭建Monado Runtime和OpenXR Sample Code编译环境

继上一篇《搭建ORB_SLAM3在Linux下的编译和运行环境》完成之后
为了完全打通 OpenXR---Runtime---SLAM 的数据通路
我们还需要搭建编译Runtime和OpenXR的环境

Runtime编译的是开源的Monado
OpenXR则需要编两份开源代码:

1.OpenXR-sdk-source : 
   OpenXR-sdk-source的SampleCode——Hello_xr

2.OpenXR-android-broker:
   用来加载Runtime的borker
   broker的源码比较难找,在gitlab上可以找到
   https://gitlab.freedesktop.org/ryan.pavlik/draft-openxr-android-broker-impl

最终生成的交付件都是apk:
搭建Monado Runtime和OpenXR Sample Code编译环境_第1张图片

1.Monado生成inProcess和outOfProcess两个apk:
   openxr_android-inProcess-debug.apk
   openxr_android-outOfProcess-debug.apk

2.Openxr-android-broker会生成4个apk,不过运行Hello_xr只需要用到其中一个:
   installable_runtime_broker-debug.apk

3.OpenXR-sdk-sources SampleCode会生成两种图形渲染方式的apk:
   hello_xr-OpenGLES-debug.apk
   hello_xr-Vulkan-debug.apk

源码在Github上自行搜索下载

最终结果以Hello_xr能够安装在Android设备(手机、VR等)上且能正常运行表示成功



Monado和OpenXR的环境配置和运行主要分三部分:

一.配置Android相关编译环境
二.配置Monado、OpenXR的编译工具,依赖库
三.编译、运行

环境搭建之前,先将虚拟机的虚拟内存、硬盘空间、CPU核尽量开大,
否则在编译过程中出现虚拟机卡死,或者电脑直接崩了,会是一件很囧的事

本地虚拟机配置如下:
虚拟内存:10G
虚拟硬盘:80G
CPU:4核

扩展虚拟内存和硬盘的具体方法,
在《搭建ORB_SLAM3在Linux下的编译和运行环境》第1节中已有说明,
不再重复讲解。


一.配置Android相关编译环境

1.    安装jdk
2.    安装android-sdk
3.    安装ndk

1.1 安装jdk
JDK要下载适配Android的Java8或11,不要下载最新的Java17、18
要不然最终编译会直接报”Unsupported class file major version 62”错误:
(有这种错误就说明是JDK版本不对)
 搭建Monado Runtime和OpenXR Sample Code编译环境_第2张图片

jdk官方下载地址:Java Downloads | Oracle

终端执行:
(1) mkdir java && cd java

(2) 下载Java11的linux对应版本x64 Compressed Archive : jdk-11.0.15.1_linux-x64_bin.tar.gz

(3) 解压:tar –zxvf jdk-11.0.15.1_linux-x64_bin.tar.gz

(4) sudo vim /etc/profile

(5) 在文件最后添加jdk环境变量:
export JAVA_HOME=/home/shawn/java/jdk-11.0.15.1
export CLASSPATH=.:$JAVA_HOME/lib:$JRE_HOME/lib:$CLASSPATH
export PATH=$JAVA_HOME/bin:$JRE_HOME/bin:$PATH
保存后,退出

(6) 使文件生效:source /etc/profile

(7) 查看是否安装成功:java –version
有如下图显示,则表示安装成功:

1.2 安装Android-sdk
目前Android-sdk都是通过Android Studio直接下载,
但是Android官网从sdk24之后就不再提供Android sdk package的直接下载了。

不过从官网 https://developer.android.com/studio 的最下面可以看到,
android官方提供了一种不需要Android Studio, 只需要download SDK packages的方式。
就是用sdkmanager来实现
因此我们需要实现在Linux下面使用sdkmanager下载AndroidSDK

先下载cmdline-tools工具
然后用cmdline-tools再下载sdkmanager

终端执行:
(1) mkdir android-sdk && cd android-sdk
(2)下载cmdline-tools.zip工具包:
搭建Monado Runtime和OpenXR Sample Code编译环境_第3张图片
直接下载压缩包或者命令下载:
wget https://dl.google.com/android/repository/commandlinetools-linux-8092744_latest.zip

(3)解压:unzip commandlinetools-linux-8092744_latest.zip

解压之后,sdkmanager就在/android-sdk/cmdline-tools/bin下面

(4) cd ../android-sdk/cmdline-tools/bin

(5)执行“./sdkmanager --list --channel=0”查看是否能获取到官方释放的sdk列表,
发现并没有,只有如下报错(图中”temp”应名为”android-sdk”,此处仅为示例):

无法找到sdk根目录,
提示显示有两种解决办法:
一是用sdk_root指定路径
二是把文件夹移动到指定路径

使用第二种,简单直接

可以直接在文件管理中操作,或者终端命令移动:
在/android-sdk/cmdline-tools/目录下新建一个名为latest文件夹
将/cmdline-tools下所有文件都拷贝到 latest 文件夹中

搭建Monado Runtime和OpenXR Sample Code编译环境_第4张图片

终端命令也很简单,cd 到cmdline-tools目录后执行:
(6) mkdir latest 
(7) mv bin/ lib/ NOTICE.txt source.properties -t latest/
两种方法选其一就行了。

文件移动完成后,cd到latest/bin/ 目录
再次执行查询命令:./sdkmanager --list --channel=0
就能看到android从发布至今所有的sdk,build-tools,platform-tools等

搭建Monado Runtime和OpenXR Sample Code编译环境_第5张图片搭建Monado Runtime和OpenXR Sample Code编译环境_第6张图片

终端命令下载对应版本sdk并标识对应的platforms:

(8) ./sdkmanager "build-tools;31.0.0" "platforms;android-31"
安装过程中会有一些协议许可认证需要用户确认
一路y就行
下载完成后,sdk所有一级子目录都会被下载到cmdline-tools同级目录下
 搭建Monado Runtime和OpenXR Sample Code编译环境_第7张图片

(9) 在/etc/profile中配置ANDROID_HOME环境变量:sudo vim /etc/profile
文件末尾添加下面两行:
export ANDROID_HOME=/home/shawn/android-sdk
export PATH=$ANDROID_HOME/platform-tools:$ANDROID_HOME/tools:$ANDROID_HOME/
tools/bin:$PATH
保存退出,执行:source /etc/profile

Linux安装SDK完成!

参考文档:Linux安装Android Sdk_爱新觉罗狗剩儿的博客-CSDN博客_linux安装android sdk


1.3 安装ndk
ndk配置比较简单,官网直接下载压缩包,或者终端命令下载,
然后解压,再配置环境变量。
 搭建Monado Runtime和OpenXR Sample Code编译环境_第8张图片
(1) wget https://dl.google.com/android/repository/android-ndk-r23b-linux.zip
(2) unzip android-ndk-r23b-linux.zip
(3) sudo vim /etc/profile
文件末尾添加下面两行:
export NDK_HOME=/home/shawn/android_ndk/android-ndk-r23b/
export PATH=$NDK_HOME:$PATH
保存退出
(4) source /etc/profile

ndk的下载似乎不是必须的,
在最后./grdlew编译时貌似会自动下载ndk且直接安装到上一步android-sdk目录里面。
官网在”自动安装 NDK 和 CMake”一项中对此也有介绍:
安装及配置 NDK 和 CMake  |  Android 开发者  |  Android Developers
但是前提是已预先接受NDK和CMake 的许可,
使用以下命令预先接受脚本中的相应许可:
${sdk}/cmdline-tools/latest/bin/sdkmanager --licenses
提示选择是否同意时,一路y



二.配置Monado、OpenXR的编译工具,依赖库

Monado / Monado · GitLab

从monado源码官网可以看到,
monado的编译环境具体配置如下:
 搭建Monado Runtime和OpenXR Sample Code编译环境_第9张图片
其中cmake、python、Eigen3在ORB_SLAM3环境搭建时已经安装,
此处不在复述

OpenGL在搭建ORB_SLAM3环境编译opencv配置cmake时,
有专门打开WITH_OPENGL=ON,不需要单独安装

并且似乎opengl、vulkan在./gradlew编译时会自动下载依赖(暂不确定),
vulkan依赖没有单独配置,但是最终hello_xr也编译出了vulkan apk

libusb、libudev、Video 4 Linux也都不需要配置

glslangValidator需要安装,否则会出现如下错误:
搭建Monado Runtime和OpenXR Sample Code编译环境_第10张图片
glslangValidator安装也十分简单,其官网有说明:
glslang-tools_11.1.0-4_arm64.deb Ubuntu 21.10 Download
终端命令
(1) sudo apt-get update
(2) sudo apt-get install glslang-tools


三.编译、运行

3.1 在这三个目录下,分别执行 ./gradlew assembleDebug 编译即可
shawn@shawn-virtual-machine:~/openxr/monado$ 
shawn@shawn-virtual-machine:~/openxr/openxr-android-broker$ 
shawn@shawn-virtual-machine:~/openxr/OpenXR-SDK-Source/src/tests/hello_xr$
搭建Monado Runtime和OpenXR Sample Code编译环境_第11张图片
搭建Monado Runtime和OpenXR Sample Code编译环境_第12张图片

3.2最终apk生成目录:
monado apk:
../src/xrt/targets/openxr_android/build/outputs/apk/inProcess/debug
../src/xrt/targets/openxr_android/build/outputs/apk/outOfProcess/debug

openxr-android-broker apk:
../sampleclient/build/outputs/apk/debug/sampleclient-debug.apk
../system_runtime_broker/build/outputs/apk/debug/system_runtime_broker-debug.apk
../installable_runtime_broker/build/outputs/apk/debug/installable_runtime_broker-debug.apk
../nativesampleclient/build/outputs/apk/debug/nativesampleclient-debug.apk

Hello_xr apk:
../src/tests/hello_xr/build/outputs/apk/Vulkan/debug/hello_xr-Vulkan-debug.apk
../src/tests/hello_xr/build/outputs/apk/ OpenGLES/debug/hello_xr-OpenGLES-debug.apk

3.3 在手机或者VR设备上分别安装如下apk:
adb install ../installable_runtime_broker-debug.apk 
adb install ../openxr_android-outOfProcess-debug.apk
adb install ../hello_xr-OpenGLES-debug.apk
adb install ../hello_xr-Vulkan-debug.apk

3.4 运行:
不论是手机端还是VR,安装完三个APK后
(1).先运行Monado XR
(2).Home退出再运行OpenXR Runtime,勾选Monado XR
(3).Home退出再运行Hello XR
     (hello_xr-OpenGLES-debug.ap可能在android手机上会有些问题,
      hello_xr-Vulkan-debug.apk亲测是可以的)

手机端运行效果:

搭建Monado Runtime和OpenXR Sample Code编译环境_第13张图片搭建Monado Runtime和OpenXR Sample Code编译环境_第14张图片 

搭建Monado Runtime和OpenXR Sample Code编译环境_第15张图片

 

VR端运行效果如下:
因为我们是在Pico neo3上安装apk做的测试
从第二张图可以看到,OpenXR broker在选择加载Runtime时,
不仅会有我们自己编译的Monado Runtime,还有Pico XR Runtime的选项
这就可以理解,Runtime上承OpenXR SDK,下接device适配层的属性了
 搭建Monado Runtime和OpenXR Sample Code编译环境_第16张图片
 搭建Monado Runtime和OpenXR Sample Code编译环境_第17张图片

 搭建Monado Runtime和OpenXR Sample Code编译环境_第18张图片

 当前效果还是2D的,要想改为3D的,在Hello_xr的Androidmainfest.xml中做如下修改即可: 

到此,基于Monado的Runtime和OpenXR SKD Source code的编译环境搭建完成!
 

你可能感兴趣的:(android)