aboutsummaryrefslogtreecommitdiff
path: root/INSTALL
blob: 4d41e4611a310d05c19ca5b5eef3381829dafdc7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
Prerequisites
=============

  - libodb           http://www.codesynthesis.com/products/odb/
  - Qt               http://qt.nokia.com


Building on UNIX
================

The following build instructions are for the Linux/UNIX/Mac OS X
operating systems as well as for Cygwin and MinGW on Windows.

The standard autotools-based build system is used on these platforms.
After unpacking the source code archive, change to the libodb-qt
package directory (referred to as libodb-qt/ from now on) and run
the configure script:

./configure

To see the available configuration options run configure with --help:

./configure --help

The configure script expects the libodb and qt headers and libraries
to be installed in a directory where the C++ compiler and linker will
search for them by default (normally /usr and /usr/local). If these
libraries are installed in other directories, you can use the CPPFLAGS
and LDFLAGS configure variables to specify their locations, for example:

./configure CPPFLAGS=-I/opt/libodb/include LDFLAGS=-L/opt/libodb/lib

If these libraries are not installed and you would like to use their
build directories instead, you can use the --with-libodb, and
--with-qt configure options to specify their locations, for example:

./configure --with-qt=/tmp/qt

For the qt build directory the configure script expects to find the
qt libraries in the lib/ subdirectory.

As another example, the following configure command only builds shared
libraries, uses the specified C++ compiler, and compiles with optimization
and without debug information:

./configure --disable-static CXX=g++-4.5 CXXFLAGS=-O3

Once configuration is complete, run make to build libodb-qt:

make

Once the build is completed successfully, you can install the libodb-qt
headers and libraries using the install target (you may need to do this
step as root depending on the installation directory):

make install


Building on Windows
===================

The following build instructions are for Windows using Microsoft Visual
Studio. If you would like to build libodb-qt with GCC either using
Cygwin or MinGW, refer to the "Building on UNIX" section above.

The standard Visual Studio project and solution files are used on this
platform. The provided project files expect the libodb and qt header
and import library directories to be in the VC++ Directories Include and
Library search lists. For libodb, see the INSTALL file in the package
directory for more information on how to setup the VC++ Directories. For
qt, refer to the qt documentation.

To build libodb-qt, unpack the source code archive and open the
libodb-qt-vc<N>.sln file located in the libodb-qt package
directory (referred to as libodb-qt\ from now on). Here <N> is the
version of Visual Studio that you are using. Once the solution is open,
select the desired build configuration (Debug or Release) and platform
(Win32 or x64) and build the solution.

The resulting 32-bit DLLs and import libraries are placed into the
libodb-qt\bin\ and libodb-qt\lib\ directories, respectively.
Similarly, the 64-bit DLLs and import libraries are placed into
libodb-qt\bin64\ and libodb-qt\lib64\. The Release versions of
the import libraries are named odb-qt.lib and the Debug versions
are named odb-qt-d.lib.

To configure Visual Studio to automatically locate the libodb-qt
headers, DLLs, and import libraries, add the following paths to your
VC++ Directories:

Win32:

  Include:    ...\libodb-qt
  Library:    ...\libodb-qt\lib
  Executable: ...\libodb-qt\bin

x64:

  Include:    ...\libodb-qt
  Library:    ...\libodb-qt\lib64
  Executable: ...\libodb-qt\bin64