]> vaikene.ee Git - evaf/blob - www/pswgen02.html
Windows build fix.
[evaf] / www / pswgen02.html
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2 <html lang="et" xmlns="http://www.w3.org/1999/xhtml" xml:lang="et">
3
4 <head>
5 <meta http-equiv="CONTENT-TYPE" content="text/html; charset=utf-8" />
6 <title>eVaf Tutorial - 02 - Preparations</title>
7 <meta name="Author" content="Enar Väikene" />
8 <meta name="description" content="eVaf Tutorial" />
9 <meta name="keywords" content="evaf c++ application development framework tutorial password generator" />
10 <link rel="StyleSheet" href="evaf.css" type="text/css" media="all" />
11 </head>
12
13 <body>
14
15 <p>Next: <a href="pswgen03.html">03 - Generator Module</a>, Previous: <a href="pswgen01.html">01 - Introduction</a></p>
16
17 <h1>eVaf Tutorial</h1>
18
19 <h2>02 - Preparations</h2>
20
21 <h3>Getting eVaf sources</h3>
22
23 <p>eVaf uses <a href="http://git-scm.com">git</a> as the version control system. If you don't have it installed
24 yet, install it now.</p>
25
26 <p>Then open your favorite terminal program and go to the root directory for all your development projects.
27 Clone the eVaf repository using the following command:</p>
28
29 <pre> $ <code>git clone http://www.vaikene.net/git/evaf</code></pre>
30
31 <p>This command downloads evaf sources into the sub-directory <tt>evaf</tt>.</p>
32
33 <h3>Qt, CMake, gcc</h3>
34
35 <p>Make sure that you have Qt version 4.6 and CMake version 2.6 or newer versions installed. If not, install
36 them now.</p>
37
38 <p>The tutorial code is tested with gcc versions 4.4, 4.5 and 4.6.</p>
39
40 <h3>Existing PswGen application</h3>
41
42 <p>The code that we write in this tutorial already exists in the <tt>src/apps/PswGen</tt> directory. Delete
43 or rename the existing PswGen application if you want to follow the tutorial and write a new application.
44 Then create a new sub-directory called <tt>PswGen</tt> in the <tt>src/apps</tt> directory.</p>
45
46 <h3>If you are running Windows</h3>
47
48 <p>If you happen to be running Windows instead of Linux, then you still need git, CMake and Qt installed.
49 The tutorial code is tested with Visual C++ 2010 Express and Visual Studio 2005 Professional editions.
50 Use the <tt>Git Bash</tt> command prompt to clone the repository.</p>
51
52 <p>The code is fully portable and needs no changes to build on Windows. However, build commands itself
53 have to be modified:</p>
54
55 <ol>
56 <li>Use the <tt>Visual Studio NNNN Command Prompt</tt> to run build commands. Make sure that Qt and CMake
57 binaries are in the path inside the command prompt;</li>
58 <li>When running <tt>cmake</tt>, add the <tt>-G &quot;NMake Makefiles&quot;</tt> option to the
59 <tt>cmake</tt> command;</li>
60 <li>Use <tt>nmake</tt> command instead of <tt>make</tt>.</li>
61 </ol>
62
63 <p>eVafGUI.exe command line options with directory names like <tt>--dataroot=&lt;path&gt;</tt> expect
64 '/' as the directory separator even when running on Windows.</p>
65
66 <p>In the next section <a href="pswgen03.html">03 - Generator Module</a> we start writing the Generator module.</p>
67
68 </body>
69
70 </html>