HowToBuildStendhal: Difference between revisions
Jump to navigation
Jump to search
Content deleted Content added
imported>Hendrik Brummermann |
imported>Oslsachem Added building guides |
||
| 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. |
|||
== |
==Windows== |
||
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> |
|||
<!--* [[VisualGuideToBuildingStendhal|Building Stendhal on Windows XP® - Visual Installation Guide Step-by-step]]--> |
|||
== 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'' |
|||
==GNU/Linux== |
|||
Now just write: |
|||
ant dist |
|||
* [[BuildStendhalOnUbuntu|Building Stendhal on Ubuntu® - Installation Guide Step-by-step]] |
|||
This will create binaries such as |
|||
;Client files |
|||
:build/stendhal-''version''.zip |
|||
:build/stendhal-FULL-''version''.zip |
|||
== General information == |
|||
;Server files |
|||
:build/stendhal-server-''version''.zip |
|||
* [[HowToGetLatestStendhal|How to get the latest version?]] |
|||
;Source files |
|||
:build/stendhal-src-''version''.tar.gz |
|||
* [[HowToBuildStendhal|How to build Stendhal]] - ''recommended'' |
|||
=== Building just the jar files === |
|||
To only build the jar file, you 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 |
|||
Note: If you are unsure, use the first section (ant dist) to get a working system with all the files in the correct directory structure. |
|||
=== 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]] |
|||