Free cookie consent management tool by TermsFeed Policy Generator

source: branches/HeuristicLab.Problems.GPDL/BUILDING @ 10066

Last change on this file since 10066 was 10066, checked in by gkronber, 11 years ago

#2026 added instructions on building, a short readme and the GPL license file.

File size: 2.4 KB
Line 
1This document describes how the GPDL compiler can be built on
2Windows and Linux systems.
3
4
5Windows
6-------
7
8You can either use Visual Studio including the free Express Edition to
9open the solution file HeuristicLab.Problems.GPDL.sln, or
10alternatively you can use the msbuild command. For convenience we also
11provide the 'Build.cmd' script which can be used to build the
12solution.
13
14> Build.cmd
15
16The binary files will be generated in 'bin' folders within the
17projects. To try the SyntaxAnalyser use the command (from the solution
18directory):
19
20> SyntaxAnalyser/bin/Debug/SyntaxAnalyser.exe Examples/Multiplexer.txt
21
22There are more GPDL example files in the folder 'Examples'.
23
24To try the GPDL compiler use the following command:
25
26> GpdlCompiler/bin/Debug/GpdlCompiler.exe Example/Multiplexer.txt
27
28This will generate the file 'Multiplexer.cs' which can be compiled
29with the C# compiler:
30
31> csc Multiplexer.cs
32> Multiplexer.exe
33
34Linux
35-----
36
37On Linux the compiler can be build with Mono. The source uses C# 4.0
38syntax so you need a recent version of Mono that supports C# 4.0 (we
39tested with mono 2.10.8.1).
40
41On the development system (Debian Wheezy) the following packages and
42their requirements need to be installed:
43  * mono-mcs
44  * mono-xbuild
45  * mono-dmcs
46  * mono-gmcs
47
48To build the solution use the xbuild command. xbuild is the mono
49equivalent for the msbuild command and can be used to build Visual
50Studio solution files on Linux.
51
52> xbuild HeuristicLab.Problems.GPDL.sln
53
54The compiled binaries will be generated in 'bin/' folders within the
55projects.
56To test the syntax analyser use the command:
57
58> mono SyntaxAnalyser/bin/Debug/SyntaxAnalyser.exe Examples/LawnMower.txt
59
60There are further examples of GPDL definition files in the 'Examples'
61folder.
62
63To test the compiler use the command:
64> mono GpdlCompiler/bin/Debug/GpdlCompuler.exe Examples/LawnMower.txt
65
66This command will generate the C# source file of the solver
67'Lawnmower.cs' which can be compiled to an executable using the
68C#-compiler
69
70> mcs LawnMower.cs
71> mono LawnMower.exe
72
73MacOS
74-----
75
76We have not yet tried to build the source on MacOS with Mono. Most
77likely it is necessary to create a 'GenerateFromAtg' script which
78works on MacOS. Additionally, the pre-build events of the two projects
79'HeuristicLab.Problems.GPDL.csprj' and 'SyntaxAnalyser.csprj' have to
80be changed to call the correct script. Please let us know if you
81manage to compile and run the GPDL compiler on MacOS!
82
83Oct. 2013, Gabriel Kronberger
Note: See TracBrowser for help on using the repository browser.