Tool Setup Instructions

Android SDK, Version 22.3

If the course you are setting up requires AndroidSDK 22.3, follow these instructions to set it up on the student and instructor machines. If you have questions, please contact your courseware vendor.

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


(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:

Android SDK welcome

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.

Android SDK detect JDK

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.

Android SDK choose users

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:

Android SDK install location

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:

Android SDK shortcuts

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

Android SDK installation complete

Click Next and you'll see the confirmation screen:

Android SDK final

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:

Android SDK manager start

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
Android SDK manager select packages

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

Android SDK manager accept license agreements

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:

Android SDK manager installation complete

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:

Eclipse splash Eclipse choose 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:

Eclipse ADT start

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:

Eclipse ADT add site

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:

Eclipse ADT select packages

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

Eclipse ADT confirm packages

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

Eclipse ADT accept license agreements

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

Eclipse ADT installing

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

Eclipse ADT warning 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:

Eclipse ADT 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:

Eclipse ADT set SDK location

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:

Eclipse ADT check New Android XXX

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