Skip to content
Snippets Groups Projects
Commit 450e14e9 authored by Joscha Schmiedt's avatar Joscha Schmiedt
Browse files

Add make vcpkg-build-release to build instructions

parent 2ca8de6f
No related branches found
No related tags found
2 merge requests!61Release 0.3.0,!53Add vcpkg support
This commit is part of merge request !53. Comments created here will be created in the context of that merge request.
...@@ -9,8 +9,8 @@ Dependencies ...@@ -9,8 +9,8 @@ Dependencies
Build Build
----- -----
Building with ``make`` Building with ``make`` and Conan
~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Make sure that the dependencies (see above) are fulfilled. On systems Make sure that the dependencies (see above) are fulfilled. On systems
which have ``make`` installed, type this in your command line terminal: which have ``make`` installed, type this in your command line terminal:
...@@ -19,6 +19,38 @@ which have ``make`` installed, type this in your command line terminal: ...@@ -19,6 +19,38 @@ which have ``make`` installed, type this in your command line terminal:
make conan make conan
Manual build with Conan
~~~~~~~~~~~~~~~~~~~~~~~
We use `cmake <https://cmake.org>`__ as build tool, with Conan as
package manager. The compiler must support the C++17 standard.
1. clone/update the subrepo ``git submodule update --init proto``
2. ``conan install . -s build_type=Release --build=missing``
3. ``cd build/Release``
4. ``cmake -S ../.. -G "Unix Makefiles" -DCMAKE_TOOLCHAIN_FILE=generators/conan_toolchain.cmake -DCMAKE_POLICY_DEFAULT_CMP0091=NEW -DCMAKE_BUILD_TYPE=Release``
5. ``cmake --build .``
You may also want to install libcaosdb system-wide to
``CMAKE_INSTALL_PREFIX/lib`` by
1. ``cmake --install .``
The default install prefix is ``~/.local``. It can be set by adding
``-DCMAKE_INSTALL_PREFIX=/path/to/install/prefix`` to the first cmake
command (4.).
.. Note::
The C++ CaosDB library links against other libraries which are installed by Conan. So if you want
to switch to newer versions of those libraries (possible reasons may be security releases or bug
fixes), it is not sufficient to update your system libraries, but you have to update your Conan
content and then rebuild libcaosdb.
If you want to build or install libcaosdb without the use of Conan, feel
free to rewrite the CMakeLists.txt as needed. The CaosDB project is open
to merge requests which support multiple ways of installation.
Building with ``vcpkg`` Building with ``vcpkg``
~~~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~~~
...@@ -46,38 +78,13 @@ Then compile the project with CMake by including the vcpkg toolchain file: ...@@ -46,38 +78,13 @@ Then compile the project with CMake by including the vcpkg toolchain file:
cmake -S .. -B . -DCMAKE_TOOLCHAIN_FILE=../vcpkg/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux -DCMAKE_BUILD_TYPE=Release cmake -S .. -B . -DCMAKE_TOOLCHAIN_FILE=../vcpkg/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux -DCMAKE_BUILD_TYPE=Release
cmake --build . cmake --build .
Alternatively, on Linux, you can use the provided `Makefile` targets
Manual build .. code:: console
~~~~~~~~~~~~
We use `cmake <https://cmake.org>`__ as build tool, with Conan as
package manager. The compiler must support the C++17 standard.
1. clone/update the subrepo ``git submodule update --init proto``
2. ``conan install . -s build_type=Release --build=missing``
3. ``cd build/Release``
4. ``cmake -S ../.. -G "Unix Makefiles" -DCMAKE_TOOLCHAIN_FILE=generators/conan_toolchain.cmake -DCMAKE_POLICY_DEFAULT_CMP0091=NEW -DCMAKE_BUILD_TYPE=Release``
5. ``cmake --build .``
You may also want to install libcaosdb system-wide to
``CMAKE_INSTALL_PREFIX/lib`` by
1. ``cmake --install .``
The default install prefix is ``~/.local``. It can be set by adding
``-DCMAKE_INSTALL_PREFIX=/path/to/install/prefix`` to the first cmake
command (4.).
.. Note:: make vcpkg-build-release
The C++ CaosDB library links against other libraries which are installed by Conan. So if you want
to switch to newer versions of those libraries (possible reasons may be security releases or bug
fixes), it is not sufficient to update your system libraries, but you have to update your Conan
content and then rebuild libcaosdb.
If you want to build or install libcaosdb without the use of Conan, feel
free to rewrite the CMakeLists.txt as needed. The CaosDB project is open
to merge requests which support multiple ways of installation.
How to build on MacOS How to build on MacOS
~~~~~~~~~~~~~~~~~~~~~ ~~~~~~~~~~~~~~~~~~~~~
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment