HowToBuildStendhal: Difference between revisions

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

==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>

== Build ==

=== Build 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''

Now just write:

ant

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

;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

If you want to create a full set of release packages you can write

ant dist

This will create binaries such as

;Client files

:build/stendhal-''version''.zip

:build/stendhal-FULL-''version''.zip

;Server files

:build/stendhal-server-''version''.zip

;Source files

:build/stendhal-src-''version''.tar.gz

=== Build using IDE ===

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

== Trouble shooting ==

If you have the message error:

stendhal_source/build.xml:42: Could not create task or type of type: replaceregexp.

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.

= Finally =

When you have successfully built Stendhal please read the install documentation. It is available on the Wiki at [[InstallingStendhal]].

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.

== CVS ==

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''

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.

[[Category:Stendhal]]