Android/Monado example

Author: geefr

examples/android-monado/README.md

@@ -6,7 +6,37 @@ Build Requirements:
 * Android Studio
 * Android SDK API Level 24
 * Android NDK 25
-* TODO: Monado setup details
+* Android device with Monado OpenXR runtime installed
+
+Quirks / Issues:
+* If ANDROID_STL=C++_static the OpenXR runtime will not load correctly. The runtime could be rebuilt with a static STL, but the simpler option is to use c++_shared in the vsgvr application
+* Monado on Android is currently targetted at cardboard-like HMDs - Configuring as a single-screen handheld display is not currently possible
+* When starting the application, ensure phone is held horizontally - Tracking is relative to the starting position
+* Performance will likely be quite low
+
+Project / Gradle requirements
+* C++ settings for vsgvr
+* `implementation 'org.khronos.openxr:openxr_loader_for_android:1.0.23'`
+
+## Installing Monado
+
+Firstly, build and install the monado runtime from https://gitlab.freedesktop.org/monado/monado
+* Clone the repo
+* Open the repo in Android Studio
+* Build and install the runtime APK
+
+Also build and install the monado broker application from https://gitlab.freedesktop.org/monado/utilities/openxr-android-broker
+* Clone the repo
+* Open the repo in Android Studio
+* Build and install the APK for `installable_runtime_broker`
+
+On the phone, configure the runtime
+* Open the app `OpenXR Runtime Broker`
+* Ensure the Monado runtime is selected
+
+The device should now have an OpenXR runtime, and vsgvr applications built with the following settings should function:
+* VSGVR_XR_PLATFORM=OPENXR_GENERIC
+* ANDROID_STL=c++_shared
 
 ## Build Configuration
 

examples/android-monado/app/AndroidManifest.xml

@@ -20,28 +20,23 @@
       android:label="@string/app_name"
       android:hasCode="false">
 
-      <meta-data android:name="com.oculus.intent.category.VR" android:value="vr_only"/>
-      <meta-data android:name="com.oculus.supportedDevices" android:value="quest|quest2|cambria"/>
-
     <!-- Our activity is the built-in NativeActivity framework class.
          This will take care of integrating with our NDK code. -->
     <activity android:name="android.app.NativeActivity"
               android:label="@string/app_name"
               android:launchMode="singleTask"
               android:resizeableActivity="false"
-              android:screenOrientation="portrait"
+              android:screenOrientation="landscape"
               android:configChanges="density|keyboard|keyboardHidden|navigation|orientation|screenLayout|screenSize|uiMode"
-              android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen">
+              android:theme="@android:style/Theme.Black.NoTitleBar.Fullscreen"
+              android:exported="true">
         <!-- Tell NativeActivity the name of our .so -->
-        <meta-data android:name="android.app.lib_name" android:value="vsgvrquestnative" />
+        <meta-data android:name="android.app.lib_name" android:value="vsgvrnative" />
         <intent-filter>
             <action android:name="android.intent.action.MAIN" />
-            <category android:name="com.oculus.intent.category.VR" />
             <category android:name="android.intent.category.LAUNCHER" />
         </intent-filter>
     </activity>
   </application>
-
-  <uses-feature android:name="android.hardware.vr.headtracking" android:required="true" android:version="1" />
 </manifest>
 <!-- END_INCLUDE(manifest) -->

examples/android-monado/app/build.gradle

@@ -6,7 +6,7 @@ android {
     defaultConfig {
         applicationId = 'com.vsgvr.vsgvrandroidmonado'
         minSdkVersion 27
-        targetSdkVersion 27
+        targetSdkVersion 31
         externalNativeBuild {
             cmake {
                 arguments '-DANDROID_STL=c++_shared', '-DVSGVR_XR_PLATFORM=OPENXR_GENERIC'
@@ -47,6 +47,7 @@ android {
 
 dependencies {
     implementation fileTree(dir: 'libs', include: ['*.jar'])
-    implementation 'com.android.support:appcompat-v7:28.0.0'
-    implementation 'com.android.support.constraint:constraint-layout:1.1.3'
+    implementation 'androidx.appcompat:appcompat:1.0.0'
+    implementation 'androidx.constraintlayout:constraintlayout:1.1.3'
+    implementation 'org.khronos.openxr:openxr_loader_for_android:1.0.23'
 }

examples/android-monado/app/cpp/CMakeLists.txt

@@ -1,6 +1,6 @@
 cmake_minimum_required(VERSION 3.13.0)
 
-project(vsgvrquestnative)
+project(vsgvrnative)
 
 # build native_app_glue as a static lib
 set(${CMAKE_C_FLAGS}, "${CMAKE_C_FLAGS}")
@@ -11,8 +11,9 @@ add_library(native_app_glue STATIC
 set(CMAKE_CXX_STANDARD 17)
 set(CMAKE_CXX_VISIBILITY_PRESET default)
 
-# To prevent errors when loading the native activity, ensure library name is the same in debug builds
+# To prevent errors when loading the native activity, ensure library name is the same in all builds
 set(CMAKE_DEBUG_POSTFIX "")
+set(CMAKE_RELWITHDEBINFO_POSTFIX "")
 
 # find vsg
 add_subdirectory("${CMAKE_CURRENT_SOURCE_DIR}/../../../../../VulkanSceneGraph" vsg)
@@ -24,16 +25,16 @@ set(CMAKE_SHARED_LINKER_FLAGS
     "${CMAKE_SHARED_LINKER_FLAGS} -u ANativeActivity_onCreate")
 
 # add vsgnative target
-add_library(vsgvrquestnative SHARED main.cpp)
+add_library(vsgvrnative SHARED main.cpp)
 
 # add the app glue include directory
-target_include_directories(vsgvrquestnative PRIVATE
+target_include_directories(vsgvrnative PRIVATE
     ${ANDROID_NDK}/sources/android/native_app_glue
     ${CMAKE_CURRENT_SOURCE_DIR}/../../vsgvr/include
     )
 
 # add lib dependencies
-target_link_libraries(vsgvrquestnative
+target_link_libraries(vsgvrnative
     vsg::vsg vsgvr
     android
     native_app_glue