Introduction to Gear VR Development in Unity APPENDIX A: SETUP (MAC OS X) 3-hour Workshop Version 2015.07.13 Contact us at hello-dev@samsung.com Presented by Samsung Developer Connection and MSCA Engineering - Dallas
1 Table of Contents Requirements... 2 Hardware... 2 Software... 2 Mac OS X Setup... 3 Oculus Mobile SDK 0.6.0.1... 3 Java SE Development Kit 8... 4 Android SDK... 5 Download the SDK... 5 Install the SDK... 6 Unity 5.1.1p4... 7 Mandatory device setup for personal devices... 8 Set up device for development... 8 Oculus Signature File... 11 Manually retrieve Device ID in Terminal... 11 Use the Device ID app to retrieve Device ID... 11 Download Oculus Signature File... 12
2 Requirements Hardware These configured devices will be provided at the workshop. You will be expected to share the devices with another attendee. Samsung Gear VR Innovator Edition for Note 4 and Samsung GALAXY Note 4 Samsung Gear VR Innovator Edition for S6 and Samsung GALAXY S6 or S6 Edge If you plan on using your own devices, refer to the Gear VR User Manual and Gamepad User Manual bundled with your Gear VR to get started with your devices. Software This software is required for Gear VR development using Unity. Oculus Mobile SDK 0.6.0.1 Unity 5.1.1p4 Java Development Kit 8 (JDK) Android SDK 5.0 and SDK Tools Use the following instructions to setup your laptop for the workshop.
APPENDIX A: SETUP (MAC OS X), Introduction to Gear VR Development in Unity (3-hour Workshop) Mac OS X Setup Oculus Mobile SDK 0.6.0.1 1. Navigate to https://developer.oculus.com/ and select the MOBILE SDK (V.0.6.0.1) button. 2. On the Oculus Mobile SDK page, check the box to agree to the terms of the EULA and click the DOWNLOAD button. 3. Extract the ovr_mobile_sdk_0.6.0.1.zip package to a location that is easily accessible on your machine (e.g., Desktop or Documents). Open the ovr_mobile_sdk_0.6.0.1 package and review the contents. 4. 3
4 Java SE Development Kit 8 1. Navigate to http://www.oracle.com/technetwork/java/javase/downloads/jdk8-downloads-2133151.html. 2. In the Java SE Development Kit 8u31 section, select the Accept License Agreement radio button and download the Mac OS X x64 file. Note: A newer version of the Java Development Kit may be available for download. You may choose use the latest version. The last version tested for the workshop was version 8u31. 3. Open the DMG file and install the JDK. 4. To ensure the JDK has been successfully installed, open a Terminal window, type the following command and press Enter: java -version 5. Your current Java version will display in the window.
5 Android SDK Download the SDK 1. Navigate to http://developer.android.com/sdk/index.html. Here you will be given the option of downloading Android Studio, which packages the official Android IDE and SDK tools, or only downloading the SDK Tools. For this workshop, you will only need the SDK Tools. 2. Scroll down to the Other Download Options section. Under SDK Tools Only, locate the Mac OS X platform and download the android-sdk_r24.0.2-macosx.zip file. 3. Extract the Android SDK package to a location that is easily accessible on your machine (e.g., Desktop or Documents). 4. Open the Android SDK package and review the contents.
6 Install the SDK 1. In the Android SDK directory, open the /tools/android file. This will open the Android SDK Manager. 2. Check the boxes for the following packages: Android SDK Tools Android Platform-tools Android SDK Build-tools (the latest version) Android 5.0.1 (API 21) Note: When the Android SDK Manager launches, some packages may be preselected for installation. For this workshop, you will only need to install the packages listed above. If any of the preselected packages are not on this list, feel free to uncheck the items before starating the installation process. 3. Click the Install button. 4. In the Choose Packages to Install dialog, select a package on the left hand side and enable the Accept License radio button. Once all licenses have been accepted, click the Install button.
7 Unity 5.1.1p4 Note: You must download Unity patch release 5.1.1p4 for this workshop. If you are using an older version of Unity 5.1, you may experience app crashes and rendering issues on the Gear VR headset. 1. Navigate to http://beta.unity3d.com/download/c439df19cd24/maceditorinstaller/unity-5.1.1p4.pkg. This is a direct link to download Unity 5.1.1p4 for Mac OS X. 2. Open the Unity-5.1.1p4.pkg installer package and follow the instructions to install Unity on your machine. 3. Launch Unity and sign into your Unity account. If you do not have an account, create one now. 4. Once you ve activated Unity, the application will launch and prompt you to create a new project. At this point, you can close Unity.
8 Mandatory device setup for personal devices Note: Gear VR, Note 4, and/or S6/S6 Edge devices will be available for use at the workshop. If you plan on borrowing a device at the workshop, your setup is complete. If you plan on using your own devices, you must continue with the remaining sections to set up your device for development and create an Oculus Signature File. Set up device for development 1. Connect your Samsung GALAXY Note 4 or S6/S6 Edge to your computer via USB cable. 2. On your device, go to Apps > Settings. 3. In the Settings app, scroll down to the SYSTEM section. If you see the Developer options menu item, skip to step 6. Otherwise, continue to step 4 to enable Developer options. 4. Select the About phone menu item. 5. Scroll down and tap Build number seven times. This will activate Developer options on your device. Return to the main settings page. 6. Select the Developer options menu item.
9 7. In the Developer options, navigate to the DEBUGGING section and enable USB debugging. In the Allow USB debugging? dialog, tap OK. 8. In the next dialog, check the Always allow this computer box and tap OK.
10 9. Open a Terminal window and type the following command to navigate to your Android SDK s /platform-tools directory: cd /[pathtoandroidsdk]/android-sdk-macosx/platform-tools 10. Type the following command and you will see that a device has been connected to your machine:./adb devices
11 Oculus Signature File Manually retrieve Device ID in Terminal 1. With your device plugged into your Mac, open a Terminal window. Note: If you completed the previous section, Set up device for development, you will already have a Terminal window open listing your device and Device ID. Copy the Device ID and continue onto the Download Oculus Signature File section. 2. Navigate to the /platform-tools directory in the Android SDK with the following command: cd /[pathtoandroidsdk]/android-sdk-macosx/platform-tools 3. Type the following command to retrieve your Device ID:./adb devices 4. Copy your Device ID. Use the Device ID app to retrieve Device ID This is an alternative way of getting your Device ID. 1. If not already installed, download the Device Id Fetch app here: http://bit.ly/1fulsoq 2. Transfer the APK file to your device and install the app. Note: You may be asked to allow Unknown sources on your device. To do this go to Settings > Security and enable the Unknown sources option. 3. Open the Device Id Fetch app on your device and copy your Device ID.
12 Download Oculus Signature File 1. Navigate to https://developer.oculus.com/tools/osig/ and sign into your Oculus account. If you do not have an account, create one now. 2. Once you've signed into your account, paste your Device ID into the form field and click the DOWNLOAD FILE button. Your signature file will be downloaded. Be sure to keep this file in a location that can be easily accessed.