HowToBuildStendhal: Difference between revisions

From Arianne
Jump to navigation Jump to search
← Older edit
Content deleted Content added
imported>Hendrik Brummermann
No edit summary
imported>AntumDeluge
mNo edit summary
 
(59 intermediate revisions by 4 users not shown)
Line 2: Line 2:
{{Navigation for Stendhal Builders and Hosters}}
{{Navigation for Stendhal Builders and Hosters}}


Building Stendhal is very simple if you use ant and you satisfy the dependencies.


⚫
= 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'' or e.g.
<code>sudo aptitude install sun-java6-jdk</code>
* Ant 1.6<br>http://ant.apache.org or e.g.
<code>sudo aptitude install ant</code>


See [[HowToBuildStendhal/BuildTools|build tools page]].
⚫
== Build ==
=== Build a distribution using ant ===
First you need ant properly installed on your system to build Stendhal.


Then unpack the stendhal source gzip. From command line:
tar xzf stendhal-''version''-src.tar.gz
cd stendhal-''version''


= Components =
Now just write:
ant dist


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:
This will create a full set of release packages.
ant dist


* ''<span style="color:darkblue;">build/stendhal-&lt;version&gt;-src.tar.gz</span>''
This will create binaries such as
* ''<span style="color:darkblue;">build/stendhal-server-&lt;version&gt;.zip</span> (includes web client)''
;Client files
:build/stendhal-''version''.zip
* ''<span style="color:darkblue;">build/stendhal-&lt;version&gt;.zip</span> (Java client)''
:build/stendhal-FULL-''version''.zip
* ''<span style="color:darkblue;">build/stendhal-webclient-&lt;version&gt;.zip</span> (requires server)''
* ''<span style="color:darkblue;">build/stendhal-starter-&lt;version&gt;.zip</span> (obsolete)''


''<span style="color:darkblue;">'''TODO:''' Instructions for individual components.</span>''
;Server files
:build/stendhal-server-''version''.zip


== Server and Web Client ==
;Source files
:build/stendhal-src-''version''.tar.gz


== Desktop Client ==
=== Building just the jar files ===


== Java Desktop Client ==
To only build the jar file, you just write
ant


== Android Client ==
This will build a full set of JAR files at stendhal-''version''/build/lib folder.


* [[BuildStendhalForAndroid#WebView_Client|Build Stendhal WebView Client for Android]]
;Client files
:build/lib/stendhal-''version''.jar
:build/lib/stendhal-data-''version''.jar
:build/lib/stendhal-sound-data-''version''.jar


;Server files
:build/lib/stendhal-server-''version''.jar
:build/lib/stendhal-xmlconf-''version''.jar
:build/lib/stendhal-maps-''version''.jar


= Systems =
Note: If you are unsure, use the first section (ant dist) to get a working system with all the files in the correct server structure.


=== Build using IDE ===
== Windows ==
You can also [[Configure a development environment (IDE)]].


* [[VisualGuideToBuildingStendhal|Visual Guide to Building Stendhal on Windows®]]
== Trouble shooting ==
If you have the message error:
stendhal_source/build.xml:42: Could not create task or type of type: replaceregexp.


== GNU/Linux ==
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.


* [[BuildStendhalOnUbuntu|Building Stendhal on Ubuntu® - Installation Guide Step-by-step]]
= Finally =
When you have successfully built Stendhal please read the install documentation. It is available on the Wiki at [[InstallingStendhal]].


== Mac OS X ==
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.


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


== CVS ==
== Android WebView Client ==


* [[BuildStendhalForAndroid#WebView_Client|Build Stendhal WebView Client for Android]]
Assuming you have CVS installed, you can instead download our source from our CVS HEAD:
cvs -d:pserver:anonymous@arianne.cvs.sourceforge.net:/cvsroot/arianne login
cvs -z3 -d:pserver:anonymous@arianne.cvs.sourceforge.net:/cvsroot/arianne co -P ''stendhal''


= General Information =
Which will check out a copy of the stendhal source into a folder called ''stendhal''. Then follow the steps to build using ant as before. If you are asked for a password during checkout, just leave it empty and hit enter.


* [[HowToGetLatestStendhal|How to get the latest version?]]
⚫
[[Category:Stendhal]]


⚫
[[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"