Development Environment and Configuration

This page will also review the steps to prepare your app to run locally during development.

Configure Your Unity Development Environment

Configure your development environment by adding Oculus Platform Support to your Unity project.

1. Open the Unity editor and import the OculusPlatform Unity package. Navigate to Main Menu / Assets / Import Package / Custom Package.
2. Copy the App Id that you retrieved from the Developer Center and add it to the project in Main Menu / Oculus Platform / Edit Settings / Oculus App Id.

Configure Your Native Development Environment

The steps to configure your environment will be different depending on the type of app you're building. Follow the steps for the app you're building.

Configure your Rift Development Environment

Configuring Visual Studio for your Rift project is the first step in integrating the Oculus Platform SDK for your Rift app. The SDK download provides a loader that enables DLL signature verification and graceful detection of the Oculus Runtime. To use the loader:

1. In your Visual C++ project, open the project Properties, expand the Linker tab, and select Input. Then, add the loader library (LibOVRPlatform32_1.lib or LibOVRPlatform64_1.lib) to Additional Dependencies.
2. Add the cpp loader file (InstallFolder/Windows/OVR_PlatformLoader.cpp) to your project.

Configure your Gear VR Development Environment

Configuring Android Studio for your Gear VR project is the first step in integrating the Oculus Platform SDK for your Gear VR app. There are two SDKs that you need to apply in the SDK Manager (Tools > Android > SDK Manager).

1. The Oculus Platform SDK provides a loader that enables .so signature verification and graceful detection of the Oculus Runtime. To use the loader, add the SDK location to the manager (InstallFolder/Android/libs/armeabi-v7a/libovrplatformloader.so).
2. Then, add the Android NDK (found in the SDK Tools tab of the SDK Manager). The NDK is a set of tools that allows you to use C++ code on Android devices. The NDK also manages device activities and allows your app access to device sensors and inputs.

Configuring Your App for Local Development

The configuration steps in this section will allow developers to run local builds of the application during the development process. This process is required, otherwise local versions of the app will not pass the entitlement check that you'll integrate in Initializing and Checking Entitlements. This section is not required unless you are planning to run your app locally during development.

1. Create an application as described in Creating and Managing Apps.
2. Upload a binary package for that application. The package does not have to function in any way during development, it just needs to exist.
3. Add each developer who will be working on the application to the developer role of that binary. Each developer can verify by checking that they see the build in their build list.
4. If some of your developers are not part of the application's organization, and they need to run your application outside the normal install directory. Add the registry key "AllowDevSideloaded" as DWORD(1) to the registry folder at HKLM\\SOFTWARE\\Wow6432Node\\Oculus VR, LLC\\Oculus. This does not bypass having a valid entitlement, it just bypasses the directory check.

Once the steps above are completed the entitlement check will succeed when running a local build of your application.

Integrating the SDK

The next step is to implement the initialization functions and Entitlement Check. See the Introduction to the Platform SDK page for information about these steps.