You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@iotdb.apache.org by hx...@apache.org on 2021/02/06 03:04:01 UTC
[iotdb] branch master updated: [C++ Client]Add more detailed
walkthrough of Cpp client build to README (#2620)
This is an automated email from the ASF dual-hosted git repository.
hxd pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/iotdb.git
The following commit(s) were added to refs/heads/master by this push:
new 08eaac9 [C++ Client]Add more detailed walkthrough of Cpp client build to README (#2620)
08eaac9 is described below
commit 08eaac9c9d6ea9528fc08c83276ff4e6492da813
Author: wshao08 <59...@users.noreply.github.com>
AuthorDate: Sat Feb 6 11:03:39 2021 +0800
[C++ Client]Add more detailed walkthrough of Cpp client build to README (#2620)
---
compile-tools/README.md | 27 +++++++++++++++++++++++----
1 file changed, 23 insertions(+), 4 deletions(-)
diff --git a/compile-tools/README.md b/compile-tools/README.md
index fb19922..0a92fa8 100644
--- a/compile-tools/README.md
+++ b/compile-tools/README.md
@@ -29,7 +29,6 @@
* Boost
* OpenSSL 1.0+
-Make sure a complete C++ building environment is prepared on your machine.
### Mac
@@ -99,15 +98,27 @@ yum install gcc g++ bison flex boost-devel
### Windows
+Make sure a complete Windows C++ building environment is prepared on your machine.
+MSVC, MinGW... are supported.
+
+If you are using MS Visual Studio, remember to install Visual Studio C/C++ IDE and compiler(supporting CMake, Clang, MinGW).
+
#### Flex and Bison
-For Flex and Bison, they could be downloaded from SourceForge: https://sourceforge.net/projects/winflexbison/
+Windows Flex and Bison could be downloaded from SourceForge: https://sourceforge.net/projects/winflexbison/
After downloaded, please rename the executables to flex.exe and bison.exe and add them to "PATH" environment variables.
#### Boost
For Boost, please download from the official website: https://www.boost.org/users/download/
+Then build Boost by executing bootstrap.bat and b2.exe.
+```
+bootstrap.bat
+.\b2.exe
+```
+To help CMake find your Boost libraries on windows, you should set `-Dboost.include.dir=${your boost header folder} -Dboost.library.dir=${your boost lib (stage) folder}`
+to your mvn build command.
#### Cmake generator on Windows
@@ -151,8 +162,6 @@ There is a long list of supported Cmake generators on Windows environment.
When building client-cpp project, use -Dcmake.generator="" option to specify a Cmake generator.
E.g., `mvn package -Dcmake.generator="Visual Studio 15 2017 [arch]"`
-on windows, you should set `-Dboost.include.dir=${your boost header folder} -Dboost.library.dir=${your boost lib (stage) folder}`
-
### FAQ
@@ -162,3 +171,13 @@ if you occur some errors when compiling thrift source code, try to downgrade you
see https://stackoverflow.com/questions/63592445/ld-unsupported-tapi-file-type-tapi-tbd-in-yaml-file/65518087#65518087
+#### on Windows
+
+When Building Thrift and downloading packages via "wget", a possible annoying issue may occur with
+error message looks like:
+```
+Failed to delete cached file C:\Users\Administrator\.m2\repository\.cache\download-maven-plugin\index.ser
+```
+Possible fix:
+- Try to delete the ".m2\repository\\.cache\" directory and try again.
+- Add "\<skipCache>true\</skipCache>" configuration to the download-maven-plugin maven phase that complains this error.