#summary Instructions for building Hedgewars for Android

= Hedgewars for Android =

== Introduction ==

This guide will take you through the steps needed to succesfully compile Hedgewars for Android

==Download==

We need to download these packages:

* [http://code.google.com/p/hedgewars/ Hedgewars Source]<br>

* [http://developer.android.com/sdk/index.html Android SDK] (Latest version will do)<br>

* [http://developer.android.com/sdk/ndk/index.html Android NDK] (current version is r5b but anything up will probably work)<br>

* ~~[http://freepascal.org/down/source/sources.var FreePascal] (Latest (stable) version will do)~~<br>

* [http://sourceforge.net/projects/p-tools/ p-tools] (Fixed freepascal compiler, read below which to download)<br>

* [http://ant.apache.org/ Ant] (Linux distro should just use their package manager to get it, version isn't really important)<br>

* Java compiler, make sure you get JDK (not JRE) version 6 and up

==Hedgewars Source==

Using mercurial you can pull the hedgeroid branch using

{{{

hg clone https://hedgewars.googlecode.com/hg/ hedgewars

}}}

==Android SDK==

Optionally you could permanently add `<`SDK`>`/platform-tools to your $PATH, this makes it easier to use ‘adb’. Adb is the main program to communicate with Android, think logging/pushing and pulling files/shell.

If you do not have a real android device you can create an emulator if you do I’d skip this and continue at Android NDK

You can use either the GUI, run android and follow the signs or from cli

{{{

android create avd -n <name> -t 4

}}}

-n is a name of your choice -t stands for the target ID

See this for more information

To run the emulator navigate to `<`SDK`>`/tools and run

{{{emulator -avd <name>}}}

where `<`name`>` is the same name as when you created it with the line above.

==Android NDK==

Download and untar it, ill refer to the ndk as `<`NDK`>`. That’s it :)

==!FreePascal ==

{{{

make crossinstall CPU_TARGET=arm OS_TARGET=linux CROSSBINDIR=<ndk>/toolchains/arm-linux-androideabi-4.4.3/prebuilt/linux-x86/bin OPT=-dFPC_ARMEL BINUTILSPREFIX=arm-linux-androideabi- INSTALL_PREFIX=<fpc>/fpc_install

}}}

Note: The flag CROSSBINDDIR points to the ndk/toolchain/../prebuilt/linux-x86/bin dir, change linux-x86 to your host machine, so for windows it would be 'windows' instead of linux-x86

==Final==

We will generate the Makefile.android, which is needed to compile hedgewars, download SDL and you’ll need to make sure cmake knows where all the compilers are

1.<br>

Add `<`NDK`>`:`<`SDK`>`/platform-tools:`<`FPC`>`/compiler to your path, on debian based system I would do it as follows:

{{{

export PATH=$PATH:/home/xeli/SoftDev/android/ndk

export PATH=$PATH:/home/xeli/SoftDev/android/sdk/platform-tools

export PATH=$PATH:/home/xeli/SoftDev/android/fpc-2.4.4/compiler

}}}

(Check google on how to do it for your specific OS if you don't know how)

2.<br>

Now we're gonna download sdl and a couple of its libraries, if you're on linux there's a script you can use

{{{

cd <hedgewars-root>/project_files/Android-build

chmod +x download_libs.sh (might not be needed)

./download_libs.sh

}}}

This will download and unzip sdl to the expected folders

3.<br>

Finally you can use cmake to create the scripts

{{{

cd <hedgewars-root>

cmake . -DANDROID=1

}}}

And that’s it. To compile:

{{{

cd <hedgewars-root>/project_files/Android-build/

make -f Makefile.android

}}}

and it should be installed on your emulator/device if it was connected.

On the device/emulator you can start the application up :)