h1. How to run HelloWorld and tests on linux

cocos2d-x supports linux platform from cocos2d-1.0.1-x-0.9.2.

This document will describe how to run HelloWorld and tests on linux and android simulator. 

The enviroment is ubuntu 11.04 + eclipse3.7. 

h2. 1. Set up environment

h3. 1.1 get cocos2d-x source code

a) get latest code from git, it is not stable

<pre>git clone https://github.com/cocos2d/cocos2d-x.git</pre>

b) get released version, it is stable

http://www.cocos2d-x.org/projects/cocos2d-x/wiki/Download

h3. 1.2.  install android sdk, use eclipse as IDE

Refer the link to install android sdk http://developer.android.com/sdk/index.html

*Use this appoach to install jdk*

<pre>

sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner"

sudo apt-get update

sudo apt-get install sun-java6-jdk

</pre>

h3. 1.3. install cdt for eclipse to compile c/c++ codes in eclipse

Help -> Install New Software... -> Add...

!install_cdt.jpg!

The link of cdt is http://download.eclipse.org/tools/cdt/releases/helios.

h3. 1.4. install ndk

You can download ndk here http://developer.android.com/sdk/ndk/index.html

Because we use ndk standalone toolchain to build android programe, so we should do some work

<pre>

# create a "customized" toolchain installation

$NDK/build/tools/make-standalone-toolchain.sh --platform=android-9 --install-dir=<your path>

# add the environment variable in /etc/profile, because eclispe should use it

export PATH="$PATH:<your path>"

</pre>

NDK is the root of your ndk, you should change <your path> to your own path.

More information of ndk standalone toolchain, please refer http://www.srombauts.fr/android-ndk-r5b/docs/STANDALONE-TOOLCHAIN.html

h3. 1.5. install needed libs

<pre>sudo apt-get install  libgl1-mesa-dev libglfw-dev freeglut3-dev libzip-dev</pre>

If you meet problem as me, maybe you should run the command before installing the libs

<pre>sudo apt-get -f</pre>

h2. 2. Run with makefile

First, build all libraries

<pre>

cd $COCOS2DX

./build_linux.sh

</pre>

COCOS2DX is the root of the cocos2d-x.

It is simple to run with makefile

<pre>

cd $HELLOWORLD/linux/

make

./HelloWorld

</pre>

HELLOWORLD is the root of helloworld, in my environment it is /home/zhangxm/cocos2d-x/HelloWorld.

You can run tests in the same way. It is simple, isn't it?

h2. 3. Run with eclipse

First, import existing projects: File -> Import...

!import_project.jpg!

Then select the directory of the root of cocos2d-x

!select_project.jpg!

Now, you can build and run HelloWorld and tests.

* build

Right click the project of HelloWorld -> Build Project

* run

Right click the project of HelloWorld -> Run as -> Local c/c++ Application

You can run tests in the same way.

h2. 4. Run on android emulator

h3. 4.1 Build .so

1. Right click the project of HelloWorld -> Build Configurations -> Set Active -> AndroidDebug

2. Right click the project of cocos2dx-base -> Build Configurations -> Set Active -> AndroidDebug

3. Right click the project of CocosDenshion -> Build Configurations -> Set Active -> AndroidDebug

4. Right click the project of HelloWorld -> Build Project

The steps above are compiling libcocos2d.so libcocosdenshion.so and copy these .so into HelloWorld/android/libs/armeabi.

h3. 4.2  New android project and run

File -> New -> Project -> Android Project

!new_android_project.jpg!

Right click the project of ApplicationDemo -> Run as -> Android Application

You can run tests in the same way, the difference are:

* Build different .so

1. Right click the project of cocos2dx-test -> Build Configurations -> Set Active -> AndroidDebug

2. Right click the project of cocos2dx-base -> Build Configurations -> Set Active -> AndroidDebug

3. Right click the project of CocosDenshion -> Build Configurations -> Set Active -> AndroidDebug

3. Right click the project of libBox2D -> Build Configurations -> Set Active -> AndroidDebug

3. Right click the project of libChipmunk -> Build Configurations -> Set Active -> AndroidDebug

4. Right click the project of cocos2dx-test -> Build Project

* The path to new android project is cocos2d-x/tests/test.android.