HowToBuildStendhal: Difference between revisions
Jump to navigation
Jump to search
Content deleted Content added
imported>Kymara remove webstart instructions from here, it's a bit beyond the scope of this simple guide. src comes with all dependencies now. add cvs instructions. |
imported>AntumDeluge mNo edit summary |
||
| (100 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)]]. |
|||
| ⚫ | |||
=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/ |
|||
= |
= Components = |
||
| ⚫ | |||
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. From command line: |
|||
tar xzf stendhal-''version''-src.tar.gz |
|||
cd stendhal-''version'' |
|||
* ''<span style="color:darkblue;">build/stendhal-<version>-src.tar.gz</span>'' |
|||
Now just write: |
|||
* ''<span style="color:darkblue;">build/stendhal-server-<version>.zip</span> (includes web client)'' |
|||
ant |
|||
* ''<span style="color:darkblue;">build/stendhal-<version>.zip</span> (Java client)'' |
|||
This will build a full set of JAR files at stendhal-''version''/build/lib folder. |
|||
* ''<span style="color:darkblue;">build/stendhal-webclient-<version>.zip</span> (requires server)'' |
|||
* ''<span style="color:darkblue;">build/stendhal-starter-<version>.zip</span> (obsolete)'' |
|||
''<span style="color:darkblue;">'''TODO:''' Instructions for individual components.</span>'' |
|||
;Client files |
|||
:build/lib/stendhal-''version''.jar |
|||
:build/lib/stendhal-data-''version''.jar |
|||
:build/lib/stendhal-sound-data-''version''.jar |
|||
== Server and Web Client == |
|||
:build/lib/stendhal-server-''version''.jar |
|||
:build/lib/stendhal-xmlconf-''version''.jar |
|||
:build/lib/stendhal-maps-''version''.jar |
|||
== Desktop Client == |
|||
If you want to create a full set of release packages you can write |
|||
ant dist |
|||
== Java Desktop Client == |
|||
This will create binaries such as |
|||
;Client files |
|||
:build/stendhal-''version''.zip |
|||
:build/stendhal-FULL-''version''.zip |
|||
== Android Client == |
|||
;Server files |
|||
:build/stendhal-server-''version''.zip |
|||
* [[BuildStendhalForAndroid#WebView_Client|Build Stendhal WebView Client for Android]] |
|||
;Source files |
|||
:build/stendhal-src-''version''.tar.gz |
|||
= Trouble shooting = |
|||
If you have the message error: |
|||
stendhal_source/build.xml:42: Could not create task or type of type: replaceregexp. |
|||
= Systems = |
|||
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. |
|||
= |
== Windows == |
||
When you have successfully built Stendhal please read the install documentation. It is available on the Wiki at [[InstallingStendhal]]. |
|||
* [[VisualGuideToBuildingStendhal|Visual Guide to Building Stendhal on Windows®]] |
|||
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. |
|||
== GNU/Linux == |
|||
* [[BuildStendhalOnUbuntu|Building Stendhal on Ubuntu® - Installation Guide Step-by-step]] |
|||
= CVS = |
|||
== Mac OS X == |
|||
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'' |
|||
* [[BuildStendhalOnMacOsX|Build Stendhal On Mac Os X]] |
|||
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. |
|||
<br> |
|||
<br> |
|||
<br> |
|||
---- |
|||
== Android WebView Client == |
|||
[[Stendhal | Back to stendhal main wiki page]] |
|||
* [[BuildStendhalForAndroid#WebView_Client|Build Stendhal WebView Client for Android]] |
|||
| ⚫ | |||
= General Information = |
|||
* [[HowToGetLatestStendhal|How to get the latest version?]] |
|||
| ⚫ | |||