Repository: thrift Updated Branches: refs/heads/master e84c58253 -> b26c0b8dc
THRIFT-3167 Windows build from source instructions need to be revised Client: Website Patch: Jens Geyer This closes #504 - revised "Windows build from source" instructions - sync'ed doc/install/README.md with website Project: http://git-wip-us.apache.org/repos/asf/thrift/repo Commit: http://git-wip-us.apache.org/repos/asf/thrift/commit/b26c0b8d Tree: http://git-wip-us.apache.org/repos/asf/thrift/tree/b26c0b8d Diff: http://git-wip-us.apache.org/repos/asf/thrift/diff/b26c0b8d Branch: refs/heads/master Commit: b26c0b8dcc9a990805574da47ceac56ec5da8345 Parents: e84c582 Author: Jens Geyer <[email protected]> Authored: Tue May 19 23:53:36 2015 +0200 Committer: Jens Geyer <[email protected]> Committed: Wed May 20 00:46:46 2015 +0200 ---------------------------------------------------------------------- doc/install/README.md | 9 +++++- doc/install/windows.md | 70 ++++++++++++++++++++++++++++++++++++++------- 2 files changed, 68 insertions(+), 11 deletions(-) ---------------------------------------------------------------------- http://git-wip-us.apache.org/repos/asf/thrift/blob/b26c0b8d/doc/install/README.md ---------------------------------------------------------------------- diff --git a/doc/install/README.md b/doc/install/README.md index 42c328c..e37f4ff 100644 --- a/doc/install/README.md +++ b/doc/install/README.md @@ -1,7 +1,7 @@ ## Basic requirements * A relatively POSIX-compliant *NIX system - * Cygwin or MinGW can be used on Windows + * Cygwin or MinGW can be used on Windows (but there are better options, see below) * g++ 4.2 * boost 1.53.0 * Runtime libraries for lex and yacc might be needed for the compiler. @@ -15,6 +15,10 @@ * lex and yacc (developed primarily with flex and bison) * libssl-dev +## Requirements for building the compiler from source on Windows +* Visual Studio C++ +* Flex and Bison (e.g. the WinFlexBison package) + ## Language requirements These are only required if you choose to build the libraries for the given language @@ -34,3 +38,6 @@ These are only required if you choose to build the libraries for the given langu * Perl 5 * Bit::Vector * Class::Accessor +* Haxe 3.1.3 +* Go 1.4 +* Delphi 2010 http://git-wip-us.apache.org/repos/asf/thrift/blob/b26c0b8d/doc/install/windows.md ---------------------------------------------------------------------- diff --git a/doc/install/windows.md b/doc/install/windows.md index 304adcc..7b09840 100644 --- a/doc/install/windows.md +++ b/doc/install/windows.md @@ -1,17 +1,51 @@ ## Windows Setup -The windows compiler is available as a prebuilt exe available [here](/download) -## Windows setup from source +The Thrift environment consists of two main parts: The Thrift compiler EXE and the language-dependent libraries. Most of these libraries will require some kind of build and/or installation. But regarding the Thrift compiler utility there are a number of different alternatives. -### Basic requirements for win32 -Thrift's compiler is written in C++ and designed to be portable, but there are some system requirements: +The first one of these alternatives is to download the **pre-built Thrift Compiler EXE** and only build the libraries needed from source, following one of the "Setup from source" methods outlined below. - * Cygwin or MinGW +The other two options are to build the Thrift compiler from source. The most recommended way to achieve this is by means of the **Visual Studio C++ build project**. Alternatively, the Thrift compiler can also be built via **Cygwin** or **MinGW** build environments, however this method is not only less comfortable, but more time-consuming and requires much more manual effort. + + +## Prebuilt Thrift compiler + +The windows Thrift compiler is available as a prebuilt exe available [here](/download). Note that there is no installation tool, rather this EXE file *is* already the Thrift compiler utility. Download the file and put it into some suitable location of your choice. + +Now pick one of the "Build and install target libraries" below to continue. + + +## Setup from source via Visual Studio C++ (recommended) + +### Requirements + +Thrift's compiler is written in C++ and designed to be portable, but there are some system requirements. Thrift's runtime libraries are written in various languages, which are also required for the particular language interface. + + * Visual Studio C++, any recent version should do + * Flex and Bison, e.g. the WinFlexBison package * [Apache Thrift Requirements](/docs/install) -Thrift's runtime libraries are written in various languages, which are also required for the particular language interface. +### Build and install the compiler + +After all requirements are in place, use the `compiler/cpp/compiler.vcxproj` build project to build the Thrift compiler. Copy the resulting EXE file to a location of your choice. + +### Build and install target libraries + +A few of the target language libraries also do provide Visual Studio project files, such as C++ and C#. These are located in the `lib/<language>/` folders. + +Most of the language packages must be built and installed manually using build tools better suited to those languages. Typical examples are Java, Ruby, Delphi, or PHP. Look for the `README.md` file in the `lib/<language>/` folder for more details on how to build and install each language's library package. + + +## Setup from source via Cygwin + +### Requirements + +Thrift's compiler is written in C++ and designed to be portable, but there are some system requirements. Thrift's runtime libraries are written in various languages, which are also required for the particular language interface. + + * Cygwin or MinGW + * [Apache Thrift Requirements](/docs/install) ### Installing from source + If you are building from the first time out of the source repository, you will need to generate the configure scripts. (This is not necessary if you downloaded a tarball.) From the top directory, do: ./bootstrap.sh @@ -32,14 +66,16 @@ Now make the thrift compiler (& runtime libraries if make is run from the thrift make make install -Some language packages must be installed manually using build tools better suited to those languages (at the time of this writing, this applies to Java, Ruby, PHP). +### Build and install target libraries -Look for the README file in the `lib/<language>/` folder for more details on the installation of each language library package. +Some language packages must be installed manually using build tools better suited to those languages. Typical examples are Java, Ruby, or PHP. Look for the README file in the `lib/<language>/` folder for more details on the installation of each language library package. ### Possible issues with Cygwin install + See also Possible issues with MinGW install. #### Syntax error in ./configure + The following error occurs for some users when running ./configure: ./configure: line 21183: syntax error near unexpected token `MONO,' @@ -52,6 +88,7 @@ To resolve this, you'll need to find your pkg.m4 (installed by the pkg-config pa Finally, re-run ./bootstrap.sh and ./configure. (Note that pkg.m4 is created by the pkg-config tool. If your /usr/share/aclocal directory doesn't contain the pkg.m4 file, you may not have pkg-config installed.) #### Installing perl runtime libraries + Sometimes, there will be an error during the install of the perl libraries with chmod. A workaround is to avoid installing the perl libraries if they are not needed. @@ -63,6 +100,7 @@ If you need perl, and are happy to manually install it, replace the contents of TODO #### Linking to installed C++ runtime libraries + Sometimes, the installed libthrift.a will not link using g++, with linker errors about missing vtables and exceptions for Thrift classes. A workaround is to link the compiled object files directly from your Thrift build, corresponding to the missing classes. @@ -84,8 +122,16 @@ The issue and patch are described on the Cygwin mailing list at http://cygwin.co This issue should be fixed in Cygwin versions after 1.7.5-1, or g++ 4.5.0. -## Installation from Source (No Cygwin dependency) -To compile the Thrift generator & runtime libraries (untested) without the cygwin.dll dependency you need to install MinGW (www.mingw.org). In addition you need to add the following entry to your windows PATH variable. +## Setup from source via MinGW + +### Requirements + +To compile the Thrift generator & runtime libraries (untested) without the cygwin.dll dependency you need to install MinGW (www.mingw.org). + + * MinGW + * [Apache Thrift Requirements](/docs/install) + +In addition you need to add the following entry to your windows PATH variable. C:\MINGW\BIN @@ -115,17 +161,21 @@ Run make: mingw32-make.exe ### Possible issues with MinGW install + See also Possible issues with Cygwin install, including the discussion about PTHREAD_MUTEX_RECURSIVE_NP. #### yywrap is not found + Make sure you add -lfl in your cxxflags in Makefile, also try adding -Lc:/cygwin/libs #### boost is not found + Try and change the include dir to use the windows path from c like this: Edit compiler/cpp/Makefile, look for the declaration of BOOST_CPPFLAGS, change that line for BOOST_CPPFLAGS = -Ic:/cygwin/usr/include/boost-1_53_0 #### realpath is not found + add -DMINGW -mno-cygwin to the CXXDEFS variable in Makefile ## Additional reading
