env_setup.md

Environment Setup

Step 1: Install Android SDK

Follow the instructions found here to install the latest version of the Android SDK

Step 2: Install the necessary packages

Developing for the Forge requires a small set of packages to be installed. In the Android SDK Manager, install the latest revisions of the following packages:

• Tools
  • Android SDK Tools
  • Android SDK Platform-tools
  • Android SDK Build-tools
• Android 4.1.2 (API 16)
  • SDK Platform

Step 3: Add Android SDK to your PATH

To use adb or other Android tools from the command line, you'll need to add the build and platform tools folders to your system's PATH environment variable. After setting the PATH, you may need to close your terminal window or log out for the changes to take effect.

Setting PATH on Mac/Linux

1. Create or edit the shell startup file ~/.bash_profile
2. Add the following line:
   PATH=$PATH:<SDK>/platform-tools:<SDK>/tools
   replacing each <SDK> with the path to your Android SDK folder
3. Save and close the file

Setting PATH in Windows

1. Open Advanced System Settings, usually found by Right click My Computer > Properties
2. In the Advanced tab, click the Environment Variables button
3. Under System Variables, select PATH and click the Edit button
4. Add the following text to the end of the value field:
   ;<SDK>\platform-tools;<SDK>\tools
   replacing each <SDK> with the path to your Android SDK folder
5. Click OK

Step 4: Install driver for Android Console

For ADB to be able to connect with the console, you'll need to modify some system and Android SDK files.

For Mac Users:

1. Create or edit the file ~/.android/adb_usb.ini
2. Add the following line:

For Forge TV

0x1532

For OUYA

0x2836

3. Save and close the file

For Windows Users:

1. Create or edit the file %USERPROFILE%\.android\adb_usb.ini
   (%USERPROFILE% is typically a folder such as C:\Users\MyName\)
2. Add the following line:

For Forge TV

0x1532

For OUYA

0x2836

3. Save and close the file
4. With your Android Device connected via USB cable, open the Device Manager (Right click My Computer > Properties > Device Manager)
5. In Device Manager, select Portable Devices > UNKNOWN Console
6. Right-click and choose Update Driver Software...
7. Choose Browse my computer for driver software
8. Choose Let me pick from a list of device drivers on my computer
9. Select All devices and click Next
10. Click Have Disk and browse to <SDK>\extras\google\usb_driver
11. Choose ADB Composite Device
12. Accept the driver