The Eclipse ADT Bundle provides everything you need to start developing apps, including the Android SDK tools and a version of the Eclipse IDE with built-in ADT (Android Developer Tools) to streamline your Android app development.
If you didn't download the Eclipse ADT bundle, go download the Eclipse ADT bundle now, or switch to the Android Studio install or stand-alone SDK Tools install instructions.
To set up the ADT Bundle:
- Unpack the ZIP file
(named
adt-bundle-<os_platform>.zip) and save it to an appropriate location, such as a "Development" directory in your home directory. - Open the
adt-bundle-<os_platform>/eclipse/directory and launch Eclipse.
Caution: Do not move any of the files or directories
from the adt-bundle-<os_platform> directory. If you move the eclipse/
or sdk/ directory, ADT will not be able to locate the SDK and you'll
need to manually update the ADT preferences.
Eclipse with ADT is now ready and loaded with the Android developer tools, but there are still a couple packages you should add to make your Android SDK complete.
Android Studio provides everything you need to start developing apps, including the Android SDK tools and the Android Studio IDE (powered by IntelliJ) to streamline your Android app development.
If you didn't download Android Studio, go download Android Studio now, or switch to the Eclipse ADT install or stand-alone SDK Tools install instructions.
Before you set up Android Studio, be sure you have installed
JDK 6 or greater (the JRE alone is not sufficient). To check if you
have JDK installed (and which version), open a terminal and type javac -version.
If the JDK is not available or the version is lower than 6,
go download JDK.
[ Show instructions for all platforms ]
To set up Android Studio on Windows:
- Launch the downloaded EXE file,
android-studio-bundle-<version>.exe. - Follow the setup wizard to install Android Studio.
On some Windows systems, the launcher script does not find where Java is installed. If you encounter this problem, you need to set an environment variable indicating the correct location.
Select Start menu > Computer > System Properties > Advanced System Properties. Then open Advanced tab > Environment Variables and add a new system variable
JAVA_HOMEthat points to your JDK folder, for exampleC:\Program Files\Java\jdk1.7.0_21.
The individual tools and
other SDK packages are saved within the Android Studio application directory.
If you need to access the tools directly, use a terminal to navigate into the application and locate
the sdk/ directory. For example:
\Users\<user>\AppData\Local\Android\android-studio\sdk\
To set up Android Studio on Mac OSX:
- Open the downloaded DMG file,
android-studio-bundle-<version>.dmg. - Drag and drop Android Studio into the Applications folder.
Depending on your security settings, when you attempt to open Android Studio, you might see a warning that says the package is damaged and should be moved to the trash. If this happens, go to System Preferences > Security & Privacy and under Allow applications downloaded from, select Anywhere. Then open Android Studio again.
The individual tools and
other SDK packages are saved within the Android Studio application directory.
If you need access the tools directly, use a terminal to navigate into the application and locate
the sdk/ directory. For example:
/Applications/Android\ Studio.app/sdk/
To set up Android Studio on Linux:
- Unpack the downloaded Tar file,
android-studio-bundle-<version>.tgz, into an appropriate location for your applications. - To launch Android Studio, navigate to the
android-studio/bin/directory in a terminal and executestudio.sh.You may want to add
android-studio/bin/to your PATH environmental variable so that you can start Android Studio from any directory.
Android Studio is now ready and loaded with the Android developer tools, but there are still a couple packages you should add to make your Android SDK complete.
The stand-alone SDK Tools package does not include a complete Android development environment. It includes only the core SDK tools, which you can access from a command line or with a plugin for your favorite IDE (if available).
If you didn't download the SDK tools, go download the SDK now, or switch to the Eclipse ADT install or Android Studio install instructions.
[ Show instructions for all platforms ]
To get started on Windows:
Your download package is an executable file that starts an installer. The installer checks your machine for required tools, such as the proper Java SE Development Kit (JDK) and installs it if necessary. The installer then saves the Android SDK Tools into a default location (or you can specify the location).
- Double-click the executable (
.exefile) to start the install. - Make a note of the name and location in which it saves the SDK on your system—you will need to refer to the SDK directory later when using the SDK tools from the command line.
- Once the installation completes, the installer starts the Android SDK Manager.
To get started on Mac OSX:
Unpack the ZIP file you've downloaded. By default, it's unpacked
into a directory named android-sdk-mac_x86. Move it to an appropriate location on your machine,
such as a "Development" directory in your home directory.
Make a note of the name and location of the SDK directory on your system—you will need to refer to the SDK directory later when using the SDK tools from the command line.
To get started on Linux:
Unpack the .tgz file you've downloaded. By default, the SDK files are unpacked
into a directory named android-sdk-linux_x86. Move it to an appropriate location on your machine,
such as a "Development" directory in your home directory.
Make a note of the name and location of the SDK directory on your system—you will need to refer to the SDK directory later when using the SDK tools from the command line.
Troubleshooting Ubuntu
- If you need help installing and configuring Java on your development machine, you might find these resources helpful:
- Here are the steps to install Java and Eclipse, prior to installing
the Android SDK and ADT Plugin.
If you are running a 64-bit distribution on your development machine, you need to install additional packages first. For Ubuntu 13.10 (Saucy Salamander) and above, install the
libncurses5:i386,libstdc++6:i386, andzlib1g:i386packages usingapt-get:sudo dpkg --add-architecture i386 sudo apt-get update sudo apt-get install libncurses5:i386 libstdc++6:i386 zlib1g:i386
For earlier versions of Ubuntu, install the
ia32-libspackage usingapt-get:apt-get install ia32-libs
- Next, install Java:
apt-get install sun-java6-jdk
- The Ubuntu package manager does not currently offer an Eclipse 3.7 version for download, so we recommend that you download Eclipse from eclipse.org (http://www.eclipse.org/downloads/). A Java or RCP version of Eclipse is recommended.
- Follow the steps given in previous sections to install the SDK and the ADT plugin.
The Android SDK tools are now ready to begin developing apps, but there are still a couple packages you should add to make your Android SDK complete.
If you haven't already, download the Android SDK.
Then, select which SDK package you want to install: