Initial commit
This commit is contained in:
+116
@@ -0,0 +1,116 @@
|
||||
Prerequisites
|
||||
=============
|
||||
|
||||
- libodb http://www.codesynthesis.com/products/odb/
|
||||
- libsqlite3 http://www.sqlite.org
|
||||
|
||||
If you plan to access an SQLite database from multiple threads, then
|
||||
you will need SQLite version 3.5.0 or later built with the unlock
|
||||
notify feature (SQLITE_ENABLE_UNLOCK_NOTIFY) enabled.
|
||||
|
||||
|
||||
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-sqlite
|
||||
package directory (referred to as libodb-sqlite/ 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 libsqlite3 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 libodb is not installed and you would like to use its build
|
||||
directory instead, you can use the --with-libodb configure option
|
||||
to specify its location, for example:
|
||||
|
||||
./configure --with-libodb=/tmp/libodb
|
||||
|
||||
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-sqlite:
|
||||
|
||||
make
|
||||
|
||||
Once the build is completed successfully, you can install the libodb-sqlite
|
||||
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-sqlite 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 sqlite
|
||||
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.
|
||||
|
||||
The SQLite binary distribution for Windows contains only a 32-bit DLL
|
||||
and it is built without unlock notify support. The provided libodb-
|
||||
sqlite project files assume the unlock notify feature is available (you
|
||||
can change this by manually removing the LIBODB_SQLITE_HAVE_UNLOCK_NOTIFY
|
||||
macro from the project's "Preprocessor Definitions" settings). The SQLite
|
||||
source distribution for Windows lacks Visual Studio project/solution files.
|
||||
|
||||
To rectify this situation, the libodb-sqlite distribution includes, in the
|
||||
etc\sqlite\ directory, Visual Studio 8, 9, 10, and 11 project/solution files
|
||||
for building 32 and 64-bit SQLite libraries with unlock notify support.
|
||||
Refer to the accompanying README file for information on how to build the
|
||||
libraries and configure VC++ Directories to automatically locate them.
|
||||
|
||||
To build libodb-sqlite, unpack the source code archive and open the
|
||||
libodb-sqlite-vc<N>.sln file located in the libodb-sqlite package
|
||||
directory (referred to as libodb-sqlite\ 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-sqlite\bin\ and libodb-sqlite\lib\ directories, respectively.
|
||||
Similarly, the 64-bit DLLs and import libraries are placed into
|
||||
libodb-sqlite\bin64\ and libodb-sqlite\lib64\. The Release versions of
|
||||
the import libraries are named odb-sqlite.lib and the Debug versions
|
||||
are named odb-sqlite-d.lib.
|
||||
|
||||
To configure Visual Studio to automatically locate the libodb-sqlite
|
||||
headers, DLLs, and import libraries, add the following paths to your
|
||||
VC++ Directories:
|
||||
|
||||
Win32:
|
||||
|
||||
Include: ...\libodb-sqlite
|
||||
Library: ...\libodb-sqlite\lib
|
||||
Executable: ...\libodb-sqlite\bin
|
||||
|
||||
x64:
|
||||
|
||||
Include: ...\libodb-sqlite
|
||||
Library: ...\libodb-sqlite\lib64
|
||||
Executable: ...\libodb-sqlite\bin64
|
||||
Reference in New Issue
Block a user