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 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

Please refer [[How to build and run HelloWorld]].