Windows 8

  • Revision slug: Windows_8
  • Revision title: Windows 8
  • Revision id: 333261
  • Created:
  • Creator: sransara
  • Is current revision? No
  • Comment

Revision Content

Windows 8 will eventually support compiling mozilla-central and related repositories and products. This page documents the steps to get a working Windows 8 development environment.

Installing Windows 8

The Windows 8 Consumer Preview setup can be obtained from http://windows.microsoft.com/en-US/windows-8/download and http://windows.microsoft.com/en-US/windows-8/iso if you prefer the ISO images.

If you want to run Windows 8 on Virtualbox, see http://www.groovypost.com/howto/install-windows-8-vm-virtualbox/.

Installing Windows 8 is pretty straightforward for an OS install. These instructions assume you know how to do that.

As for hardware resources of the VM or Virtualbox, you should be able to fit in the base OS, all the dependencies, source and build in a 30GB partition. For memory, 2GB should be considered the minimum. As always, give it as much as you can.

Install Developer Tools

As with the existing Windows 7 development steps, you'll need to install a number of prerequisites.

(required) Visual Studio 2012

Visual Studio 2012 can be downloaded from https://www.microsoft.com/visualstudio/11/en-us/downloads. The download there is just a simple installer which will download and install the real components. When you install VS2012, have something else to do because it takes a long time.

For now, installation of the full Visual Studio is required. Eventually, compiling on Visual Studio Express should be possible. Bug 701050 has more.

(required) mozilla-build Bundle

The latest mozilla-build is required.

(optional) DirectX SDK

Download and install the DirectX SDK from http://www.microsoft.com/download/en/details.aspx?displaylang=en&id=6812.

If you don't install the DirectX SDK, add the following to your .mozconfig:

ac_add_options --disable-webgl

(optional) Windows SDK

The Windows SDK is a little tricky for Windows 8. Currently, the Windows 8 SDK is only available to MSDN subscribers. If you have access, you can grab it from MSDN under the filename en_windows_developer_preview_wdk_x86_x64_741966.zip. You will likely find it under the Windows Developer Preview section listed as Windows Developer Preview WDK (x86 and x64).

Theoretically, you can install the Windows 7 (or 7.1) SDK as a substitute. But, the Windows SDK isn't technically required (the files in Visual Studio 2011 will suffice). If you want to install this SDK, the download you want is at http://www.microsoft.com/download/en/details.aspx?id=8279. Like Visual Studio, this is a web downloader, so the bulk of the downloading is performed while running the installer. The default install options should be sufficient.

Compiling

Start up your compilation environment by running start-msvc11.bat from mozilla-build. You should see output resembling the following:

"Mozilla tools directory: C:\mozilla-build\"
Visual C++ 10 Express directory: C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\
Visual C++ 11 directory: C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\
Visual C++ 11 Express directory: C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\
Windows SDK directory: C:\Program Files\Microsoft SDKs\Windows\v7.1\
Windows SDK version: 7.1
Using VC 2011 built-in SDK
Mozilla build environment: MSVC version 11.

Now, you'll need to fetch mozilla-central:

$ cd /c/dev
$ hg clone https://hg.mozilla.org/mozilla-central

Then, create your .mozconfig:

. $topsrcdir/browser/config/mozconfig

mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/obj-ff-debug

# Set the number after -j to the number of cores in your machine
mk_add_options MOZ_MAKE_FLAGS="-s -j4"

ac_add_options --enable-debug

# add the following if you did NOT install the DirectX SDK
ac_add_options --disable-angle

Then, you should be able to build:

$ ./build/pymake/make.py -f client.mk configure
$ ./build/pymake/make.py -C obj-ff-debug

 Since WIndows 8 isn't officially supported yet, there may be breakage. But, the tree has been known to compile. If you run into errors, look for bugs here. If you see an issue not reported, please file a bug!

Revision Source

<p>Windows 8 will eventually support compiling mozilla-central and related repositories and products. This page documents the steps to get a working Windows 8 development environment.</p>
<h2 id="Installing_Windows_8">Installing Windows 8</h2>
<p>The Windows 8 Consumer Preview setup can be obtained from <a class="external" href="http://windows.microsoft.com/en-US/windows-8/download" title="http://windows.microsoft.com/en-US/windows-8/download">http://windows.microsoft.com/en-US/windows-8/download</a> and <a class="external" href="http://windows.microsoft.com/en-US/windows-8/iso" title="http://windows.microsoft.com/en-US/windows-8/iso">http://windows.microsoft.com/en-US/windows-8/iso</a> if you prefer the ISO images.</p>
<p>If you want to run Windows 8 on Virtualbox, see <a class="external" href="http://www.groovypost.com/howto/install-windows-8-vm-virtualbox/" title="http://www.groovypost.com/howto/install-windows-8-vm-virtualbox/">http://www.groovypost.com/howto/install-windows-8-vm-virtualbox/</a>.</p>
<p>Installing Windows 8 is pretty straightforward for an OS install. These instructions assume you know how to do that.</p>
<p>As for hardware resources of the VM or Virtualbox, you should be able to fit in the base OS, all the dependencies, source and build in a 30GB partition. For memory, 2GB should be considered the minimum. As always, give it as much as you can.</p>
<h2 id="Install_Developer_Tools">Install Developer Tools</h2>
<p>As with the existing Windows 7 development steps, you'll need to install a number of prerequisites.</p>
<h3 id="(required)_Visual_Studio_2012">(required) Visual Studio 2012</h3>
<p>Visual Studio 2012 can be downloaded from <a href="https://www.microsoft.com/visualstudio/11/en-us/downloads" title="https://www.microsoft.com/visualstudio/11/en-us/downloads">https://www.microsoft.com/visualstudio/11/en-us/downloads</a>. The download there is just a simple installer which will download and install the real components. When you install VS2012, have something else to do because it takes a long time.</p>
<p>For now, installation of the full Visual Studio is required. Eventually, compiling on Visual Studio Express should be possible. <a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=701050" title="https://bugzilla.mozilla.org/show_bug.cgi?id=701050">Bug 701050</a> has more.</p>
<h3 id="(required)_mozilla-build_Bundle">(required) mozilla-build Bundle</h3>
<p>The latest mozilla-<a class="external" href="http://ftp.mozilla.org/pub/mozilla.org/mozilla/libraries/win32/MozillaBuildSetup-Latest.exe" title="http://ftp.mozilla.org/pub/mozilla.org/mozilla/libraries/win32/MozillaBuildSetup-Latest.exe">build is required</a>.</p>
<h3 id="(optional)_DirectX_SDK">(optional) DirectX SDK</h3>
<p>Download and install the DirectX SDK from <a class="external" href="http://www.microsoft.com/download/en/details.aspx?displaylang=en&amp;id=6812" title="http://www.microsoft.com/download/en/details.aspx?displaylang=en&amp;id=6812">http://www.microsoft.com/download/en/details.aspx?displaylang=en&amp;id=6812</a>.</p>
<p>If you don't install the DirectX SDK, add the following to your .mozconfig:</p>
<p style="margin-left: 40px;"><code>ac_add_options --disable-webgl</code></p>
<h3 id="(optional)_Windows_SDK">(optional) Windows SDK</h3>
<p>The Windows SDK is a little tricky for Windows 8. Currently, the Windows 8 SDK is only available to MSDN subscribers. If you have access, you can grab it from MSDN under the filename <span id="ctl00_mainContentContainer_ctl03_BPProductDetailsGrid2__DetailsContent_d24aac62-e83f-4690-b40a-5f1f8f2c5823"><span class="FilesDetailsInfoText">en_windows_developer_preview_wdk_x86_x64_741966.zip. You will likely find it under the <em>Windows Developer Preview</em> section listed as </span></span><span><em>Windows Developer Preview WDK (x86 and x64)</em>.</span></p>
<p>Theoretically, you can install the Windows 7 (or 7.1) SDK as a substitute. But, the Windows SDK isn't technically required (the files in Visual Studio 2011 will suffice). If you want to install this SDK, the download you want is at <a class="external" href="http://www.microsoft.com/download/en/details.aspx?id=8279" title="http://www.microsoft.com/download/en/details.aspx?id=8279">http://www.microsoft.com/download/en/details.aspx?id=8279</a>. Like Visual Studio, this is a web downloader, so the bulk of the downloading is performed while running the installer. The default install options should be sufficient.</p>
<h2 id="Compiling">Compiling</h2>
<p>Start up your compilation environment by running <code>start-msvc11.bat</code> from mozilla-build. You should see output resembling the following:</p>
<blockquote>
  <p><code>"Mozilla tools directory: C:\mozilla-build\"<br />
    Visual C++ 10 Express directory: C:\Program Files (x86)\Microsoft Visual Studio 10.0\VC\<br />
    Visual C++ 11 directory: C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\<br />
    Visual C++ 11 Express directory: C:\Program Files (x86)\Microsoft Visual Studio 11.0\VC\<br />
    Windows SDK directory: C:\Program Files\Microsoft SDKs\Windows\v7.1\<br />
    Windows SDK version: 7.1<br />
    Using VC 2011 built-in SDK<br />
    Mozilla build environment: MSVC version 11.</code></p>
</blockquote>
<p>Now, you'll need to fetch mozilla-central:</p>
<pre>
$ cd /c/dev
$ hg clone <a class="external" href="https://hg.mozilla.org/mozilla-central">https://hg.mozilla.org/mozilla-central</a><span id="cke_bm_69S" style="display: none;"><span id="cke_bm_75S" style="display: none;">&nbsp;</span></span>
</pre>
<p>Then, create your .mozconfig:</p>
<pre>
. $topsrcdir/browser/config/mozconfig

mk_add_options MOZ_OBJDIR=@TOPSRCDIR@/obj-ff-debug

# Set the number after -j to the number of cores in your machine
mk_add_options MOZ_MAKE_FLAGS="-s -j4"

ac_add_options --enable-debug

# add the following if you did NOT install the DirectX SDK
ac_add_options --disable-angle
</pre>
<p>Then, you should be able to build:</p>
<pre>
$ ./build/pymake/make.py -f client.mk configure
$ ./build/pymake/make.py -C obj-ff-debug
</pre>
<p>&nbsp;Since WIndows 8 isn't officially supported yet, there may be breakage. But, the tree has been known to compile. If you run into errors, look for bugs <a class="link-https" href="https://bugzilla.mozilla.org/show_bug.cgi?id=687213" title="https://bugzilla.mozilla.org/show_bug.cgi?id=687213">here.</a> If you see an issue not reported, please file a bug!</p>
Revert to this revision