Changes between Version 133 and Version 134 of AndroidPort

Timestamp:

Jan 20, 2012, 3:35:01 PM (12 years ago)

Author:

Anders Feder

Comment:

--

AndroidPort

@@ -196 +196 @@
 Then download the game source code into the `jni/src` directory under the project directory, e.g.:
 
+=== Building the application ===
+The native library (i.e. the actual game) is built using the standard Premake build system as follows. 
+
+First install a standalone toolchain:
+
+{{{
+$ ~/android/android-ndk-r7-crystax-4/build/tools/make-standalone-toolchain.sh --platform=android-14 --install-dir=$HOME/android/toolchain
+}}}
+
+
+Set up external libraries with the new toolchain somehow, or do an ugly hack that will at least let it start compiling enough for now:
+
+{{{
+$ ln -s /usr/include/boost ~/android/toolchain/sysroot/usr/include/
+$ ln -s /usr/include/iconv.h ~/android/toolchain/sysroot/usr/include/
+}}}
+
+
+Download the game from SVN to any location, as normal.
+
 {{{
 $ svn co http://svn.wildfiregames.com/public/ps/trunk/ ~/android/0ad/jni/src
 }}}
-Open the file `Android.mk` in the `jni/src` directory under the project directory in a text editor, e.g.:
-
-{{{
-$ nano -w ~/android/0ad/jni/src/Android.mk
-}}}
-Add the full path of the `jni/src/source` directory to the `LOCAL_C_INCLUDES` declaration, e.g.:
-
-{{{
-LOCAL_C_INCLUDES := $(LOCAL_PATH)/$(SDL_PATH)/include \
-        /home/youruser/android/0ad/jni/src/source
-}}}
-Add the `source/main.cpp` file to the `LOCAL_SRC_FILES` declaration:
-
-{{{
-# Add your application source files here...
-LOCAL_SRC_FILES := $(SDL_PATH)/src/main/android/SDL_android_main.cpp \
-        source/main.cpp
-}}}
-Then save the file and exit the text editor.
-
-=== Installing replacement libraries ===
-The Android platform provides only a very minimal C++ runtime support library (/system/lib/libstdc++) and corresponding headers for it in the NDK. To compile the game with the Standard C++ Library, we have to explicitly instruct `ndk-build` to compile against the GNU STL runtime. We also have to explicitly enable support for exceptions, and set the `CONFIG2_GLES` flag so the game is compiled to target the OpenGL ES API.
-
-Create a new file called `Application.mk` under the `jni` directory in the project directory, e.g.:
-
-{{{
-$ nano -w ~/android/0ad/jni/Application.mk
-}}}
-Insert these three lines in the file, substituting the part after the `:=` on the first line with the full path of your project directory:
-
-{{{
-APP_PROJECT_PATH := /home/youruser/android/0ad
-APP_STL := gnustl_static
-APP_CPPFLAGS += -fexceptions -DCONFIG2_GLES
-}}}
-Then save the file and exit the text editor.
-
-Download the following libraries to the working directory and then unpack them there:
-
- * [http://www.boost.org/users/download/#live Boost] (latest version)
- * [https://developer.mozilla.org/en/SpiderMonkey/1.8.5 SpiderMonkey] (1.8.5)
-
-Move the source code directory of each library into a new directory called `jni/lib` under the project directory, e.g.:
-
-{{{
-$ cd ~/android
-$ mkdir 0ad/jni/lib
-$ mv boost_1_48_0/boost ~/android/0ad/jni/lib/boost
-$ mv js-1.8.5/js/src ~/android/0ad/jni/lib/js
-}}}
-Also copy the SDL source code into the new directory:
-
-{{{
-$ cp -r ~/android/0ad/jni/SDL/src ~/android/0ad/jni/lib/SDL
-}}}
-Open the file `Android.mk` in the `jni/src` directory under the project directory in a text editor, e.g.:
-
-{{{
-$ nano -w ~/android/0ad/jni/src/Android.mk
-}}}
-Add the full path of the new directory to the `LOCAL_C_INCLUDES` declaration, e.g.:
-
-{{{
-LOCAL_C_INCLUDES := $(LOCAL_PATH)/$(SDL_PATH)/include \
-        /home/youruser/android/0ad/jni/src/source \
-        /home/youruser/android/0ad/jni/lib
-}}}
-Then save the file and exit the text editor.
-
-Now we must build !SpiderMonkey. Change directory to the !SpiderMonkey source code directory, e.g.:
-
-{{{
-$ cd ~/android/0ad/jni/lib/js
-}}}
-Then execute the following commands to compile !SpiderMonkey as a static library:
-
-{{{
-$ ./configure --disable-shared-js
-$ make
-}}}
-=== Building the application ===
-The native library (i.e. the actual game) is built by running the `ndk-build` command in the project directory, e.g.:
-
-{{{
-$ cd ~/android/0ad/
-$ ~/android/android-ndk-r7-crystax-4/ndk-build
-}}}
-=== Alternative approach ===
-Build using the standard Premake build system thusly:
-
- 1. Do "Setting up your workstation" as above.
- 1. Install a standalone toolchain:
-{{{
-~/android/android-ndk-r7-crystax-4/build/tools/make-standalone-toolchain.sh --platform=android-14 --install-dir=$HOME/android/toolchain
-}}}
- 1. Set up external libraries with the new toolchain somehow, or do an ugly hack that will at least let it start compiling enough for now:
-{{{
-ln -s /usr/include/boost ~/android/toolchain/sysroot/usr/include/
-ln -s /usr/include/iconv.h ~/android/toolchain/sysroot/usr/include/
-}}}
- 1. Download the game from SVN to any location, as normal.
- 1. Build the game as normal, but with
-{{{
-HOSTTYPE=arm
-./update-workspaces.sh --gles
-PATH=~/android/toolchain/bin:$PATH
-CXX=arm-linux-androideabi-g++
-make config=debug -k pyrogenesis
-}}}
- 1. See loads of build errors.
- 1. Fix all the build errors.
- 1. Fix the build system.
+
+
+Build the game as normal, but with:
+
+{{{
+$ cd ~/android/0ad/build/workspaces
+$ HOSTTYPE=arm
+$ ./update-workspaces.sh --gles
+$ PATH=~/android/toolchain/bin:$PATH
+$ CXX=arm-linux-androideabi-g++
+$ make config=debug -k pyrogenesis
+}}}
+See loads of build errors.
+
+Fix all the build errors.
+
+Fix the build system.