HowToBuildStendhal: Difference between revisions
Jump to navigation
Jump to search
Content deleted Content added
imported>AntumDeluge →Build Tools: reduce indentation level & add links |
imported>AntumDeluge mNo edit summary |
||
| (9 intermediate revisions by the same user not shown) | |||
| Line 5: | Line 5: | ||
= Build Tools = |
= Build Tools = |
||
See [[HowToBuildStendhal/BuildTools|build tools page]]. |
|||
== JDK == |
|||
The Stendhal server and legacy client are both written in [https://www.java.com/ Java]. To run either requires a [https://en.wikipedia.org/wiki/Java_virtual_machine Java Runtime Environment (JRE)]. To compile server or client, a [https://en.wikipedia.org/wiki/Java_Development_Kit Java Development Kit (JDK)] is necessary. Most JDK distributions include a JRE. |
|||
= Components = |
|||
=== JDK on Unix === |
|||
All component packages, other than Android client, can be built with a single Ant command: <span style="color:darkred;">''ant dist''</span>. This will output the following: |
|||
Some Unix/Linux/BSD systems have a JDK pre-installed (usually [https://openjdk.org/ OpenJDK]). If not, most will have a version available from the system package manager. |
|||
* ''<span style="color:darkblue;">build/stendhal-<version>-src.tar.gz</span>'' |
|||
Example of installing on Ubuntu: |
|||
* ''<span style="color:darkblue;">build/stendhal-server-<version>.zip</span> (includes web client)'' |
|||
<pre> |
|||
* ''<span style="color:darkblue;">build/stendhal-<version>.zip</span> (Java client)'' |
|||
# install version 17 |
|||
* ''<span style="color:darkblue;">build/stendhal-webclient-<version>.zip</span> (requires server)'' |
|||
$ sudo apt install openjdk-17-jdk |
|||
* ''<span style="color:darkblue;">build/stendhal-starter-<version>.zip</span> (obsolete)'' |
|||
</pre> |
|||
''<span style="color:darkblue;">'''TODO:''' Instructions for individual components.</span>'' |
|||
Example of installing on Arch: |
|||
<pre> |
|||
# install default version |
|||
$ sudo pacman -S jdk-openjdk |
|||
== Server and Web Client == |
|||
# install version 17 |
|||
$ sudo pacman -S jdk17-openjdk |
|||
</pre> |
|||
== Desktop Client == |
|||
Example of installing on FreeBSD: |
|||
<pre> |
|||
# install pre-built package of version 17 |
|||
$ sudo pkg install openjdk17 |
|||
== Java Desktop Client == |
|||
# compile version 17 from Ports source |
|||
$ cd /usr/ports/java/openjdk17 |
|||
$ sudo make install clean |
|||
</pre> |
|||
== Android Client == |
|||
* [[BuildStendhalForAndroid#WebView_Client|Build Stendhal WebView Client for Android]] |
|||
Packages for Windows can be downloaded from either [https://www.oracle.com/java/technologies/downloads/ oracle.com] or for OpenJDK, from [https://jdk.java.net/ jdk.java.net]. If you download a portable .zip package, you will need to manually configure the PATH environment variable so the system knows where the <span style="color:darkred;">''java''</span> and <span style="color:darkred;">''javac''</span> executables are located. It may also be necessary to configure the <span style="color:darkgreen;">''JAVA_HOME''</span> environment variable. The recommended method is to use an installer package (.exe or .msi) as these will configure the necessary environment variables automatically. |
|||
=== JDK on macOS === |
|||
Packages for macOS can be downloaded from either [https://www.oracle.com/java/technologies/downloads/ oracle.com] or for OpenJDK, from [https://jdk.java.net/ jdk.java.net]. But the recommended method is to install from the [https://brew.sh/ Homebrew Package Manager] as it will configure the necessary environment variables automatically. |
|||
Example of installing on macOS using Homebrew: |
|||
<pre> |
|||
# install version 17 |
|||
$ brew install openjdk@17 |
|||
</pre> |
|||
= Systems = |
= Systems = |
||
| Line 70: | Line 49: | ||
* [[BuildStendhalForAndroid#WebView_Client|Build Stendhal WebView Client for Android]] |
* [[BuildStendhalForAndroid#WebView_Client|Build Stendhal WebView Client for Android]] |
||
= General Information = |
|||
* [[HowToGetLatestStendhal|How to get the latest version?]] |
* [[HowToGetLatestStendhal|How to get the latest version?]] |
||