BuildStendhalForAndroid: Difference between revisions

=== Ant ===

As with other instructions on building from the command line, the Android client can also be built with an [https://ant.apache.org/ Apache Ant target]. The same conditions related to invoking the Gradle scripts directly apply to using ant.

From the Stendhal source root directory, execute the following.

Unix/Linux example:

<pre>

# with env variable set or sdk.dir set in local.properties

$ ant android

# manually setting env variable

$ ANDROID_SDK_ROOT="/path/to/sdk/root" ant android

</pre>

Windows '''cmd''' example:

<pre>

# with env variable set or sdk.dir set in local.properties

> ant android

# manually setting env variable (do not use quotes)

> set ANDROID_SDK_ROOT=C:\\path\\to\\sdk\\root

> ant android

</pre>

The resulting .apk packages will be located in the <span style="color:green;"><source root>/build</span> directory.

The build type can be set manually using the <span style="color:green;">android.build</span> property. Value can be one of <span style="color:green;">assembleRelease</span> or <span style="color:green;">assembleDebug</span>. The default is <span style="color:green;">assembleDebug</span>.

<pre>

$ ant android -Dandroid.build=assembleRelease

</pre>

=== Setting Revision Suffix ===

The compiled .apk packages will be versioned with the date of build. A custom revision suffix can be added by setting the <span style="color:darkgreen;">android.rev</span> property. If invoking gradle script directly, use the '''''-P''''' switch. If calling ant, use the '''''-D''''' switch.

Example usage:

<pre>

# calling gradle script directly

$ ./gradlew assembleDebug -Pandroid.rev=1

# calling ant target

$ ant android -Dandroid.rev=1

</pre>

Example output: ''stendhal-webview-{{#time:Ymd}}-1-debug.apk''