Getting started with Android — 2.2.0

Getting Started with Android

This guide describes how to set up your development environment for Cordova and run a sample application.

1. Requirements

• Eclipse 3.4+

2. Install SDK + Cordova

• Download and install Eclipse Classic
• Download and install Android SDK
• Download and install ADT Plugin
• Download the latest copy of Cordova and extract its contents. We will be working with the Android directory.

3. Setup New Project

• In a terminal window, navigate to the bin directory within the android subfolder of the Cordova distribution.

• Type in ./create <project_folder_path> <package_name> <project_name> then press "Enter"

    <project_folder_path> is the path to your new Cordova Android project
    <package_name> is the package name, e.g. com.YourCompany.YourAppName
    <project_name> is the project name, e.g. YourApp (Must not contain spaces)
  

• Launch Eclipse, and select menu item New Project

• Select the directory you used for <project_folder_path>

• Click Finish.

4A. Deploy to Emulator

• Right click the project and go to Run As > Android Application
• Eclipse will ask you to select an appropriate AVD. If there isn't one, then you'll need to create it.

Note: For a faster experience, use an Intel-based emulator image:

• Open the Android SDK Manager
• Install one or more Intel x86 Atom System Images as well as the Intel Hardware Accelerated Execution Manager (under Extras).
• Run the Intel installer, which has been downloaded to: extras/intel/Hardware_Accelerated_Execution_Manager within your Android SDK
• Create a new AVD with the Target set to an Intel image.
• When starting the emulator, ensure there are no error messages about the HAX module failing to load.

4B. Deploy to Device

• Make sure USB debugging is enabled on your device and plug it into your system. (Settings > Applications > Development)
• Right click the project and go to Run As > Android Application