axmol/samples/Cpp/HelloCpp/proj.android
minggo e81efb24c9 issue #2905: android samples run ok 2013-10-23 16:49:50 +08:00
..
.externalToolBuilders Adding eclipse project files for TestCpp and HelloCpp 2013-03-04 11:50:39 -08:00
.settings Adding eclipse project files for TestCpp and HelloCpp 2013-03-04 11:50:39 -08:00
jni issue #2905: helloworld build ok on android 2013-10-14 14:01:00 +08:00
res/values issue #1603: Moved the position of some projects. 2012-12-20 12:58:21 +08:00
src Update nojava.txt with readme. 2013-08-07 12:29:58 -07:00
.classpath [Dispatcher] Updating Android.mk, and some refractor. 2013-09-12 17:31:37 +08:00
.cproject [Dispatcher] Updating Android.mk, and some refractor. 2013-09-12 17:31:37 +08:00
.project delete parameter(-o igncr) when running build_native.sh in eclipse project 2013-03-19 13:48:32 +08:00
AndroidManifest.xml HelloCpp 2013-08-05 02:05:46 -07:00
README.md - update README files 2013-03-21 16:04:53 +01:00
build.xml issue #1603: Moved the position of some projects. 2012-12-20 12:58:21 +08:00
build_native.cmd issue #2905:modification vs-project for folder structure change 2013-10-21 22:09:21 +08:00
build_native.sh issue #2905: helloworld build ok on android 2013-10-14 14:01:00 +08:00
ndkgdb.sh Adding missing eclipse project files 2013-03-07 12:13:50 -08:00
project.properties issue #2905: android samples run ok 2013-10-23 16:49:50 +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)