Android offers a custom plugin for the Eclipse IDE, called Android Development Tools (ADT). This plugin provides a powerful, integrated environment in which to develop Android apps. It extends the capabilities of Eclipse to let you quickly set up new Android projects, build an app UI, debug your app, and export signed (or unsigned) app packages (APKs) for distribution.

If you need to install Eclipse, you can download it from eclipse.org/mobile.

Note: If you prefer to work in a different IDE, you do not need to install Eclipse or ADT. Instead, you can directly use the SDK tools to build and debug your application.

Download the ADT Plugin

---

1. Start Eclipse, then select Help > Install New Software.
2. Click Add, in the top-right corner.
3. In the Add Repository dialog that appears, enter “ADT Plugin” for the Name and the following URL for the Location:

   https://dl-ssl.google.com/android/eclipse/

4. Click OK.If you have trouble acquiring the plugin, try using “http” in the Location URL, instead of “https” (https is preferred for security reasons).
5. In the Available Software dialog, select the checkbox next to Developer Tools and click Next.
6. In the next window, you’ll see a list of the tools to be downloaded. Click Next.
7. Read and accept the license agreements, then click Finish.If you get a security warning saying that the authenticity or validity of the software can’t be established, click OK.
8. When the installation completes, restart Eclipse.

Configure the ADT Plugin

---

Once Eclipse restarts, you must specify the location of your Android SDK directory:

1. In the “Welcome to Android Development” window that appears, select Use existing SDKs.
2. Browse and select the location of the Android SDK directory you recently downloaded and unpacked.
3. Click Next.

Your Eclipse IDE is now set up to develop Android apps, but you need to add the latest SDK platform tools and an Android platform to your environment. To get these packages for your SDK, continue to Adding Platforms and Packages.

Troubleshooting Installation

---

If you are having trouble downloading the ADT plugin after following the steps above, here are some suggestions:

• If Eclipse can not find the remote update site containing the ADT plugin, try changing the remote site URL to use http, rather than https. That is, set the Location for the remote site to:

  http://dl-ssl.google.com/android/eclipse/

• If you are behind a firewall (such as a corporate firewall), make sure that you have properly configured your proxy settings in Eclipse. In Eclipse, you can configure proxy information from the main Eclipse menu in Window (on Mac OS X, Eclipse) > Preferences > General > Network Connections.

If you are still unable to use Eclipse to download the ADT plugin as a remote update site, you can download the ADT zip file to your local machine and manually install it:

1. Download the ADT Plugin zip file (do not unpack it):
   

   Package	Size	MD5 Checksum
   ADT-21.0.0.zip	13556487 bytes	7db4eaae5df6a34fd853317a2bd8250b

2. Start Eclipse, then select Help > Install New Software.
3. Click Add, in the top-right corner.
4. In the Add Repository dialog, click Archive.
5. Select the downloaded ADT-21.0.0.zip file and click OK.
6. Enter “ADT Plugin” for the name and click OK.
7. In the Available Software dialog, select the checkbox next to Developer Tools and click Next.
8. In the next window, you’ll see a list of the tools to be downloaded. Click Next.
9. Read and accept the license agreements, then click Finish.If you get a security warning saying that the authenticity or validity of the software can’t be established, click OK.
10. When the installation completes, restart Eclipse.

To update your plugin once you’ve installed using the zip file, you will have to follow these steps again instead of the default update instructions.

Other install errors

Note that there are features of ADT that require some optional Eclipse packages (for example, WST). If you encounter an error when installing ADT, your Eclipse installion might not include these packages. For information about how to quickly add the necessary packages to your Eclipse installation, see the troubleshooting topic ADT Installation Error: “requires plug-in org.eclipse.wst.sse.ui”.

For Linux users

If you encounter this error when installing the ADT Plugin for Eclipse:

An error occurred during provisioning.
Cannot connect to keystore.
JKS

…then your development machine lacks a suitable Java VM. Installing Sun Java 6 will resolve this issue and you can then reinstall the ADT Plugin.

 

 

ADT Bundle

Platform	Package	Size	MD5 Checksum
Windows 32-bit	adt-bundle-windows-x86.zip	417851015 bytes	42d9a6c15113d405a97eed05e6d42e2b
Windows 64-bit	adt-bundle-windows-x86_64.zip	417851515 bytes	73bdd1168fce0e36a27255a4335c865d
Mac OS X 64-bit	adt-bundle-mac-x86_64.zip	382957959 bytes	a320f8bbaee8572a36e68c434564bdd0
Linux 32-bit	adt-bundle-linux-x86.zip	411065882 bytes	39687b06fedfea7487ff0824a4d32ee8
Linux 64-bit	adt-bundle-linux-x86_64.zip	411217430 bytes	b0590fe9c1533da9b20ea65525b77677

SDK Tools Only

Platform	Package	Size	MD5 Checksum
Windows	android-sdk_r21-windows.zip	99093893 bytes	7311452823470365f7975a545f8a2be4
	installer_r21-windows.exe(Recommended)	77523031 bytes	29ca8cb8f0bc8db627fa2adc2139a3cc
Mac OS X	android-sdk_r21-macosx.zip	65792626 bytes	67e46adca90dd18d7291443f6c15d6af
Linux	android-sdk_r21-linux.tgz	91378351 bytes	7f8d73b629f808cdcfc9f9900bbd758