## Prerequisites:

* Android NDK
* Android SDK **OR** Eclipse ADT Bundle
* Android AVD target installed

## Building project

There are two ways of building Android projects.

1. Eclipse
2. Command Line

### Import Project in Eclipse

#### Features:

1. Complete workflow from Eclipse, including:
	a. Build C++.
	b. Clean C++.
	c. Build and Run whole project.
	d. Logcat view.
	e. Debug Java code.
	f. Javascript editor.
	g. Project management.
2. True C++ editing, including:
	a. Code completion. 
	b. Jump to definition.
	c. Refactoring tools etc. 
	d. Quick open C++ files.


#### Setup Eclipse Environment


**NOTE:** This step needs to be done only once to setup the Eclipse environment for cocos2d-x projects. Skip this section if you've done this before.

1. Download Eclipse ADT bundle from [Google](http://developer.android.com/sdk/index.html)

   **OR**

   Install Eclipse with Java. Add ADT and CDT plugins.
   
2. Only for Windows
 	1. Install [Cygwin](http://www.cygwin.com/) with make (select make package from the list during the install).
 	2. Add `Cygwin\bin` directory to system PATH variable.
 	3. Add this line `none /cygdrive cygdrive binary,noacl,posix=0,user 0 0` to `Cygwin\etc\fstab` file.
   
3. Set up Variables:
	1. Path Variable **COCOS2DX**:
		A. Eclipse->Preferences->General->Workspace->**Linked Resources**
		B. Click **New** button to add a Path Variable **COCOS2DX** pointing to the root cocos2d-x directory (Directory containing cocos2dx/ external/ tools/ scripting/ etc.).
		
	2. C/C++ Environment Variable **NDK_ROOT**: 
		A. Eclipse->Preferences->General->C/C++->Build->**Environment**.
		B. Click **Add** button and add a new variable **NDK_ROOT** pointing to the root NDK directory.
		C. Only for Windows: Add a new variable **CYGWIN** with value `nodosfilewarning`
		
4. Import libcocos2dx library project:
	1. File->new->Project..->Android Project From Existing Code.
	2. Click **Browse** button and open cocos2d-x/cocos2dx/platform/android/java directory.
	3. Click **Finish** to add project.
	
	

#### Adding and running from Eclipse


1. File->new->Project..->Android Project From Existing Code
2. **Browse** to cocos2d-x/cocos2dx/samples/Javascript/TestJavascript/proj.android/ directory. 
3. Add the project 
4. Click **Run** or **Debug** to compile C++ followed by Java and to run on connected device or emulator.


### Running project from Command Line

1. `cd cocos2d-x/samples/Javascript/TestJavascript/proj.android/`
2. `export NDK_ROOT=/path/to/ndk`
3. `./build_native.sh`
4. `ant debug install`
5. If step 4 results in sdk.dir missing error then follow step 6-8.
6. `android list target`
7. `android update project -p . -t (id from step 6)`
8. `android update project -p cocos2d-x/cocos2dx/platform/android/java/ -t (id from step 6)`