2015-11-03 11:36:09 +01:00
|
|
|
WINDOWS BUILD NOTES
|
|
|
|
|
====================
|
|
|
|
|
|
2016-10-18 15:35:10 +02:00
|
|
|
Below are some notes on how to build Dash Core for Windows.
|
2015-11-03 11:36:09 +01:00
|
|
|
|
|
|
|
|
Most developers use cross-compilation from Ubuntu to build executables for
|
|
|
|
|
Windows. This is also used to build the release binaries.
|
|
|
|
|
|
2016-10-18 15:35:10 +02:00
|
|
|
While there are potentially a number of ways to build on Windows (for example using msys / mingw-w64),
|
2016-11-27 14:56:52 +01:00
|
|
|
using the Windows Subsystem For Linux is the most straightforward. If you are building with
|
|
|
|
|
another method, please contribute the instructions here for others who are running versions
|
2016-10-18 15:35:10 +02:00
|
|
|
of Windows that are not compatible with the Windows Subsystem for Linux.
|
|
|
|
|
|
2016-11-27 14:56:52 +01:00
|
|
|
Compiling with Windows Subsystem For Linux
|
|
|
|
|
-------------------------------------------
|
2016-10-18 15:35:10 +02:00
|
|
|
|
2016-11-27 14:56:52 +01:00
|
|
|
With Windows 10, Microsoft has released a new feature named the [Windows
|
|
|
|
|
Subsystem for Linux](https://msdn.microsoft.com/commandline/wsl/about). This
|
2017-01-01 12:58:41 +01:00
|
|
|
feature allows you to run a bash shell directly on Windows in an Ubuntu-based
|
2016-11-27 14:56:52 +01:00
|
|
|
environment. Within this environment you can cross compile for Windows without
|
2017-01-01 12:58:41 +01:00
|
|
|
the need for a separate Linux VM or server.
|
2016-10-18 15:35:10 +02:00
|
|
|
|
2017-01-01 12:58:41 +01:00
|
|
|
This feature is not supported in versions of Windows prior to Windows 10 or on
|
|
|
|
|
Windows Server SKUs. In addition, it is available [only for 64-bit versions of
|
|
|
|
|
Windows](https://msdn.microsoft.com/en-us/commandline/wsl/install_guide).
|
2016-10-18 15:35:10 +02:00
|
|
|
|
|
|
|
|
To get the bash shell, you must first activate the feature in Windows.
|
|
|
|
|
|
|
|
|
|
1. Turn on Developer Mode
|
|
|
|
|
* Open Settings -> Update and Security -> For developers
|
|
|
|
|
* Select the Developer Mode radio button
|
|
|
|
|
* Restart if necessary
|
|
|
|
|
2. Enable the Windows Subsystem for Linux feature
|
|
|
|
|
* From Start, search for "Turn Windows features on or off" (type 'turn')
|
|
|
|
|
* Select Windows Subsystem for Linux (beta)
|
|
|
|
|
* Click OK
|
|
|
|
|
* Restart if necessary
|
|
|
|
|
3. Complete Installation
|
|
|
|
|
* Open a cmd prompt and type "bash"
|
|
|
|
|
* Accept the license
|
|
|
|
|
* Create a new UNIX user account (this is a separate account from your Windows account)
|
|
|
|
|
|
2017-01-01 12:58:41 +01:00
|
|
|
After the bash shell is active, you can follow the instructions below, starting
|
|
|
|
|
with the "Cross-compilation" section. Compiling the 64-bit version is
|
|
|
|
|
recommended but it is possible to compile the 32-bit version.
|
2015-11-03 11:36:09 +01:00
|
|
|
|
|
|
|
|
Cross-compilation
|
|
|
|
|
-------------------
|
|
|
|
|
|
2018-09-28 09:55:46 +02:00
|
|
|
Follow the instructions for Windows in [build-cross](build-cross.md)
|
2016-11-27 14:56:52 +01:00
|
|
|
|
|
|
|
|
Installation
|
|
|
|
|
-------------
|
|
|
|
|
|
|
|
|
|
After building using the Windows subsystem it can be useful to copy the compiled
|
|
|
|
|
executables to a directory on the windows drive in the same directory structure
|
|
|
|
|
as they appear in the release `.zip` archive. This can be done in the following
|
2018-01-16 18:20:28 +01:00
|
|
|
way. This will install to `c:\workspace\dash`, for example:
|
2016-11-27 14:56:52 +01:00
|
|
|
|
2018-01-16 18:20:28 +01:00
|
|
|
make install DESTDIR=/mnt/c/workspace/dash
|
