axmol/template/multi-platform-cpp/proj.android
zhangbin 536eaca24d closed #3714, Remove configurations which are not necessary in AndroidManifest.xml of aneroid projects. 2014-01-15 17:27:53 +08:00
..
jni closed #3108: add -fsigned-char to make char to signed as default 2013-11-04 10:48:45 +08:00
res/values issue #1733: Adding "multi-platform-cpp" and "multi-platform-lua" projects to template folder. 2013-02-19 15:38:30 +08:00
src/org/cocos2dx/cpp Fix:Resolve the android template projects’s errors 2014-01-07 16:45:03 +08:00
.classpath issue #2854:Disable CDT Builder on Eclipse 2013-11-15 14:35:55 +08:00
.project Remove something association of CDT Builder,it make 'miss error' in builders. 2013-11-22 17:41:03 +08:00
AndroidManifest.xml closed #3714, Remove configurations which are not necessary in AndroidManifest.xml of aneroid projects. 2014-01-15 17:27:53 +08:00
README.md Update template android projects README files 2013-03-21 19:06:58 +01:00
ant.properties issue #1733: Adding "multi-platform-cpp" and "multi-platform-lua" projects to template folder. 2013-02-19 15:38:30 +08:00
build.xml issue #1733, project-creator for cpp project seems ok 2013-02-21 16:51:22 +08:00
build_native.py modify template 2013-12-25 11:01:23 +08:00
proguard-project.txt issue #1733: Adding "multi-platform-cpp" and "multi-platform-lua" projects to template folder. 2013-02-19 15:38:30 +08:00
project.properties modify template 2013-12-24 09:42:37 +08:00

README.md

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:
    • Build C++.
    • Clean C++.
    • Build and Run whole project.
    • Logcat view.
    • Debug Java code.
    • Javascript editor.
    • Project management.
  2. True C++ editing, including:
    • Code completion.
    • Jump to definition.
    • Refactoring tools etc.
    • Quick open C++ files.

Setup Eclipse Environment (only once)

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

    OR

    Install Eclipse with Java. Add ADT and CDT plugins.

  2. Only for Windows

    1. Install Cygwin 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:

      • Eclipse->Preferences->General->Workspace->Linked Resources
      • Click New button to add a Path Variable COCOS2DX pointing to the root cocos2d-x directory. Example
    2. C/C++ Environment Variable NDK_ROOT:

      • Eclipse->Preferences->C/C++->Build->Environment.
      • Click Add button and add a new variable NDK_ROOT pointing to the root NDK directory. Example
      • Only for Windows: Add new variables CYGWIN with value nodosfilewarning and SHELLOPTS with value igncr
  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

Example Import

  1. File->New->Project->Android Project From Existing Code
  2. Browse to your project directory. eg: cocos2d-x/cocos2dx/samples/Cpp/TestCpp/proj.android/
  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

$ cd cocos2d-x/samples/Cpp/TestCpp/proj.android/
$ export NDK_ROOT=/path/to/ndk
$ ./build_native.sh
$ ant debug install

If the last command results in sdk.dir missing error then do:

$ android list target
$ android update project -p . -t (id from step 6)
$ android update project -p cocos2d-x/cocos2dx/platform/android/java/ -t (id from step 6)