View source for Building under Windows

== Automation ==

[https://github.com/CyberShadow/Digger Digger] can checkout and build any D version automatically for you. Only a D compiler is required. Digger will download all required dependencies by itself.

<syntaxhighlight lang=bash>
dub fetch digger
dub run digger
</syntaxhighlight>

Among many other features, Digger can build older compiler versions or versions with a specific pull request added:

<syntaxhighlight lang=bash>
# build a specific D version
$ dub run digger -- build v2.064.2

# build for x86-64
$ dub run digger -- build --model=64 v2.064.2

# build commit from a point in time
$ dub run digger -- build "@ 3 weeks ago"

# build specified branch from a point in time
$ dub run digger -- build "2.065 @ 3 weeks ago"

# build with an added pull request
$ dub run digger -- build "master + dmd#123"
</syntaxhighlight>

== Prerequisites ==

On Windows, you will need [https://git-scm.com/ Git for Windows], [http://dlang.org/download.html#dmd D compiler], [http://ftp.digitalmars.com/dmc.zip the DigitalMars C++ compiler], and, for 64-bit or 32-bit COFF builds, the [https://www.microsoft.com/en-us/download/details.aspx?id=8279 Microsoft Windows SDK].

Assuming that {{code|make}}, {{code|dmc}} and {{code|dmd}} from digital mars are in your path and your sources are checked out into {{code|C:\D\dmd2\src}} which has the following structure:
<syntaxhighlight lang=dos>
C:\D\dmd2\src\dmd
C:\D\dmd2\src\druntime
C:\D\dmd2\src\phobos
C:\D\dmd2\src\tools
</syntaxhighlight>

=== git Configuration ===

When cloning from the GitHub repositories you may encounter problems if your git configuration on Windows replaces line endings with the Windows variant (i.e. {{code|\r\n}}) instead of leaving it as {{code|\n}}, which is what D repositories require.

To check your settings, run {{code|git config core.autocrlf}}.  If it prints {{code|true}}, set it to {{code|false}} with {{code|git config config --global core.autocrlf false}}.

== Building D ==

The following instructions work for win32. May or may not work with win64. This scheme is a suggestion. These instructions should work when building from a clean repository, however, this repository contains autogenerated code that may be left behind after switching branches so running a git clean after switching branches is a good idea:

<syntaxhighlight lang=dos>
git clean -xfd
</syntaxhighlight>

=== Building DMD ===

To build DMD compiler you should run the following commands ({{code|win32.mak}} file expects that {{code|HOST_DC}} variable is set to {{code|dmd}}):
<syntaxhighlight lang=dos>
set DM_HOME=C:\D
cd %DM_HOME%\dmd2\src\dmd\src
set HOST_DC=dmd
make -fwin32.mak release
</syntaxhighlight>

From there, it is suggested to move the built binaries into your {{code|%DM_HOME%\windows\bin}} directory, and add that to your path:
<syntaxhighlight lang=dos>
mkdir %DM_HOME%\dmd2\windows\bin
copy *.exe %DM_HOME%\dmd2\windows\bin
set path=%DM_HOME%\dmd2\windows\bin;%path%
</syntaxhighlight>

From there, you have to create a {{code|sc.ini}} in your {{code|%DM_HOME%\dmd2\windows\bin}} directory (where {{code|dmd.exe}} is). It is suggested to just copy paste the one provided in the packaged {{Latest DMD Version Raw}}, instead of writing your own, like:
<syntaxhighlight lang=dos>
copy "C:\Program Files\D\dmd2\windows\bin\sc.ini" %DM_HOME%\dmd2\windows\bin
</syntaxhighlight>

=== Building D runtime ===

Make sure that you are using {{code|dmd}} compiled in previous step because older compiler might not compile the latest druntime code.

To build D runtime you should run the following commands:
<syntaxhighlight lang=dos>
cd %DM_HOME%\dmd2\src\druntime
make -fwin32.mak
</syntaxhighlight>

=== Building Phobos ===

Make sure that you are using {{code|dmd}} compiled in previous step because older compiler might not compile the latest phobos code.

To build Phobos you should run the following commands:
<syntaxhighlight lang=dos>
cd %DM_HOME%\dmd2\src\phobos
make -fwin32.mak
</syntaxhighlight>

You should copy phobos lib into your {{code|%DM_HOME%\windows\lib}} folder:
<syntaxhighlight lang=dos>
mkdir %DM_HOME%\dmd2\windows\lib
copy phobos.lib %DM_HOME%\dmd2\windows\lib
</syntaxhighlight>

=== Building rdmd ===

Optionally, you can build rdmd from source if you have checked out {{code|tools}} in your sources. Some additional libs might be required for build and can simply be copy pasted from the {{Latest DMD Version Raw}} package without overwriting your {{code|phobos.lib}}.

To build rdmd you should run the following commands:
<syntaxhighlight lang=dos>
cd %DM_HOME%\dmd2\src\tools
make -fwin32.mak rdmd
</syntaxhighlight>

You should copy rdmd into your {{code|%DM_HOME%\windows\bin}} folder:
<syntaxhighlight lang=dos>
mkdir %DM_HOME%\dmd2\windows\lib
copy generated\windows\32\*.exe %DM_HOME%\dmd2\windows\bin
</syntaxhighlight>

=== Thirdparty libraries ===

The last step is getting the additional libs. curl for D2 can be found at the bottom of the download section of dlang.org: [[http://dlang.org/download.html download]].

Additional libs that are necessary can simply be copy pasted from the {{Latest DMD Version Raw}} package (without overwriting your {{code|phobos.lib}}).

=== Verifying ===

The very last step is to verify that everything works by unittesting phobos:
<syntaxhighlight lang=dos>
cd %DM_HOME%\dmd2\src\phobos
make -fwin32.mak unittest
</syntaxhighlight>

== Common Windows issues ==

=== Missing MASM386===

If when building druntime you get errors about missing MASM386, it's due to a required assembling of a file called '''minit.asm'''. However the druntime repository includes a prebuilt minit.obj file so you shouldn't need to assemble it again. As a workaround for the make error create an empty '''masm386.bat''' file and put it in a directory that's in your '''PATH'''.

It's also recommended that you use the cmd.exe terminal. Others, like PowerShell, are known to experience issues with legacy tools.

=== Intermediate files lead to several errors ===

The three main components (dmd, druntime, phobos) should always be built together with matching versions. The intermediate files generated by a previous build can lead to a failure so it's advisable to run

<syntaxhighlight lang=dos>
make -fwin32.mak clean
</syntaxhighlight>

on each component before starting the process.

=== Using DigitalMars <code>make</code> for running the test suite ===

DMD's testsuite can't be run with DigitalMars <code>make</code> - use GNUMake.
Refer to the instructions in [[DMD_development#Running_the_testsuite_on_Windows | Running the test suite on Windows]].

== Where to go from here ==

If you want to contribute to a D project, please continue with the [[Starting_as_a_Contributor| starting as a contributor]] guide.
If you want to contribute to Phobos, you may also read the [[Contributing to Phobos|contributing to Phobos guide]].

[[Category:Windows]]