Skip to content

WVS

Configure Quest · Changes

Page history
Create Configure Quest authored by Sopisey Robinson's avatar Sopisey Robinson
Show whitespace changes
Inline Side-by-side
Configure-Quest.md 0 → 100644
View page @ dfc5ec3e
# Configure Quest
To Deploy Hello-World to your Quest, we will need the following variables. Detailed information is below.
|Variables |
|--- |
|WVSUSR_Quest_APPID |
|WVSUSR_QUEST_APPSECRET |
|WVSUSR_ANDROID_KEY_ALIAS_NAME |
|WVSUSR_ANDROID_KEY_ALIAS_PASS |
|WVSUSR_ANDROID_KEY_STORE_PASS |
|WVSUSR_ANDROID_KEYSTORE_BASE64 |
|WVSUSR_UNITY_PASS |
|WVSUSR_UNITY_SERIAL |
|WVSUSR_OCULUS_TOKEN |
1. Go to [Oculus Developer Center](https://developer.oculus.com/) and log in with your credentials.
Select **My Apps** to get started.
2. Create a new app if you don't already have it set up by clicking on the **Create New App** button.
![newapp](https://wvs.io/wvs-project-examples/hello-world-unity-vr-quest/-/raw/main/rdmeimg/create_new_app_oculus.png)
3. Click on the app you just created from the list of apps.
4. On the left-hand side, select **API**.
- In the center of the page, locate **APP ID** and save this number for later.
- Find **User Token** and click the **Generate Token** button. Copy the generated token and save
it for later.
- Locate **App Secret** and copy the secret and save this for later.
5. Now, we are going to move into the project on unity. To clone your project to your local
directory, you can use the Desktop Client, the CLI, or the web app. Detailed steps can be found on our [Docs Site](https://docs.wvs.io/wiki/Projects/Clone/Clone-Project-in-Web-App.html)
6. Once you have your project locally, open up the **WVS Desktop Client**.
- In the Desktop Client, you will start a changelist by selecting the **New Changelist** tab on
the left.
- You will need to enter a name for your new changelist in the text field that has the text
**Enter New Changelist Name**.
- You can ignore the optional file tree for locking files since we're just editing the project
settings.
- Any files that got changed will automatically show up in the appropriate section under
Modified Files in the desktop client. We won't commit any changes just yet.
7. Once you have your project locally, open it up in Unity. Here is a list of what you'll need to store in this step.
|Variables |
|--- |
|WVSUSR_ANDROID_KEY_ALIAS_NAME |
|WVSUSR_ANDROID_KEY_ALIAS_PASS |
|WVSUSR_ANDROID_KEY_STORE_PASS |
- Go to **Edit >> Project Settings** and scroll to the bottom to find **Publishing Settings**.
- Open **Keystore Manager**
- In the **Keystore Manager**, you can use the dropdown to create a new Keystore or select an
existing one. Select the option to create a new one.
- Enter all the information below that is unique to your project. Create an Alias, Alias
Password, and Keystore Password. Be sure to save all the information that was created in the
Keystore. You will need this later.
![keystore4](https://wvs.io/wvs-project-examples/hello-world-unity-vr-quest/-/raw/main/rdmeimg/unity_keystore4.png)
8. Next, you will use OpenSSL to encode your Keystore as base64. If you don't already have OpenSSL, you can download it [here](https://slproweb.com/products/Win32OpenSSL.html).
- Open a command prompt or terminal and run the following command to encode your Keystore.
`openssl base64 -A -in <yourKeystore>.keystore`
- Copy the output (a long string) and save it for the following variable.
**WVSUSR_ANDROID_KEYSTORE_BASE64**
- Now you are ready to push your changes to the remote repository, you will need to fill in
the Changelist Notes section with a brief description of your changes.
- Finally, press the COMMIT CHANGELIST button and follow the instructions to push.
9. With all the variables that were collected in the previous steps, you'll enter them into the project variables.
- In the WVS web app, go to your project, scroll to the bottom, and in the left-hand nav, select
**Project Settings>> CI/CD**. Locate **Variables** and expand the section.
![var](https://wvs.io/wvs-project-examples/hello-world-unity-vr-quest/-/raw/main/rdmeimg/wvs1.png)
- Click the **Add Variable** button and add your variables, one at a time.
9. Once this is set up, you can trigger a build by making a small change in the readme and adding a commit message (**-execute_quest**) to trigger the build.
10. Once the build completes, you can go to your [Oculus Developer Account](https://developer.oculus.com) and check that your build was deployed.
- Go to your app and select Overview from the left-hand nav. You will see your build
information there once it is deployed successfully.
- To view it on your Oculus, you can search for the app by using the exact project name
**Hello-World**