Tool Setup Instructions

Download and run the Windows installer for the Android SDK, found at the following URL:

http://dl.google.com/android/installer_r22.3-windows.exe

(If you prefer, you may install manually by downloading the OS-appropriate archive from http://developer.android.com/sdk/index.html. But be sure to get the SDK tools only -- not the ADT bundle. Unzip to a root directory of your choice, and use this path where we use c:\AndroidSDK2.0 in the following instructions. Do this instead of the next few steps, and then run the SDK Manager and install packages as directed below; the rest of the process is the same.)

you'll see a welcome screen:

Click Next and the installer will detect the JDK(s) on your machine. Results will vary here but all is well unless the installer says you don't have a JDK or your JDK is not of a recent enough version.

Click Next and the installer will give you the option of setting the SDK up for yourself or for all users. Choose carefully here: if you are not the student and the student will be logging in as a different user on the OS, then it will be important to set up for all users. This in turn requires administrative privileges on the machine.

Click Next and you'll be asked to provide an install location. We recommend c:\AndroidSDK2.0, as the current version of the coursebook will refer to this as the default path; but any path is okay here and the courseware can be adapted to other SDK locations:

Click Next and choose your options for creating Windows shortcuts to Android SDK tools. For the classroom we generally recommend not to create shortcuts, but you can if you prefer:

Click Install and you will see the installation process roll by with a progress bar. When completed you'll see a screen like this:

Click Next and you'll see the confirmation screen:

Leave the checkbox checked, and click Finish to start the SDK manager.

Now you'll run the SDK manager to load necessary platforms and tools for the class. It will start out by downloading lists of available packages:

When the full list of options is prepared, choose packages to install. For this course we need the following packages:

• Tools
• Android SDK Tools -- version 20.0 or higher
• Android SDK Platform-tools -- version 16.0 or higher
• Android N.N (API MM) -- whatever is the latest available version
• Documentation for Android SDK
• Android 4.2.2 (API 17)
• SDK platform
• ARM EABI v7a System Image
• Google APIs

Click Install and you'll see a dialog that prompts you to accept license agreements. Click the Accept all radio button:

Click Install and installation will begin. This can take a while, depending on your internet connection. The progress bar at the bottom of the window will move along, and then when all done it will go back to zero and you'll see a confirmation message below it:

Close the SDK manager.

Finally we need to install the Android developer tools (ADT) for Eclipse. Start Eclipse now, and after a splash screen you'll see the dialog that lets you choose a workspace:

Click OK to select the default workspace. Eclipse will start up and you'll see the full layout of that workspace.

Choose Help | Install New Software ... from the menu, and see the Install dialog:

Click Add ... and enter values as shown in the Add Repository dialog. The name doesn't actually matter, but be sure to enter https://dl-ssl.google.com/android/eclipse/ for the URL:

Click OK and you'll be back in the first dialog, and after a moment you'll see a list of packages to download from that site. Choose the Developer Tools box and see that all the child nodes are checked as well; but you don't need the NDK Plugins:

Click Next and after some dependency checking you'll see this confirmation page:

Click Next and you'll be able to accept license agreements for some included components:

Click Finish. You'll see a dialog with a progress bar as Eclipse downloads plugins.

After a while you'll be warned about unsigned content.

Eclipse ADT is not digitally signed so to get it you'll have to click OK. Eclipse will install the downloaded plugins and ask you to restart:

Go ahead and restart Eclipse. When you are back at the default workspace, choose Window | Preferences ... from the menu, and select the Android group from the list on the left. Enter the SDK location in the field at the top -- you can browse to this if you prefer or just enter c:\AndroidSDK2.0 -- and then click Apply. You'll see the list of four platforms that you downloaded into the SDK:

Click OK. Now choose File | New | Other ... from the menu. If you scroll down in the list that's presented you should see an Android group, which once expanded looks like this:

You can close Eclipse, and all is now ready for Android development!