README
1jMonkeyEngine3 on Android README
2
3This is the source tree for the engine portion of jMonkeyEngine, from a
4Subversion snapshot taken on 2012.02.24. It includes the engine/src directory
5from their source repository, but not the rest as it is quite large.
6
7The Android makefile does not build the entire library, but only these
8directories:
9
10engine/src/android
11engine/src/core
12engine/src/core-plugins
13engine/src/ogre
14
15which should be enough to use the core parts of the library.
16
17jMonkeyEngine relies on material and shader resources that are intended to be
18saved in the Java classpath and picked up by the classloader. On Android, they
19are saved in the APK and AssetManager is used to load them in. This works if
20you build the APK in something like Eclipse and simply include a source jar,
21but that will not work in the Android.mk build environment. Even if the
22resources are included in the static library jar build here, they will be
23stripped out when dex compiles the libraries into the APK. If you want to use
24this library, you will need to duplicate the resources you need into the assets
25directory of your project. As long as the path under assets/ is the same, the
26Android-specific asset loader will find them, e.g. if asked to load
27"Common/MatDefs/Misc/Unshaded.j3md", it will find it under
28"assets/Common/MatDefs/Misc/Unshaded.j3md".
29
30Links:
31
32http://jmonkeyengine.org/
33http://code.google.com/p/jmonkeyengine/checkout
34
35THe NOTICES file was generated with this command:
36
37find engine/src -type f | xargs head -n 35 | grep "^[ /=][*=]" > NOTICE
38