Setting Up An Android App Build Environment With Eclipse, Android SDK, PhoneGap (Fedora 14) - Page 3

5 Installing PhoneGap

To install PhoneGap, open Firefox and go to Click on the Downloads button:

Select Download .tar.gz from the overlay that comes up:

In the Firefox download dialogue, please choose Save File:

After the download has finished, go to the directory where the download has been saved (e.g. ~/Downloads/):

cd ~/Downloads/

Take a look at the directory's contents to learn how the PhoneGap download is named:

ls -l

[[email protected] Downloads]$ ls -l
total 11188
-rw-rw-r-- 1 falko falko 11452589 Jan 26 15:40 phonegap-phonegap-android-0.9.3-24-g9354b42.tar.gz
[[email protected] Downloads]$

As you see, in my case it is named phonegap-phonegap-android-0.9.3-24-g9354b42.tar.gz. Now lets uncompress the file:

tar xvfz phonegap-phonegap-android-0.9.3-24-g9354b42.tar.gz

In my case this creates the directory phonegap-phonegap-android-9354b42 inside the Downloads directory. I want to move that directory to my home directory and rename it to phonegap-phonegap-android:

mv phonegap-phonegap-android-9354b42 ~/phonegap-phonegap-android

We must add the bin directory inside $HOME/phonegap-phonegap-android to our PATH variable, therefore we edit ~/.bash_profile again:

cd ~
gedit ~/.bash_profile

Replace the previously modified PATH variable with this one:


To make the change effective, run:

export PATH=$PATH:$HOME/bin:$HOME/android-sdk-linux_86/tools:$HOME/android-sdk-linux_86/platform-tools:$HOME/phonegap-phonegap-android/bin

Now we are finished with setting up our Android development environment; finally we can start doing things with it!


6 Starting An Android Emulator

The Android SDK comes with an emulator so that you can test your apps in the emulator instead of on a real Android device. To create an emulator, we first need to know which Android versions (targets) are available:

android list targets

[[email protected] ~]$ android list targets
Available Android targets:
id: 1 or "android-3"
     Name: Android 1.5
     Type: Platform
     API level: 3
     Revision: 4
     Skins: HVGA-L, HVGA-P, QVGA-P, HVGA (default), QVGA-L
id: 2 or "android-4"
     Name: Android 1.6
     Type: Platform
     API level: 4
     Revision: 3
     Skins: QVGA, WVGA854, WVGA800, HVGA (default)
id: 3 or "android-7"
     Name: Android 2.1-update1
     Type: Platform
     API level: 7
     Revision: 2
     Skins: QVGA, WQVGA400, WQVGA432, WVGA854, WVGA800, HVGA (default)
id: 4 or "android-8"
     Name: Android 2.2
     Type: Platform
     API level: 8
     Revision: 2
     Skins: QVGA, WQVGA400, WQVGA432, WVGA854, WVGA800, HVGA (default)
id: 5 or "android-9"
     Name: Android 2.3
     Type: Platform
     API level: 9
     Revision: 1
     Skins: QVGA, WQVGA400, WQVGA432, WVGA854, WVGA800, HVGA (default)
[[email protected] ~]$

I will now create an emulator called mySim for Android 2.2 (id 4 or android-8):

android create avd -n mySim -t android-8

(The emulator for Android 2.3 seems to be buggy; the apps I built for 2.3 crashed immediately after starting them, while they run fine on 2.2; therefore I use Android 2.2 here.)

[[email protected] ~]$ android create avd -n mySim -t android-8
Android 2.2 is a basic Android platform.
Do you wish to create a custom hardware profile [no]
Created AVD 'mySim' based on Android 2.2,
with the following hardware config:
[[email protected] ~]$

To start the emulator, run:

emulator -avd mySim

It can take a few minutes until the emulator is up and running, but then it should look as follows:

Falko Timme

About Falko Timme

Falko Timme is an experienced Linux administrator and founder of Timme Hosting, a leading nginx business hosting company in Germany. He is one of the most active authors on HowtoForge since 2005 and one of the core developers of ISPConfig since 2000. He has also contributed to the O'Reilly book "Linux System Administration".

Share this page:

Suggested articles

0 Comment(s)

Add comment