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">
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" />
15 <p>Next:
<a href=
"pswgen03.html">03 - Generator Module
</a>, Previous:
<a href=
"pswgen01.html">01 - Introduction
</a></p>
17 <h1>eVaf Tutorial
</h1>
19 <h2>02 - Preparations
</h2>
21 <h3>Getting eVaf sources
</h3>
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>
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>
29 <pre> $
<code>git clone http://www.vaikene.net/git/evaf
</code></pre>
31 <p>This command downloads evaf sources into the sub-directory
<tt>evaf
</tt>.
</p>
33 <h3>Qt, CMake, gcc
</h3>
35 <p>Make sure that you have Qt version
4.6 and CMake version
2.6 or newer versions installed. If not, install
38 <p>The tutorial code is tested with gcc versions
4.4,
4.5 and
4.6.
</p>
40 <h3>Existing PswGen application
</h3>
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>
46 <h3>If you are running Windows
</h3>
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>
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>
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
"NMake Makefiles
"</tt> option to the
59 <tt>cmake
</tt> command;
</li>
60 <li>Use
<tt>nmake
</tt> command instead of
<tt>make
</tt>.
</li>
63 <p>eVafGUI.exe command line options with directory names like
<tt>--dataroot=
<path
></tt> expect
64 '/' as the directory separator even when running on Windows.
</p>
66 <p>In the next section
<a href=
"pswgen03.html">03 - Generator Module
</a> we start writing the Generator module.
</p>