Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
arcs2:installing_arcs [2013/08/19 15:05]
didier
arcs2:installing_arcs [2013/08/20 15:54] (current)
didier [Installing ARCS]
Line 1: Line 1:
 +====== Installing ARCS ======
 +** Please notice that this procedure is only for the current version of ARCS. **
 +
 +The installation of ARCS has to follow several steps:
 +   * Install Qt, version 4.3+ (required dependency -- also works with Qt5.x). You may install Qt from [[http://​qt-project.org|its site]] but do not forget your linux distribution (if you use one) is more likely to already have a package for Qt;
 +   * [[:​get_arcs|Download ARCS]];
 +   * Build ARCS from the sources.
 +
 +===== Building ARCS under Linux =====
 +==== Preparing the environment ====
 +To compile ARCS, you will need to export several environment libraries.
 +<code bash>
 +export ARCSDIR=/​path/​to/​ARCS/​sources
 +export PATH=$PATH:​$ARCSDIR/​bin
 +export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:​$ARCSDIR/​lib
 +</​code>​
 +This allows to tell where ARCS sources are put and where executables as well as libraries will be found.
 +If you intend to use ARCS in a dedicated directory (i.e. without installing it on the system), you might be interested
 +in putting these environment variables into a ''​.bashrc''​ or ''​.profile''​ file in your home directory.
 +
 +==== Building ARCS sources ====
 +The usual procedure to build ARCS from sources is then the following one:
 +<code bash>
 +tar xvf arcs2-current.tar.gz ​
 +cd ARCS2-YYYY-MM-DD
 +qmake
 +make
 +</​code>​
 +
 +This could be translated as:
 +  - Unpack the archive;
 +  - Go into the unpacked directory;
 +  - Run the ''​qmake''​ utility from Qt framework in order to generate a ''​Makefile'';​
 +  - Build sources.
 +
 +A few optional steps may be performed:
 +  * ''​make docs'':​ will generate [[http://​www.stack.nl/​~dimitri/​doxygen/​|doxygen]] documentation;​
 +  * ''​make install'':​ will install ARCS on the system.
 +
 +===== Building ARCS under Windows =====
 +
 +==== Preparing the environment ====
 +You must set several environment variables in order to compile ARCS. 
 +Under Windows XP, you will have to right click on **My computer**, choose the entry **Property**,​ the **Advanced** tab, and then the button **Environment variables**. ​  
 +You should add two different variables :
 +  * ''​QMAKESPEC''​ with the value ''​win32-msvc.net''​ if you are using Visual Studio .net or Visual Studio Express ;
 +  * ''​QTDIR''​ with the value ''​c:​\qt4''​ or another value if you have unpacked the archive elsewhere. ​
 +You should also add to the ''​PATH''​ environment variable the value ''​c:​\qt4\bin''​. ​  
 +
 +==== Building ARCS sources ====
 +You will have to do the following steps :
 +  * Unpack the archive ;
 +  * Open a command line inside the directory obtained after unpacking the archive ;
 +  * Launch ''​qmake''​ ;
 +  * Open the file with the extension ''​.vcproj''​ using Visual and select the ''​release''​ configuration ;
 +  * Build the project under Visual ;
 +  * At the end of the process you should have all that is required to have a minimalist ARCS framework working under Microsoft Windows.
 + 
 +===== Next step =====
 +The next step is to check the engine is well installed and behaves well.