Setting Up Eclipse for Android Under Ubuntu
I know, tutorials such as this one can be found all around the Web. But I feel this might be helpful for many people reading this blog. I will try to cover everything from JDK installation to deploying applications directly to your phone using the "run" button in Eclipse.
Used for this tutorial
- Ubuntu 11.04 (Natty Narwhal)
- Acer TimelineX 1830T netbook
- Samsung Galaxy S Fascinate
- USB cable
Before you continue
Before you continue, please note that I rarely use the Ubuntu Software Center to install packages and applications so I will mostly use command line in this article. If this causes you any problem, feel free to post your questions in the comments section.
Installing Eclipse
If you don't already know, Eclipse is a free and open source IDE (integrated development environment) that can be used to develop in Java, C++, PHP, Ruby, and many more. To install Eclipse, open a Bash shell and execute the following:
sudo apt-get install eclipse
By installing the Eclipse package, many other packages such as Java JRE and JDK will be installed. This will save you a lot of configuration time.
Installing the Android SDK
Call it a personal preference. but I like to install SDK's in the /usr/lib folder. If you prefer to install it somewhere else, in your home folder for example, feel free to do so. Note: replace your_user by your Ubuntu user name.
cd /usr/lib sudo mkdir android sudo chown -R your_user:your_user android cd android
Now navigate to the Android SDK Download Page and copy the link to the Linux (i386) SDK. At the time of writing this article, the URL is: http://dl.google.com/android/android-sdk_r10-linux_x86.tgz. Now back to your shell:
wget http://dl.google.com/android/android-sdk_r10-linux_x86.tgz tar -xvzf android-sdk_r10-linux_x86.tgz
Installing the ADT Plugin for Eclipse
The Android Development Tools (ADT) Plugin is required for any Android development. Follow these instructions to install it:
- Open Eclipse (confirm workspace location if prompted, default location is good)
- In Eclipse's top menu, select Help / Install New Software...
- Click on the "Add..." button
- Enter "ADT Plugin" for the name, the following for the URL and click the OK button: https://dl-ssl.google.com/android/eclipse/
- Check "Developer Tools" (to download everything offered) and click the Next button twice
- Accept terms and conditions and click "Finish"
- If security warning pops, click "OK" to continue
- When asked, click "Yes" to restart Eclipse
Configuring Eclipse with the Android SDK
Eclipse needs to know where the Android SDK was installed:
- In Eclipse's top menu, select Window / Preferences
- In the window's left menu, click on "Android"
- Click "Browse..." and locate the place where the Android SDK was previously installed (in my case: /usr/lib/android/android-sdk-linux_x86)
- Click "OK" but not "Apply"
Other essential SDK components
Before you are ready to start developing, some essential components must be downloaded and installed using the Android SDK and AVD Manager. To open the manager, you can use the download-like arrow icon located in left part of Eclipse's icon bar, or you can select Window / Android SDK and AVD Manager from the top menu.
Click on "Available Packages" on the left, and under "Android Repositories" select the following packages:
- Android SDK Platform-tools
- Android SDK Tools (if in the list, but it shouldn't at this point)
- Documentation for Android SDK
- One or several SDK Platforms (I chose Android 2.1 and 2.2 because that's the API's I'm developing for)
- Click "Install Selected"
- Select "Accept All" and click "Install"
- When asked, click "Yes" to restart the ADB
Note 1: it is recommended you choose an Android API as low as possible to reach as many users as possible. Click here for the latest usage share.
Note 2: if you need more help selecting components, please read this.
Adding the Platform Tools to your environment
To make the Android SDK Platform-tools available from everywhere, you need to add the platform-tools directory to the PATH environment variable. To do so, use your favorite text editor (I use nano) and do the following:
nano ~/.bashrc
Scroll to the end of the file and add this line:
PATH=$PATH:/usr/lib/android/android-sdk-linux_x86/platform-tools/
Logout from your Ubuntu session and log back in. Now the "adb" command should be available from anywhere in your Bash shell.
Setting your phone
To be able to deploy your applications directly from Eclipse to your phone, you need to do two things:
- Set USB Debugging on (on my phone, with Android 2.2, it's located under Settings / Applications / Development)
- Allow install of non-market applications (again, on my phone, under Settings / Applications)
Connect your phone to ADB
Using your USB cable, connect your phone to your computer. Your phone should "say" it is now under USB debugging. On your computer, open a shell and type:
adb devices
You should get an output like this one:
List of devices attached 1000ed430c4c device
If you can't see your device, try:
adb kill-server adb start-server
Finally, deploy to your phone
Now start Eclipse. Open your Android project or create a new one (not covered in this tutorial).
You will need to create a run configuration at this point if not done already. What is important here is to set your configuration's target to "Manual". When finished, press "run" (the green play button). A window entitled "Android Device Chooser" should now open and your phone should be there. Select it and press the OK button. It should then deploy to your phone and the application will start by itself.
If you get a timeout error
When deploying to your phone, you may someday get:
Android error: Failed to install *.apk on device *: timeout.
It can be solved easily by going into Eclipse's top menu in Window / Preferences / Android / DDMS, and changing the ADB connection timeout.
Why not use the emulator?
The emulator may be a good tool in some situations (you can't own/test all different devices). But I prefer to develop directly on my phone. This is why this tutorial won't cover the use of the emulator. At this point, I'm almost sure you will figure it out by yourself as all the required tools have now been installed.
Need more help?
I really hope this will help you getting started with your Android development projects. If this tutorial doesn't answer all your questions, here are some sites/pages you may want to visit:
As always, feel free to post your questions or comments!