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.

1. Set up environment¶

1.1 get cocos2d-x source code¶

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

git clone https://github.com/cocos2d/cocos2d-x.git

b) get released version, it is stable
http://www.cocos2d-x.org/projects/cocos2d-x/wiki/Download

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

sudo add-apt-repository "deb http://archive.canonical.com/ lucid partner" 
sudo apt-get update
sudo apt-get install sun-java6-jdk

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

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

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

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

# 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>/bin

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

1.5. install needed libs¶

sudo apt-get install  libgl1-mesa-dev libglfw-dev freeglut3-dev libzip-dev

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

sudo apt-get -f

2. Run with makefile¶

First, build all libraries

cd $COCOS2DX
./build_linux.sh

COCOS2DX is the root of the cocos2d-x.

It is simple to run with makefile

cd $HELLOWORLD/linux/
make
./HelloWorld

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?

3. Run with eclipse¶

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

Then select the directory of the root of cocos2d-x

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.

4. Run on android emulator¶

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.

4.2 New android project and run¶

File -> New -> Project -> Android Project

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.