HowToBuildStendhal: Difference between revisions
imported>AntumDeluge →JDK on Windows: installing using WinGet |
imported>AntumDeluge →Ant: installation instructions |
||
| Line 61: | Line 61: | ||
# install version 17 |
# install version 17 |
||
$ brew install openjdk@17 |
$ brew install openjdk@17 |
||
</pre> |
|||
== Ant == |
|||
[https://ant.apache.org/ Apache Ant] is the main tool for building from the command line. All components can be built using this method. However, some components are built using another tool to which Ant serves as a wrapper to call its commands. For example, the Android app is built using [https://gradle.org/ Gradle] (or a Gradle Wrapper). In this case, Gradle builds the app. Ant simply calls Gradle as a sub-command. |
|||
Apache provides executables for multiple systems from their [https://ant.apache.org/bindownload.cgi downloads page]. Alternatively, see the following instructions for specific systems. |
|||
=== Ant on Unix === |
|||
Most Unix/Linux/BSD distributions have a version of Ant available from the default package manager. |
|||
Example of installing on Ubuntu: |
|||
<pre> |
|||
$ sudo apt install ant |
|||
</pre> |
|||
Example of installing on Arch: |
|||
<pre> |
|||
$ sudo pacman -S ant |
|||
</pre> |
|||
Example of installing on FreeBSD: |
|||
<pre> |
|||
# install pre-built package |
|||
$ sudo pkg install apache-ant |
|||
# compile from Ports source |
|||
$ cd /usr/ports/devel/apache-ant |
|||
$ sudo make install clean |
|||
</pre> |
|||
=== Ant on Windows === |
|||
For Windows, follow these steps: |
|||
# Download one of the <span style="color:darkblue;">''apache-ant-<version>-bin</span> packages from the link above (Windows supports .zip archives by default). |
|||
# Extract the package contents to a unique directory. |
|||
# Add the directory path to your system's PATH environment variable. |
|||
# Open a command prompt (cmd). Type <span style="color:darkred;">''ant -version''</span> and press "enter". If it is set up correctly, version information will be printed. |
|||
=== Ant on macOS === |
|||
For macOS, the same instructions for [[HowToBuildStendhal#Ant_on_Windows|Windows]] can be used. Alternatively, it is also provided through Homebrew. |
|||
Example of installing on macOS using Homebrew: |
|||
<pre> |
|||
$ brew install ant |
|||
</pre> |
</pre> |
||
Revision as of 21:33, 12 January 2026
- |
Build Tools
JDK
The Stendhal server and legacy client are both written in Java. To run either requires a Java Runtime Environment (JRE). To compile server or client, a Java Development Kit (JDK) is necessary. Most JDK distributions include a JRE.
JDK on Unix
Some Unix/Linux/BSD systems have a JDK pre-installed (usually OpenJDK). If not, most will have a version available from the system package manager.
Example of installing on Ubuntu:
# install version 17 $ sudo apt install openjdk-17-jdk
Example of installing on Arch:
# install default version $ sudo pacman -S jdk-openjdk # install version 17 $ sudo pacman -S jdk17-openjdk
Example of installing on FreeBSD:
# install pre-built package of version 17 $ sudo pkg install openjdk17 # compile version 17 from Ports source $ cd /usr/ports/java/openjdk17 $ sudo make install clean
JDK on Windows
Packages for Windows can be downloaded from either oracle.com or for OpenJDK, from 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 java and javac executables are located. It may also be necessary to configure the JAVA_HOME environment variable. The recommended method is to use an installer package (.exe or .msi) as these will configure the necessary environment variables automatically.
Alternatively, a JDK can be installed from the Windows Package Manager (WinGet).
Example of installing on Windows using WinGet:
:: install Oracle JDK version 17 > winget install Oracle.JDK.17 :: install OpenJDK version 17 > winget install ojdkbuild.openjdk.17.jdk
JDK on macOS
Packages for macOS can be downloaded from either oracle.com or for OpenJDK, from jdk.java.net. But the recommended method is to install from the Homebrew Package Manager as it will configure the necessary environment variables automatically.
Example of installing on macOS using Homebrew:
# install version 17 $ brew install openjdk@17
Ant
Apache Ant is the main tool for building from the command line. All components can be built using this method. However, some components are built using another tool to which Ant serves as a wrapper to call its commands. For example, the Android app is built using Gradle (or a Gradle Wrapper). In this case, Gradle builds the app. Ant simply calls Gradle as a sub-command.
Apache provides executables for multiple systems from their downloads page. Alternatively, see the following instructions for specific systems.
Ant on Unix
Most Unix/Linux/BSD distributions have a version of Ant available from the default package manager.
Example of installing on Ubuntu:
$ sudo apt install ant
Example of installing on Arch:
$ sudo pacman -S ant
Example of installing on FreeBSD:
# install pre-built package $ sudo pkg install apache-ant # compile from Ports source $ cd /usr/ports/devel/apache-ant $ sudo make install clean
Ant on Windows
For Windows, follow these steps:
- Download one of the apache-ant-<version>-bin packages from the link above (Windows supports .zip archives by default).
- Extract the package contents to a unique directory.
- Add the directory path to your system's PATH environment variable.
- Open a command prompt (cmd). Type ant -version and press "enter". If it is set up correctly, version information will be printed.
Ant on macOS
For macOS, the same instructions for Windows can be used. Alternatively, it is also provided through Homebrew.
Example of installing on macOS using Homebrew:
$ brew install ant