build/docs/supported-configurations.rst

   1 .. _build_supported_configurations:
   2
   3 ========================
   4 Supported Configurations
   5 ========================
   6
   7 This page attempts to document supported build configurations.
   8
   9 Windows
  10 =======
  11
  12 We support building on Windows XP and newer operating systems using
  13 Visual Studio 2010 and newer.
  14
  15 The following are not fully supported by Mozilla (but may work):
  16
  17 * Building without the latest *MozillaBuild* Windows development
  18   environment
  19 * Building with Mingw or any other non-Visual Studio toolchain.
  20
  21 OS X
  22 ====
  23
  24 We support building on OS X 10.6 and newer with the OS X 10.6 SDK.
  25
  26 The tree should build with the following OS X releases and SDK versions:
  27
  28 * 10.6 Snow Leopard
  29 * 10.7 Lion
  30 * 10.8 Mountain Lion
  31 * 10.9 Mavericks
  32
  33 The tree requires building with Clang 3.3 and newer. This corresponds to
  34 version of 4.2 of Apple's Clang that ships with Xcode. This corresponds
  35 to Xcode 4.6 and newer. Xcode 4.6 only runs on OS X 10.7.4 and newer.
  36 So, OS X 10.6 users will need to install a non-Apple toolchain. Running
  37 ``mach bootstrap`` should install an appropriate toolchain from Homebrew
  38 or MacPorts automatically.
  39
  40 The tree should build with GCC 4.4 and newer on OS X. However, this
  41 build configuration isn't as widely used (and differs from what Mozilla
  42 uses to produce OS X builds), so it's recommended to stick with Clang.
  43
  44 Linux
  45 =====
  46
  47 Linux 2.6 and later kernels are supported.
  48
  49 Most distributions are supported as long as the proper package
  50 dependencies are in place. Running ``mach bootstrap`` should install
  51 packages for popular Linux distributions. ``configure`` will typically
  52 detect missing dependencies and inform you how to disable features to
  53 work around unsatisfied dependencies.
  54
  55 Clang 3.3 or GCC 4.4 is required to build the tree.