VisualGuideToBuildingStendhalStep2: Difference between revisions

From Arianne
Jump to navigation Jump to search
Content deleted Content added
imported>Oslsachem
No edit summary
imported>Hendrik Brummermann
require node.js
 
(26 intermediate revisions by 2 users not shown)
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


Select this block of text and copy it:
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>


@echo off
'''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.
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
cmd /c ant dist
pause


Paste it in a notepad document and save it as AntDist.cmd '''and with 'All Files' as the file type''':
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>


[[File:Step22AntConfig01.png]]
http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure08.png


From now on, you can right-click on its filename to edit it:
Note: Capitalization doesn't matter.


[[File:Step22AntConfig02.png]]
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/Step22AntConfigure09.png


Set <tt>JAVA_HOME</tt> to wherever you have java JDK installed.
Again, click on <tt>Accept</tt>:


== Step 2.2 Install Node.js ==
http://arianne.sourceforge.net/wiki_images/visual_guide_build/Step2AntInstallAndConfigure/Step22AntConfigure/Step22AntConfigure10.png


Get and install Node.js from https://nodejs.org
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 TortoiseGit]]

Latest revision as of 21:39, 5 January 2022

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
cmd /c ant dist
pause

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.

Step 2.2 Install Node.js

Get and install Node.js from https://nodejs.org

Go to Step 3. Install TortoiseGit