oxygine-framework/readme/Android.txt

1. Start from readme.txt

step by step video tutorial:
http://www.youtube.com/watch?v=d8eHHr_KHgQ

2a. Examples folder have configured android project
=================================================================================================
How to build. Steps:
- Install JDK version 6/7
- Install Android NDK (https://developer.android.com/tools/sdk/ndk/index.html) and set it up
- Install Android SDK Tools (https://developer.android.com/intl/ru/sdk/index.html#Other), 
  Launch SDK Manager and install Android SDK v16
- Install apache-ant (http://ant.apache.org/bindownload.cgi)

- Configure environment variables properly:
  NDK_ROOT points to root NDK folder 
  	example: d:\android\android-ndk-r9c\
  ANDROID_HOME points to root Android SDK folder
  	example: d:/android/android-sdk/
  JAVA_HOME points to JDK 
  	example: c:\Program Files (x86)\Java\jdk1.6.0_26\

- Add necessary paths to environment variable PATH:
  JDK 
  	example: "c:\Program Files (x86)\Java\jdk1.6.0_26\bin\"
  apache-ant
  	example: d:\android\apache-ant\bin\
  NDK tools 
  	example: d:\android\android-ndk-r9c\
  Android SDK tools and platform-tools
  	example: d:\android\android-sdk\platform-tools\
  	example: d:\android\android-sdk\tools\)

- Copy latest source code (and don't forget to update it if you updated SDL)
	from SDL/android-project/src/
	to oxygine-framework/oxygine/SDL/android/lib/src/

- Go to oxygine-framework\examples and choose any example. For example "Demo" 
- Try to build and run it using these scripts located in proj.android folder*:
  - build native part:
      build.cmd
  - build complete application in debug mode:
      ant_debug.bat
  - install it to device and run (using adb):
      install.bat

  * there is also build-run.bat includes these 3 steps
  

!!!note!!!:
  Folder containing oxygine-framework should have the exact name 'oxygine-framework'
  not 'oxygine-framework-master' not 'oxygine-framework.git' etc.
  otherwise you would see error:
    > Android NDK: jni/src/Android.mk: Cannot find module with tag 'oxygine-framework'


2b. You could generate your own android build config.
=================================================================================================
- You need installed Python 2.7
- You need to run this script
  oxygine-framework\tools\gen_template.py

example:
	python gen_template.py MyProject -t android -d path/to/MyProject/