BuildStendhalForAndroid: Difference between revisions
imported>AntumDeluge add navigation menus |
imported>AntumDeluge note that building from IDE instructions not yet available |
||
| Line 12: | Line 12: | ||
The [https://developer.android.com/studio/ Android Software Development Kit (SDK) libraries] are required. You will need to install these on your system. The minimum supported version is currently 21. |
The [https://developer.android.com/studio/ Android Software Development Kit (SDK) libraries] are required. You will need to install these on your system. The minimum supported version is currently 21. |
||
== |
== Building from IDE == |
||
=== Android Studio === |
|||
''<span style="color:red;">instructions not yet available</span>'' |
|||
=== Eclipse === |
|||
''<span style="color:red;">instructions not yet available</span>'' |
|||
=== Netbeans === |
|||
''<span style="color:red;">instructions not yet available</span>'' |
|||
== Building from Command Line == |
|||
=== Gradle === |
|||
The [https://gradle.org/ Gradle Build Tool] is used for building. The necessary tools are already included with the source code. Two scripts are provided for executing the build: <span style="color:green;">android/gradlew</span> for Unix/Linux systems, & <span style="color:green;">android/gradlew.bat</span> for Windows. |
The [https://gradle.org/ Gradle Build Tool] is used for building. The necessary tools are already included with the source code. Two scripts are provided for executing the build: <span style="color:green;">android/gradlew</span> for Unix/Linux systems, & <span style="color:green;">android/gradlew.bat</span> for Windows. |
||
| Line 41: | Line 57: | ||
</pre> |
</pre> |
||
== Ant == |
=== 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 rules apply to using the Gradle scripts directly. |
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 rules apply to using the Gradle scripts directly. |
||
| Line 60: | Line 76: | ||
[[Category:Development]] |
[[Category:Development]] |
||
[[Cateogry:Build]] |
|||
[[Category:Android]] |
[[Category:Android]] |
||
Revision as of 00:30, 15 January 2022
- |
WebView Client
NOTICE: The Android WebView client is not currently implemented in the upstream source code. You can get the experimental source from https://github.com/AntumDeluge/arianne-stendhal/tree/android_webview.
These instructions are for building the WebView client for the Android platform.
Android SDK
The Android Software Development Kit (SDK) libraries are required. You will need to install these on your system. The minimum supported version is currently 21.
Building from IDE
Android Studio
instructions not yet available
Eclipse
instructions not yet available
Netbeans
instructions not yet available
Building from Command Line
Gradle
The Gradle Build Tool is used for building. The necessary tools are already included with the source code. Two scripts are provided for executing the build: android/gradlew for Unix/Linux systems, & android/gradlew.bat for Windows.
In order for the build to complete, the scripts must know where the SDK libraries are located. The script will check the ANDROID_SDK_ROOT environment variable, or it will parse the value of sdk.dir in the android/local.properties file (NOTE: Windows users must use double backslashes for directories (\\)).
Example local.properties for Unix/Linux:
sdk.dir=/path/to/sdk/root
Example local.properties for Windows:
sdk.dir=C:\\path\\to\\sdk\\root
NOTE: On Windows, if you used Android Studio to download the SDK, it will be located in C:\\Users\\<username>\\AppData\\Local\\Android\\Sdk.
From a command line or terminal, move into the android sub-directory & execute the following.
Unix/Linux example:
# with env variable set or sdk.dir set in local.properties $ ./gradlew build # manually setting env variable $ ANDROID_SDK_ROOT="/path/to/sdk/root" ./gradlew build
Ant
As with other instructions on building from the command line, the Android client can also be built with an Apache Ant target. The same rules apply to using the Gradle scripts directly.
From the Stendhal source root directory, execute the following.
Unix/Linux example:
# with env variable set or sdk.dir set in local.properties $ ant dist_client_android # manually setting env variable $ ANDROID_SDK_ROOT="/path/to/sdk/root" ant dist_client_android
The resulting .apk packages will be located in the build directory. Cateogry:Build