|
|
# 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** |