Skip to content

Commit c737839

Browse files
author
MarcoFalke
committed
Merge #17309: doc: update MSVC instructions to remove Qt OpenSSL linking
162d003 doc: compiling with Visual Studio is now supported on Windows (fanquake) b1f1fb5 doc: update MSVC instructions to remove Qt configuration (fanquake) Pull request description: Follow up from #17165. Flips `-openssl-linked` to `-no-openssl`. Also adds some missing packages to the vcpkg install instructions. ACKs for top commit: sipsorcery: tACK 162d003. Tree-SHA512: 40577a3759a30170a14fd27e3eeac5a78a7852ae88daacecf584ad46c685708c167153d39357aa77a4f65bfd5a349f7589f20aa16fdf3d2895b4076b381e2c9c
2 parents 3f8d955 + 162d003 commit c737839

File tree

2 files changed

+13
-19
lines changed

2 files changed

+13
-19
lines changed

build_msvc/README.md

Lines changed: 8 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -12,7 +12,7 @@ Quick Start
1212
The minimal steps required to build Bitcoin Core with the msbuild toolchain are below. More detailed instructions are contained in the following sections.
1313

1414
```
15-
vcpkg install --triplet x64-windows-static boost-filesystem boost-signals2 boost-test libevent openssl zeromq berkeleydb rapidcheck double-conversion
15+
vcpkg install --triplet x64-windows-static boost-filesystem boost-multi-index boost-signals2 boost-test boost-thread libevent openssl zeromq berkeleydb rapidcheck double-conversion
1616
py -3 build_msvc\msvc-autogen.py
1717
msbuild /m build_msvc\bitcoin.sln /p:Platform=x64 /p:Configuration=Release /t:build
1818
```
@@ -40,33 +40,27 @@ The [external dependencies](https://github.com/bitcoin/bitcoin/blob/master/doc/d
4040

4141
Qt
4242
---------------------
43-
All the Bitcoin Core applications are configured to build with static linking. In order to build the Bitcoin Core Qt applications a static build of Qt is required.
43+
In order to build the Bitcoin Core a static build of Qt is required. The runtime library version (e.g. v141, v142) and platform type (x86 or x64) must also match.
4444

45-
The runtime library version (e.g. v141, v142) and platform type (x86 or x64) must also match. OpenSSL must also be linked into the Qt binaries in order to provide full functionality of the Bitcoin Core Qt programs. An example of the configure command to build Qtv5.9.7 locally to link with Bitcoin Core is shown below (adjust paths accordingly), note it can be expected that the configure and subsequent build will fail numerous times until dependency issues are resolved.
45+
A prebuilt version of Qt can be downloaded from [here](https://github.com/sipsorcery/qt_win_binary/releases). Please be aware this download is NOT an officially sanctioned Bitcoin Core distribution and is provided for developer convenience. It should NOT be used for builds that will be used in a production environment or with real funds.
4646

47-
````
48-
..\Qtv5.9.7_src\configure -developer-build -confirm-license -debug-and-release -opensource -platform win32-msvc -opengl desktop -no-shared -static -no-static-runtime -mp -qt-zlib -qt-pcre -qt-libpng -ltcg -make libs -make tools -no-libjpeg -nomake examples -no-compile-examples -no-dbus -no-libudev -no-qml-debug -no-icu -no-gtk -no-opengles3 -no-angle -no-sql-sqlite -no-sql-odbc -no-sqlite -no-libudev -skip qt3d -skip qtactiveqt -skip qtandroidextras -skip qtcanvas3d -skip qtcharts -skip qtconnectivity -skip qtdatavis3d -skip qtdeclarative -skip qtdoc -skip qtgamepad -skip qtgraphicaleffects -skip qtimageformats -skip qtlocation -skip qtmacextras -skip qtmultimedia -skip qtnetworkauth -skip qtpurchasing -skip qtquickcontrols -skip qtquickcontrols2 -skip qtscript -skip qtscxml -skip qtsensors -skip qtserialbus -skip qtserialport -skip qtspeech -skip qtvirtualkeyboard -skip qtwayland -skip qtwebchannel -skip qtwebengine -skip qtwebsockets -skip qtwebview -skip qtx11extras -skip qtxmlpatterns -nomake tests -openssl-linked -IC:\Dev\github\vcpkg\installed\x64-windows-static\include -LC:\Dev\github\vcpkg\installed\x64-windows-static\lib OPENSSL_LIBS="-llibeay32 -lssleay32 -lgdi32 -luser32 -lwsock32 -ladvapi32" -prefix C:\Qt5.9.7_ssl_x64_static_vs2017
49-
````
50-
51-
A prebuilt version for x64 and Visual C++ runtime v141 (Visual Studio 2017) can be downloaded from [here](https://github.com/sipsorcery/qt_win_binary/releases). Please be aware this download is NOT an officially sanctioned Bitcoin Core distribution and is provided for developer convenience. It should NOT be used for builds that will be used in a production environment or with real funds.
52-
53-
To build Bitcoin Core without Qt unload or disable the bitcoin-qt, libbitcoin_qt and test_bitcoin-qt projects.
47+
To build Bitcoin Core without Qt unload or disable the `bitcoin-qt`, `libbitcoin_qt` and `test_bitcoin-qt` projects.
5448

5549
Building
5650
---------------------
5751
The instructions below use `vcpkg` to install the dependencies.
5852

59-
- Clone `vcpkg` from the [github repository](https://github.com/Microsoft/vcpkg) and install as per the instructions in the main README.md.
53+
- Install [`vcpkg`](https://github.com/Microsoft/vcpkg).
6054
- Install the required packages (replace x64 with x86 as required):
6155

6256
```
63-
PS >.\vcpkg install --triplet x64-windows-static boost-filesystem boost-signals2 boost-test libevent openssl zeromq berkeleydb rapidcheck double-conversion
57+
PS >.\vcpkg install --triplet x64-windows-static boost-filesystem boost-multi-index boost-signals2 boost-test boost-thread libevent openssl zeromq berkeleydb rapidcheck double-conversion
6458
```
6559

66-
- Use Python to generate *.vcxproj from Makefile
60+
- Use Python to generate `*.vcxproj` from Makefile
6761

6862
```
69-
PS >py -3 msvc-autogen.py
63+
PS >py -3 msvc-autogen.py
7064
```
7165

7266
- An optional step is to adjust the settings in the build_msvc directory and the common.init.vcxproj file. This project file contains settings that are common to all projects such as the runtime library version and target Windows SDK version. The Qt directories can also be set.

doc/build-windows.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -8,18 +8,18 @@ The options known to work for building Bitcoin Core on Windows are:
88
* On Linux, using the [Mingw-w64](https://mingw-w64.org/doku.php) cross compiler tool chain. Ubuntu Bionic 18.04 is required
99
and is the platform used to build the Bitcoin Core Windows release binaries.
1010
* On Windows, using [Windows
11-
Subsystem for Linux (WSL)](https://msdn.microsoft.com/commandline/wsl/about) and the Mingw-w64 cross compiler tool chain.
11+
Subsystem for Linux (WSL)](https://docs.microsoft.com/windows/wsl/about) and the Mingw-w64 cross compiler tool chain.
12+
* On Windows, using a native compiler tool chain such as [Visual Studio](https://www.visualstudio.com).
1213

1314
Other options which may work, but which have not been extensively tested are (please contribute instructions):
1415

15-
* On Windows, using a POSIX compatibility layer application such as [cygwin](http://www.cygwin.com/) or [msys2](http://www.msys2.org/).
16-
* On Windows, using a native compiler tool chain such as [Visual Studio](https://www.visualstudio.com).
16+
* On Windows, using a POSIX compatibility layer application such as [cygwin](https://www.cygwin.com/) or [msys2](https://www.msys2.org/).
1717

1818
Installing Windows Subsystem for Linux
1919
---------------------------------------
2020

2121
With Windows 10, Microsoft has released a new feature named the [Windows
22-
Subsystem for Linux (WSL)](https://msdn.microsoft.com/commandline/wsl/about). This
22+
Subsystem for Linux (WSL)](https://docs.microsoft.com/windows/wsl/about). This
2323
feature allows you to run a bash shell directly on Windows in an Ubuntu-based
2424
environment. Within this environment you can cross compile for Windows without
2525
the need for a separate Linux VM or server. Note that while WSL can be installed with
@@ -28,7 +28,7 @@ tested with Ubuntu.
2828

2929
This feature is not supported in versions of Windows prior to Windows 10 or on
3030
Windows Server SKUs. In addition, it is available [only for 64-bit versions of
31-
Windows](https://msdn.microsoft.com/en-us/commandline/wsl/install_guide).
31+
Windows](https://docs.microsoft.com/windows/wsl/install-win10).
3232

3333
Full instructions to install WSL are available on the above link.
3434
To install WSL on Windows 10 with Fall Creators Update installed (version >= 16215.0) do the following:

0 commit comments

Comments
 (0)