Install OSG for Android On Ubuntu 13.04: Step-by-Step tutorials

Installation of essential tools and packages

Installation of open scene graph

Build the 1st Android OSG Example Application

Installation of essential tools and packages

Install Java
sudo add-apt-repository ppa:webupd8team/java
sudo apt-get update
sudo apt-get install oracle-java8-installer
Install Android ADT (Eclipse + Android SDK)
Goto http://developer.android.com/sdk/index.html
Download appropriate zip files, e.g. 64 bit linux version
Extract it to a folder, e.g. $HOME/ADT
Install Android NDK
Goto http://developer.android.com/tools/sdk/ndk/index.html
Download appropriate files, e.g. android-ndk-r9-linux-x86_64.tar.bz2
Extract it to a folder, e.g. $HOME/ndk
Install cmake
sudo apt-get install cmake
Install OpenGL
sudo apt-get install freeglut3-dev
Install build-essential package (including g++)
sudo apt-get install build-essential
Install 7zip
sudo apt-get install p7zip-full
Install subversion (if you need to clone osg source code from repository)
sudo apt-get install subversion libapache2-svn
Editor .bashrc file
gedit ~/.bashrc
Append two environement variables to the tail:
export ANDROID_NDK=$HOME/ndk
export ANDROID_SDK=$HOME/ADT/sdk

Installation of open scene graph

Download OpenSceneGraph-3.0.1
Extract it to $HOME/Android/OpenSceneGraph-3.0.1/
Download the 3rd party dependencies
Extract it to $HOME/Android/OpenSceneGraph-3.0.1/3rdparty/

Create two folders “build” & “osginstall” (the name can be whatever you like, be consistent) inside the OSG source folder:

$HOME/Android/OpenSceneGraph-3.0.1/build
$HOME/Android/OpenSceneGraph-3.0.1/osginstall

Open a terminal and change directory to the “build” fold cd $HOME/Android/OpenSceneGraph-3.0.1/build
Run below command for OSG with OpenGL ES 1.x, remember to substitute the string “osginstall” if you have used different folder names created above
cmake .. -DOSG_BUILD_PLATFORM_ANDROID=ON -DDYNAMIC_OPENTHREADS=OFF -DDYNAMIC_OPENSCENEGRAPH=OFF -DOSG_GL_DISPLAYLISTS_AVAILABLE=OFF -DOSG_GL_MATRICES_AVAILABLE=ON -DOSG_GL_VERTEX_FUNCS_AVAILABLE=ON -DOSG_GL_VERTEX_ARRAY_FUNCS_AVAILABLE=ON -DOSG_GL_FIXED_FUNCTION_AVAILABLE=ON -DOSG_CPP_EXCEPTIONS_AVAILABLE=OFF -DOSG_GL1_AVAILABLE=OFF -DOSG_GL2_AVAILABLE=OFF -DOSG_GL3_AVAILABLE=OFF -DOSG_GLES1_AVAILABLE=ON -DOSG_GLES2_AVAILABLE=OFF -DJ=4 -DCMAKE_INSTALL_PREFIX=$HOME/Android/OpenSceneGraph-3.0.1/osginstall
For osg Android GLES2, refer to this link to run cmake with different parameters
Run below command to compile and build all pieces of the code that needs to be recompiled. This takes very long time (1+ hours) to finish.
make

Run below command to generate the executables and other required files
make install

Build the 1st Android OSG Example Application

Open Eclipse
Menu New > Import > Android > Existing Android Code Into Workspace

Browse to the osg source code folder
$HOME/Android/OpenSceneGraph-3.0.1/examples/osgAndroidExampleGLES1

Tick “Copy project into workspace” option, and you will see a project is imported to workspace\osgViewer folder

In Eclipse project browser, expand the folder jni
Open Android.mk in the editor, make the following changes and save:

Change line 7 to: OSG_ANDROID_DIR := /home/USER/osgViewer
Change line 21 to: LOCAL_DLIBS := -llog -lGLESv1_CM -ldl -lz -lgnustl_static

Open a terminal, and change directory to

cd $HOME/workspace/osgViewer

Type below command

$ANDROID_NDK/ndk-build

Here come the most tricky parts: when you run this command, you will see tons of errors and warnings, follow below instructions to proceed:

Warnings or Errors:
jni/OsgMainApp.hpp:21:18: fatal error: osg/GL: No such file or directory
Actions: In Android.mk,
after LOCAL_C_INCLUDES:= $(OSG_ANDROID_DIR)/include
Add below line:
LOCAL_C_INCLUDES +=/home/david/Android/OpenSceneGraph-3.0.1/include

Warnings or Errors:
include/osg/GL:17:22: fatal error: osg/Config: No such file or directory

Actions: In Android.mk, add below line
LOCAL_C_INCLUDES +=/home/david/Android/OpenSceneGraph-3.0.1/build/include

Warnings or Errors:

jni/osgNativeLib.cpp: In function ‘void Java_osg_AndroidExample_osgNativeLib_loadObject (JNIEnv*, jobject, jstring)’: in jni/osgNativeLib.cpp:78:70: error: converting ‘false’ to pointer type for argument 2 of ‘char const* _JNIEnv::GetStringUTFChars(jstring, jboolean*)’ [-Werror=conversion-null]

Actions: Go to corresponding lines, e.g Line 78 in osgNativeLib.cpp
change const char *nativeAddress = env->GetStringUTFChars(address, false);
to const char *nativeAddress = env->GetStringUTFChars(address, NULL);
Do so for all such errors.

Warnings or Errors:
bin/ld: error: cannot find -losgdb_dds
Actions:
Copy folder /home/david/Android/OpenSceneGraph-3.0.1/build/obj
→ /home/david/workspace/osgViewer/obj

Warnings or Errors:

       bin/ld: error: cannot find -lgnustl_static
Actions: Copy below two folders
        /home/david/ndk/sources/cxx-stl/gnu-libstdc++/4.8/libs/armeabi-v7a
        /home/david/ndk/sources/cxx-stl/gnu-libstdc++/4.8/libs/armeab
→     /home/david/workspace/osgViewer/obj/local/armeabi-v7a
        /home/david/workspace/osgViewer/obj/local/armeabi

Re-run the command
$ANDROID_NDK/ndk-build

Results:

Connect Android real devices to Ubuntu, in Eclipse, run the osgViewer Project, you should see below screens:

Goto https://github.com/openscenegraph/osg-data

Download some osg files from OSG trunks, e.g.

svn checkout http://svn.openscenegraph.org/osg/OpenSceneGraph-Data/trunk/

Copy some files, e.g. cow.osg to the android device
In the android device, use ASTRO File Manager to browse the cow.osg that is just copied
Long press on the cow.osg file, and get the file’s address