From 038f2f7115c633ada36e4ce93e5b2f45a6d980a0 Mon Sep 17 00:00:00 2001
From: JuliusJacobitz <julius@jacobitz.de>
Date: Tue, 27 Aug 2024 16:25:54 +0200
Subject: [PATCH] metaquest3 build workflow

---
 .github/workflows/build_meta_quest3.yml | 57 +++++++++++++++++++++++++
 .gitignore                              |  6 ++-
 README.md                               | 17 ++++++++
 3 files changed, 79 insertions(+), 1 deletion(-)
 create mode 100644 .github/workflows/build_meta_quest3.yml

diff --git a/.github/workflows/build_meta_quest3.yml b/.github/workflows/build_meta_quest3.yml
new file mode 100644
index 0000000..0c45336
--- /dev/null
+++ b/.github/workflows/build_meta_quest3.yml
@@ -0,0 +1,57 @@
+name: Build Meta Quest3
+
+on:
+  pull_request:
+    branches:
+      - meta-quest3-dev
+
+jobs:
+  buildForMetaQuest3:
+    name: Build for MetaQuest3
+    runs-on: ubuntu-latest
+    strategy:
+      fail-fast: false
+      matrix:
+        projectPath:
+          - "."
+        unityVersion:
+          - 2022.3.0f1 # TODO automatically get right version from ProjectSettings/ProjectVersion.txt
+        targetPlatform:
+          - Android
+    steps:
+      - uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          lfs: true
+      - uses: actions/cache@v3
+        with:
+          path: ${{ matrix.projectPath }}/Library
+          key:
+            Library-${{ matrix.projectPath }}-${{ matrix.targetPlatform }}-${{
+            hashFiles(matrix.projectPath) }}
+          restore-keys: |
+            Library-${{ matrix.projectPath }}-${{ matrix.targetPlatform }}-
+            Library-${{ matrix.projectPath }}-
+            Library-
+      - name: Install mp4 codecs
+        # This is needed cause some .mp4 files get downloaded as part of MetaQuest package tooltipps
+        run: sudo apt-get install ubuntu-restricted-extras
+      - uses: jlumbroso/free-disk-space@v1.2.0
+      - uses: game-ci/unity-builder@v4
+        env:
+          UNITY_LICENSE: ${{ secrets.UNITY_LICENSE }}
+          UNITY_EMAIL: ${{ secrets.UNITY_EMAIL }}
+          UNITY_PASSWORD: ${{ secrets.UNITY_PASSWORD }}
+        with:
+          projectPath: ${{ matrix.projectPath }}
+          unityVersion: ${{ matrix.unityVersion }}
+          targetPlatform: ${{ matrix.targetPlatform }}
+          customParameters: ""
+          androidExportType: "androidPackage"
+          buildName: "MetaQuest3Build"
+      - uses: actions/upload-artifact@v3
+        with:
+          name: MetaQuest3Build
+          path: build
+
+# TODO you can add some release steps here or do it manually
\ No newline at end of file
diff --git a/.gitignore b/.gitignore
index fbe8f27..35e25cf 100644
--- a/.gitignore
+++ b/.gitignore
@@ -156,4 +156,8 @@ crashlytics-build.properties
 .vsconfig
 
 # Unity Editor Crash Reporter
-mono_crash.*
\ No newline at end of file
+mono_crash.*
+
+# GameCI / Github Workflows 
+/[Aa]rtifacts/
+/[Cc]odeCoverage/
\ No newline at end of file
diff --git a/README.md b/README.md
index d9440bb..6c212a4 100644
--- a/README.md
+++ b/README.md
@@ -32,6 +32,23 @@ git checkout hololens2-dev
 and the follow the [HoloLens2 instruction](./Docs/HoloLens2Deploy.md). 
 
 
+### Build Workflow
+Currently supported plattforms:  
+- [x] MetaQuest3
+- [ ] HoloLens2
+
+**Users:** find the latest file under [Releases](https://github.com/intuitive-robots/IRXR-Unity/releases). 
+**Collaborators:** find your .apk file as an Artifact of a workflow under [Actions](https://github.com/intuitive-robots/IRXR-Unity/actions/).
+ 
+#### MetaQuest3 run .apk
+To execute an .apk file after you've downloaded it
+
+1. connect your MetaQuest3 to your computer via USB
+1. install [adb](https://developer.android.com/tools/adb)
+1. run `adb install -r YOURFILE.apk`
+1. execute programm on MetaQuest3
+
+
 ### Run your application
 
 We use [SimPublisher](https://github.com/intuitive-robots/SimPublisher.git) to make the communication eaiser.