jMonkeyEngine3 on Android README

This is the source tree for the engine portion of jMonkeyEngine, from a
Subversion snapshot taken on 2012.02.24. It includes the engine/src directory
from their source repository, but not the rest as it is quite large.

The Android makefile does not build the entire library, but only these
directories:

engine/src/android
engine/src/core
engine/src/core-plugins
engine/src/ogre

which should be enough to use the core parts of the library.

jMonkeyEngine relies on material and shader resources that are intended to be
saved in the Java classpath and picked up by the classloader. On Android, they
are saved in the APK and AssetManager is used to load them in. This works if
you build the APK in something like Eclipse and simply include a source jar,
but that will not work in the Android.mk build environment. Even if the
resources are included in the static library jar build here, they will be
stripped out when dex compiles the libraries into the APK. If you want to use
this library, you will need to duplicate the resources you need into the assets
directory of your project. As long as the path under assets/ is the same, the
Android-specific asset loader will find them, e.g. if asked to load
"Common/MatDefs/Misc/Unshaded.j3md", it will find it under
"assets/Common/MatDefs/Misc/Unshaded.j3md".

Links:

http://jmonkeyengine.org/
http://code.google.com/p/jmonkeyengine/checkout

THe NOTICES file was generated with this command:

find engine/src -type f | xargs head -n 35 | grep "^[ /=][*=]" > NOTICE