VisualGuideToBuildingStendhalStep2: Difference between revisions

From Arianne
Jump to navigation Jump to search
Content deleted Content added
imported>Oslsachem
No edit summary
imported>Oslsachem
update
Line 1: Line 1:
==Step 2. Install and Configure Ant==
==Step 2. Install and Configure Ant==
Ant is a frontend to the java compiler that makes the compiling process as easy as typing <tt>ant</tt> (with or without options) inside a folder where there is a ''build.xml'' file.
Ant is a frontend to the java compiler that makes the building process as easy as double-clicking a batch file (AntDist.cmd).


===Step 2.1. Install Ant===
===Step 2.1. Install Ant===
Go to the Apache Ant's website and download the following binary installer package: [http://ant.apache.org/bindownload.cgi apache-ant-1.6.5-bin.zip]


First, go to the Apache's Ant website:
Unzip ant under ''C:\ant'' folder


http://ant.apache.org/bindownload.cgi
http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step21AntInstall/Step21AntInstall01.png


[[File:Step21AntInstall01.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step21AntInstall/Step21AntInstall02.png


Unzip apache-ant-1.8.2-bin.zip under the ''C:\'' drive
===Step 2.2. Configure Ant===


[[File:Step21AntInstall02.png]]
Go to Start-> Configuration -> Control Panel


And rename the folder to ant:
http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure01.png


[[File:Step21AntInstall03.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure02.png


This should be the end result:
Select the <tt>Advanced</tt> tab and then click on <tt>Environment Variables</tt>:


[[File:Step21AntInstall04.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure03.png


===Step 2.2. Configure Ant===
In <tt>User Variables</tt> click on <tt>New</tt>

http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure04.png

Set <tt>Variable name</tt> to <tt>ANT_HOME</tt> and <tt>Variable value</tt> to <tt>C:\ant</tt> and click on <tt>Accept</tt>

http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure05.png

Again, in <tt>User Variables</tt> click on <tt>New</tt>

http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure04.png

Set <tt>Variable name</tt> to <tt>JAVA_HOME</tt> and <tt>Variable value</tt> to <tt>C:\Program Files\Java\jdk1.5.0_06</tt> (or wherever you have installed java JDK) and click on <tt>Accept</tt>

http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure06.png

Now look for <tt>Path</tt> variable in <tt>System Variables</tt> and click on <tt>Modify</tt>:

http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure07.png

Note: The PATH is a series of directories separated by semi-colons (;). Microsoft Windows looks for programs in the PATH directories in order, from left to right. You should only have one bin directory for Ant in the path at a time (those following the first are ignored), so if one is already present, you can update it to <tt>C:\ant\bin</tt>

'''Warning:''' Be careful when editing the path or you can end with an unworking system. Just be careful enough to add the values to the end of your path after a semmicolon without deleting any other previous values. When you are in doubt that you may have deleted something that was there previously, just click on <tt>Cancel</tt> and begin again.


Select this block of text and copy it:
Click on the <tt>Variable value</tt> text box, go to the end with <tt>End</tt> key and add <tt>;C:\ant</tt> (ommit the preceding semicolon if there's already one) and click on <tt>Accept</tt>


@echo off
http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure08.png
REM Change the folder path in the following line if, for example, you have extracted ant without
REM renaming the folder afterwards (even though renaming it is highly recommended)
REM Never leave any space between the variable's name and the equal sign
REM Otherwise, it will simply not work
set ANT_HOME=C:\ant
REM Change the folder path in the following line to the folder path of your
REM own version of Java's JDK
REM Never leave any space between the variable's name and the equal sign
REM Otherwise, it will simply not work
set JAVA_HOME=C:\Archivos de programa\Java\jdk1.6.0_25
REM Do not change the rest of this file
set Path=%Path%;%ANT_HOME%\bin
ant dist
pause
exit


Paste it in a notepad document and save it as AntDist.cmd '''and with 'All Files' as the file type''':
Note: Capitalization doesn't matter.


[[File:Step22AntConfig01.png]]
Click on <tt>Accept</tt>:


From now on, you can right-click on its filename to edit it:
http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure09.png


[[File:Step22AntConfig02.png]]
Again, click on <tt>Accept</tt>:


Set <tt>ANT_HOME</tt> to wherever you have ant installed.
http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure10.png


Set <tt>JAVA_HOME</tt> to wherever you have java JDK installed.
The new path takes effect in each new Command Prompt window you open after setting the PATH variable.


Go to [[VisualGuideToBuildingStendhalStep3|Step 3. Install Stendhal-server sources or map editor CVS sources]]
Go to [[VisualGuideToBuildingStendhalStep3|Step 3. Install and Configure TortoiseCVS]]

Revision as of 22:45, 7 June 2011

Step 2. Install and Configure Ant

Ant is a frontend to the java compiler that makes the building process as easy as double-clicking a batch file (AntDist.cmd).

Step 2.1. Install Ant

First, go to the Apache's Ant website:

http://ant.apache.org/bindownload.cgi

Unzip apache-ant-1.8.2-bin.zip under the C:\ drive

And rename the folder to ant:

This should be the end result:

Step 2.2. Configure Ant

Select this block of text and copy it:

@echo off


REM Change the folder path in the following line if, for example, you have extracted ant without
REM renaming the folder afterwards (even though renaming it is highly recommended)
REM Never leave any space between the variable's name and the equal sign
REM Otherwise, it will simply not work



set ANT_HOME=C:\ant



REM Change the folder path in the following line to the folder path of your
REM own version of Java's JDK
REM Never leave any space between the variable's name and the equal sign
REM Otherwise, it will simply not work



set JAVA_HOME=C:\Archivos de programa\Java\jdk1.6.0_25



REM Do not change the rest of this file

set Path=%Path%;%ANT_HOME%\bin
ant dist
pause
exit

Paste it in a notepad document and save it as AntDist.cmd and with 'All Files' as the file type:

From now on, you can right-click on its filename to edit it:

Set ANT_HOME to wherever you have ant installed.

Set JAVA_HOME to wherever you have java JDK installed.

Go to Step 3. Install and Configure TortoiseCVS