COCOS2DX Installation Guide

This is a guide to setup the cocos2dx for android in Windows. 1. Download Android SDK: Instead of downloading only SDK you can download the ADT Bundle which has a collection of Android SDK, Eclipse and Android Plugin for Eclipse. Download the latest version from http:developer.android.comsdkindex.html. Extract ADT. I extracted in my E: Drive. My location of the ADT will beE:adtbundlewindowsx86_6420130717. My location of the SDK will be E:adtbundlewindowsx86_6420130717sdk. Also remember to update the SDK.Select the latest version of API and also the Android 2.2 (API 8).

COCOS2D-X Installation Guide

This is a guide to setup the cocos2d-x for android in Windows

1 Download Android SDK: Instead of downloading only SDK you can download the ADT Bundle which has a collection of Android SDK, Eclipse and Android Plugin for Eclipse Download the latest version from http://developer.android.com/sdk/index.html Extract ADT I extracted in my E:\ Drive My location of the ADT will beE:\adt-bundle-windows-x86_64-20130717 My location

of the SDK will be E:\adt-bundle-windows-x86_64-20130717\sdk Also remember to update the SDK.Select the latest version of API and also the Android 2.2 (API 8)

2 Download NDK from http://developer.android.com/tools/sdk/ndk/index.html I am using a 64 Bit Windows 8 OS So, I downloaded the version android-ndk-r9-windows-x86_64.zip Extract the NDK to your C:\ Drive I extracted mine at E:\android-ndk-r9

3 Download and install Cygwin from http://www.cygwin.com/install.html Cygwin is a program that enables you to get a Linux feeling on Windows You can install certain packages on Cygwin and have a minimal Linux like environment Install Cygwin When asked to select packages, search for the below packages and install them:

autoconf, automake, binutils, gcc-core, gcc-g++, gcc4-core, gcc4-g++, gdb, pcre, pcre-devel, gawk, make

Note: Select the GUI version of make as well otherwise you will not be able to build your project using NDK

4 Download JDK from

http://www.oracle.com/technetwork/java/javase/downloads/jdk7-downloads-1880260.html No matter if you system is 32 bit or 64 bit, you need to download only the 32 bit version Install Java in C:\Java

5 Download the latest version of Cocos2d-X Extract it to your C:\ Drive I extracted mine at E:\cocos2d-x-2.2

6 Setup Environment Variables for Java, Cocos2d-x, SDK and NDK:

Mine will look like below:

COCOS2DX_ROOT

E:\cocos2d-x-2.2

ANDROID_SDK_ROOT

E:\adt-bundle-windows-x86_64-20130717\sdk

NDK_ROOT

E:\android-ndk-r9

JAVA_HOME

C:\Java_32_Bit\jdk1.7.0_40\

If you are not sure how to set the environment variables here is a quick guide:

http://www.computerhope.com/issues/ch000549.htm

7 Open Cygwin: Right click on the icon and Run as administrator.

8 We want to create a new cocos2d-x project now We will create it for all the platforms and select only the android one later

cd $COCOS2DX_ROOT

cd tools/project-creator

Now enter the below command to create a new project:

python /create_project.py -project TestGame -package com.MyCompany.TestGame -language cpp

A new project will be created under the projects directory For me it will be in the location E:\cocos2d-x-2.2\projects

While running the create_project.py script, If you are seeing some error like:

E:\cocos2d-x-2.2\tools\project-creator>create_project.py -project MyGame -package

com.webfolks.AwesomeGame -language cpp

File "E:\cocos2d-x-2.2\tools\project-creator\create_project.py", line 63

print "Invalid -project parameter"

^

SyntaxError: invalid syntax

Perform the below steps to fix this issue:

Put all the print statements in the create-project.py file in paranthesis

Original statement:

print "Usage: create_project.py-project PROJECT_NAME-package PACKAGE_NAME-language PROGRAMING_LANGUAGE"

Revised statement:

print ("Usage: create_project.py-project PROJECT_NAME-package PACKAGE_NAME-language PROGRAMING_LANGUAGE")

9 Set Permissions: The problem with the generated new project is that, it is generated using a different user in windows and our actual login will not have access to copy or modify it For this

to work, right click on the generated project folder ‘TestGame’ go to the Security Tab, click Advanced and select the first option Allow, Everyone, Full Control, This folder subfolders and files Screen shots below

Also check the option ‘Replace all child object permission entries with inheritable permission entries from this object’ This will modify the permissions for all subfolders

10 Now we are done creating a project To import this to Android we need to build the generated project with NDK To do this go to cygwin and navigate to the TestGame folder that we created

Now go to the proj.android folder Here, we need to run the build_native.sh script Enter the command:

./ build_native.sh

It will take a while for the build to complete

Most of you might see an error like:

cygwin warning:

MS-DOS style path detected: E:\android-ndk-r9/ndk-build

Preferred POSIX equivalent is: /cygdrive/e/android-ndk-r9/ndk-build

One way to fix this is to go the environment variables and change the NDK_ROOT from

E:\android-ndk-r9 to /cygdrive/e/android-ndk-r9/ndk-build If you do this you need to restart cygwin and run the build_native.sh

I prefer an alternate method where I will edit the build_natiive.sh file and set the NDK_ROOK temporarily

In Windows, go to the newly created project folder ‘proj.android’ and then navigate to

proj.android Here you will see a file called build_native.sh Open this file in any of the text editor and add the below line in the second line:

set $NDK_ROOT = "/cygdrive/e/android-ndk-r9/ndk-build";

With this step there is no need to restart cygwin

11 Now, in cygwin go to the newly created project folder and go to the proj.android folder Now run the command :

./ build_native.sh

It would take a while for your project to be built

12 Once this is done copy the entire project to any other location, I choose Desktop\Cocos_Games Open Eclipse(Remember, you dowloaded the ADT from Android site for SDK and Eclipse), and import the new project File > Import > Existing Android Code Into Workspace > Next

In the Root Directory click on Browse and navigate till proj.android and click ok

Note: Do not select ‘Import to Workspace’ Option

13 You will see some errors in the imported project saying that it certain cocos2d import statements failed to be imported To fix this follow the below steps(Thanks to Paras Mendiratta):

1: In Eclipse, right-click on your project and select the last option "properties"

2: In Project Properties window, select "Java Build Path" in the left pane

3: Under Java Build Path, select tab "source" It should be selected by default

4: Click on button "Link Source"

5: Browse it to following location->

COCOS2D-X_INSTALLATION_FOLDER/cocos2dx/platform/android/java/src My path will be: E:\cocos2d-x-2.2\cocos2dx\platform\android\java\src

6: Give any folder name For example, remove src and replace it with: Cocos2d-x-source Click Finish

We are done now Run your poject on an Andorid Device and it should show you the nead cocos2d-x logo Please note that running this in an Android Virtual Machine may not always work