Introduction to Gear VR Development in Unity APPENDIX A: SETUP (MAC OS X)

(1)

APPENDIX A: SETUP (MAC OS X)

3-hour Workshop

Version 2015.07.13

(2)

©2015 Samsung Electronics America, Inc. Samsung, Gear VR and Milk VR are trademarks of Samsung Electronics Co. Ltd. Other company names and/or product names mentioned herein are the property of their respective owners and may be trademarks or registered trademarks. Screen images simulated.

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

(4)

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).

(5)

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

(6)

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).

(7)

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

(8)

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.

(9)

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.

(10)

7. In the Developer options, navigate to the DEBUGGING section and enable USB debugging. In the Allow USB

debugging? dialog, tap OK.

(11)

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

(12)

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.

(13)

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.