From 8acc60a50435dae9a05c9785cc545740b917a4b1 Mon Sep 17 00:00:00 2001
From: Timm Fitschen <t.fitschen@indiscale.com>
Date: Mon, 2 Aug 2021 09:29:24 +0200
Subject: [PATCH] DOC: update README_SETUP
---
README_SETUP.md | 21 ++++++++++++++++++++-
1 file changed, 20 insertions(+), 1 deletion(-)
diff --git a/README_SETUP.md b/README_SETUP.md
index 68b1062..aaf0e16 100644
--- a/README_SETUP.md
+++ b/README_SETUP.md
@@ -8,7 +8,8 @@
We use [cmake](https://cmake.org) as build tool.
-1. `mkdir build && cd build/`
+0. clone/update the subrepo `git submodule update --init proto`
+1. `mkdir build && cd build`
2. `conan install .. -s "compiler.libcxx=libstdc++11"`
3. `cmake -B . ..`
4. `cmake --build .`
@@ -38,6 +39,7 @@ variable.
We use [Visual Studio 2019](https://visualstudio.microsoft.com/de/vs/features/cplusplus/)
as compiler. We use [cmake](https://cmake.org/download/) as build tool.
+0. clone/update the subrepo `git submodule update --init proto`
1. `mkdir build`
2. `cd build`
3. `conan install .. -g visual_studio -s arch=x86_64 -s build_type=Release -s compiler.toolset=v142 -s compiler.version=16 -s compiler.runtime=MD --build=missing --update`
@@ -46,6 +48,23 @@ as compiler. We use [cmake](https://cmake.org/download/) as build tool.
and build the project. (You can open Tools/Command Line/Developer Command
Prompt and execute `msbuild libcaosdb.sln /property:Configuration=Release`)
+### Creating a Local Conan Build ##
+
+Building and installing libcaosdb with Conan is just a single command:
+`conan create . -s "compiler.libcxx=libstdc++11"`
+
+For MacOS, you probably should adjust the option as mentioned above.
+
+### Troubleshooting
+
+#### `conan install` Fails Due to Missing Prebuilts
+
+When `conan install` fails during the installation of the dependencies because
+a precompiled package is not available for your specific settings, try adding
+the `--build=missing` option: `conan install .. [ other options
+] --build=missing`. This should download and compile the sources of the
+dependencies.
+
## Unit Tests
### Build
--
GitLab