Running Your App

If you followed the previous lesson to create an Android project, it includes a default set of "Hello World" source files that allow you to run the app right away.

How you run your app depends on two things: whether you have a real Android-powered device and whether you’re using Eclipse. This lesson shows you how to install and run your app on a real device and on the Android emulator, and in both cases with either Eclipse or the command line tools.

Before you run your app, you should be aware of a few directories and files in the Android project:

AndroidManifest.xml

This manifest file describes the fundamental characteristics of the app and defines each of its components. You'll learn about various declarations in this file as you read more training classes.

src/

Directory for your app's main source files. By default, it includes an Activity class that runs when your app is launched using the app icon.

res/

Contains several sub-directories for app resources. Here are just a few:

drawable-hdpi/

Directory for drawable objects (such as bitmaps) that are designed for high-density (hdpi) screens. Other drawable directories contain assets designed for other screen densities.

layout/

Directory for files that define your app's user interface.

values/

Directory for other various XML files that contain a collection of resources, such as string and color definitions.

When you build and run the default Android project, the default Activity class in the src/ directory starts and loads a layout file from the layout/ directory, which includes a "Hello World" message. Not real exciting, but it's important that you understand how to build and run your app before adding real functionality to the app.

Run on a Real Device

Whether you’re using Eclipse or the command line, you need to:

1. Plug in your Android-powered device to your machine with a USB cable. If you’re developing on Windows, you might need to install the appropriate USB driver for your device. For help installing drivers, see the OEM USB Drivers document.
2. Ensure that USB debugging is enabled in the device Settings (open Settings and navitage to Applications > Development on most devices, or select Developer options on Android 4.0 and higher).

To run the app from Eclipse, open one of your project's files and click Run from the toolbar. Eclipse installs the app on your connected device and starts it.

Or to run your app from a command line:

1. Change directories to the root of your Android project and execute:

   ant debug

2. Make sure the Android SDK platform-tools/ directory is included in your PATH environment variable, then execute:

   adb install bin/MyFirstApp-debug.apk

3. On your device, locate MyFirstActivity and open it.

To start adding stuff to the app, continue to the next lesson.

Run on the Emulator

Whether you’re using Eclipse or the command line, you need to first create an Android Virtual Device (AVD). An AVD is a device configuration for the Android emulator that allows you to model different device configurations.

Figure 1. The AVD Manager showing a few virtual devices.

To create an AVD:

1. Launch the Android Virtual Device Manager:
   1. In Eclipse, select Window > AVD Manager, or click the AVD Manager icon in the Eclipse toolbar.
   2. From the command line, change directories to <sdk>/tools/ and execute:

      ./android avd

2. In the Android Virtual Device Device Manager panel, click New.
3. Fill in the details for the AVD. Give it a name, a platform target, an SD card size, and a skin (HVGA is default).
4. Click Create AVD.
5. Select the new AVD from the Android Virtual Device Manager and click Start.
6. After the emulator boots up, unlock the emulator screen.

To run the app from Eclipse, open one of your project's files and click Run from the toolbar. Eclipse installs the app on your AVD and starts it.

Or to run your app from the command line:

1. Change directories to the root of your Android project and execute:

   ant debug

2. Make sure the Android SDK platform-tools/ directory is included in your PATH environment variable, then execute:

   adb install bin/MyFirstApp-debug.apk

3. On the emulator, locate MyFirstActivity and open it.

To start adding stuff to the app, continue to the next lesson.