HowToBuildStendhal: Difference between revisions

From Arianne
Jump to navigation Jump to search
← Older edit
Content deleted Content added
imported>Kymara
No edit summary
imported>AntumDeluge
mNo edit summary
 
(104 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Navigation for Stendhal Top|Building & Hosting}}
Building Stendhal is very simple if you use ant and you satisfy the dependencies.
{{Navigation for Stendhal Builders and Hosters}}


You can also [[Configure a development environment (IDE)]].


⚫
= Build Tools =
=Requirements=
To compile Stendhal you will need:
* stendhal source as a stendhal-''version''-src.tar.gz <br>http://arianne.sourceforge.net/?arianne_url=games/game_stendhal#downloads
* Java SDK 1.5<br>http://java.sun.com ''or higher''
* Ant 1.6<br>http://ant.apache.org


See [[HowToBuildStendhal/BuildTools|build tools page]].
Optionally:
* Tiled<br>http://mapeditor.org/


We do not include dependencies in the source download, to keep the size small. They are in CVS, however, and you can download them via the CVS webfrontend at http://arianne.cvs.sourceforge.net/arianne/stendhal/libs/


= Build=
= Components =
⚫
==Build using ant==
First you need ant properly installed on your system to build Stendhal.


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:
Then unpack the stendhal source gzip.


* ''<span style="color:darkblue;">build/stendhal-&lt;version&gt;-src.tar.gz</span>''
<pre>
* ''<span style="color:darkblue;">build/stendhal-server-&lt;version&gt;.zip</span> (includes web client)''
cd path/to/stendhal source
* ''<span style="color:darkblue;">build/stendhal-&lt;version&gt;.zip</span> (Java client)''
cd stendhal
* ''<span style="color:darkblue;">build/stendhal-webclient-&lt;version&gt;.zip</span> (requires server)''
</pre>
* ''<span style="color:darkblue;">build/stendhal-starter-&lt;version&gt;.zip</span> (obsolete)''


''<span style="color:darkblue;">'''TODO:''' Instructions for individual components.</span>''
Now add any missing dependencies to the ''lib'' folder: ''TODO: check what these are''


== Server and Web Client ==
Now just write:
ant dist


== Desktop Client ==
This will build a full set of JAR files at stendhal/build/lib folder.


Client files
== Java Desktop Client ==
build/lib/stendhal-''version''.jar
build/lib/stendhal-data-''version''.jar
build/lib/stendhal-sound-data-''version''.jar


== Android Client ==
Server files
build/lib/stendhal-server-''version''.jar
build/lib/stendhal-xmlconf-''version''.jar
build/lib/stendhal-maps-''version''.jar


* [[BuildStendhalForAndroid#WebView_Client|Build Stendhal WebView Client for Android]]
⚫
== Webstart ==
In order for webstart to work, the client .jar-files have to be signed. There is some documentation on http://java.sun.com how this works. So I will put here only a small piece of information to get it integrated into the build process:


Put your private key into a file called keystore.ks into the stendhal-root folder
Create a file called build.ant-private.properties with theses lines (replacing the values):
keystore.alias=''miguelangelblanchlardin@hotmail.com''
keystore.password=''secret''


= Systems =
= Trouble shooting =
If you have the message error:
stendhal_source/build.xml:42: Could not create task or type of type: replaceregexp.


⚫
== Windows ==
For linux users this is corrected by installing the "ant-apache-regexp" package. If you use debian or another debian dist (like Ubuntu) this is included in the "ant-optional" package.


* [[VisualGuideToBuildingStendhal|Visual Guide to Building Stendhal on Windows®]]
= Finally =
When you have successfully built Stendhal please read the install documentation. It is available on the Wiki at [[InstallingStendhal]].


== GNU/Linux ==
In future if you wish to just create the client and server jars (not zips and all release packages) then
ant clean compile
will suffice. Remember to "ant clean" before you "ant build" everytime - this is done automatically if you "ant dist", however.


* [[BuildStendhalOnUbuntu|Building Stendhal on Ubuntu® - Installation Guide Step-by-step]]
<br>
<br>
<br>
----


== Mac OS X ==
[[Stendhal | Back to stendhal main wiki page]]


[[Category:Stendhal]]
* [[BuildStendhalOnMacOsX|Build Stendhal On Mac Os X]]

== Android WebView Client ==

* [[BuildStendhalForAndroid#WebView_Client|Build Stendhal WebView Client for Android]]

= General Information =

* [[HowToGetLatestStendhal|How to get the latest version?]]


[[Category:Development]]

Latest revision as of 23:40, 12 January 2026



Build Tools

See build tools page.


Components

All component packages, other than Android client, can be built with a single Ant command: ant dist. This will output the following:

  • build/stendhal-<version>-src.tar.gz
  • build/stendhal-server-<version>.zip (includes web client)
  • build/stendhal-<version>.zip (Java client)
  • build/stendhal-webclient-<version>.zip (requires server)
  • build/stendhal-starter-<version>.zip (obsolete)

TODO: Instructions for individual components.

Server and Web Client

Desktop Client

Java Desktop Client

Android Client


Systems

Windows

GNU/Linux

Mac OS X

Android WebView Client

General Information

Retrieved from "https://meet.konsthol.eu/w/index.php?title=HowToBuildStendhal&oldid=118614"