Differences between revisions 53 and 73 (spanning 20 versions)
⇤ ← Revision 53 as of 2017-02-14 13:02:09 →
Size: 12534
Editor: Jgoutin
Comment: Python 3.6
← Revision 73 as of 2023-06-09 12:03:05 → ⇥
Size: 11423
Editor: MarcAndreLemburg
Comment:
Deletions are marked like this. Additions are marked like this.
Line 17: Line 17:
||14.0 ||3.5, 3.6 ||
||10.0 ||3.3, 3.4 ||
||9.0 ||2.6, 2.7, 3.0, 3.1, 3.2 ||		 ||14.x ||3.5 - 3.12+ ||
||10.0 ||3.3 - 3.4 ||
||9.0 ||2.6 - 2.7, 3.0 - 3.2 ||
Line 21: Line 21:
Please also have a look at [[https://devguide.python.org/getting-started/setup-building/index.html#windows|The Python Dev Guide for Windows]] to check for additional requirements or updates to the above table.
Line 22: Line 23:
= Distutils notes =
If the package's ''setup.py'' (still) uses ''distutils'' rather than the [[https://docs.python.org/2/library/distutils.html|recommended]] ''setuptools'', you may need extra steps:
Line 23: Line 26:
 * ''distutils'' only supports the very minimum of compiler setups. The sections in this guide corresponding to them explicitly mention ''distutils''.
 * For other setups, you need to run the compilation from the "SDK prompt" of the corresponding toolchain and set the ''DISTUTILS_USE_SDK'' environment variable to a non-empty value.
Line 32: Line 37:

== Microsoft Visual C++ 14.x with Visual Studio 2022 (x86, x64, ARM, ARM64) ==

 * Install ''[[https://visualstudio.microsoft.com/downloads/|Microsoft Visual Studio 2022]]'' (or later).
 * Install the ''Python development'' workload and the optional ''Python native development tools'' option.
 * Install the latest ''Windows SDK'' (under ''Native development'' in the installer).
 * Optional: Set {{{$env:PlatformToolset}}} to your toolset version before building, if it doesn't detect it.
 * Update to the latest ''setuptools'' Python package version.

For additional details, please have a look at the Windows section of the [[https://devguide.python.org/setup/#windows|Python Development Guide]] and the [[https://github.com/python/cpython/blob/main/PCbuild/python.props|PCbuild/python.props]] file for full details on how Python is built on Windows.

At the time of this writing, CPython is built using VC++ 14.3 (Jan 2022).

== Microsoft Visual C++ 14.2 standalone: Build Tools for Visual Studio 2019 (x86, x64, ARM, ARM64) ==
This is a standalone version of ''Visual C++ 14.2'' compiler, you don't need to install ''Visual Studio 2019''.

 * Install ''[[https://visualstudio.microsoft.com/vs/older-downloads/|Microsoft Build Tools for Visual Studio 2019]]''.
 * In Build tools, install ''C++ build tools'' and ensure the latest versions of ''MSVCv142 - VS 2019 C++ x64/x86 build tools'' and ''Windows 10 SDK'' are checked.
 * The ''setuptools'' Python package version must be at least 34.4.0.

{i} Build Tools also allows to install any previous Visual C++ 14 version (Including 2015, 2017 ones).

== Microsoft Visual C++ 14.2 with Visual Studio 2019 (x86, x64, ARM, ARM64) ==
''Visual Studio 2019'' contains ''Visual C++ 14.2'' compiler. The ''setuptools'' Python package version must be at least 34.4.0.

== Microsoft Visual C++ 14.1 standalone: Build Tools for Visual Studio 2017 (x86, x64, ARM, ARM64) ==
This is a standalone version of ''Visual C++ 14.1'' compiler, you don't need to install ''Visual Studio 2017''.

 * Install ''Microsoft Build Tools for Visual Studio 2017''.
 * The ''setuptools'' Python package version must be at least 34.4.0.

/!\ Build Tools for Visual Studio 2017 was upgraded by Microsoft to Build Tools for Visual Studio 2019. See the previous paragraph to install it.

== Microsoft Visual C++ 14.1 with Visual Studio 2017 (x86, x64, ARM, ARM64) ==
''Visual Studio 2017'' contains ''Visual C++ 14.1'' compiler. The ''setuptools'' Python package version must be at least 34.4.0.

/!\ Visual Studio 2017 was upgraded by Microsoft to Visual Studio 2019. See the previous paragraph to install it.
Line 35: Line 78:
 * Install ''[[http://landinghub.visualstudio.com/visual-cpp-build-tools|Microsoft Visual C++ Build Tools 2015]]''. Check ''Windows 8.1 SDK'' and ''Windows 10 SDK'' options.  * Install ''Microsoft Visual C++ Build Tools 2015''. Check ''Windows 8.1 SDK'' and ''Windows 10 SDK'' options.
Line 37: Line 80:

/!\ Visual C++ Build Tools 2015 was upgraded by Microsoft to Build Tools for Visual Studio 2017. See the previous paragraph to install it.
Line 40: Line 85:

/!\ Visual Studio 2015 was upgraded by Microsoft to Visual Studio 2017. See the previous paragraph to install it.
Line 62: Line 109:
{i} This package always installs its start menu shortcuts for the installing user (i.e. an administrator) only. To get them for all users, run the installation like this: ''msiexec /i <full path to .msi> ALLUSERS=1''.
Line 68: Line 117:
 * Install ''[[https://www.microsoft.com/download/details.aspx?id=3138|Microsoft Windows SDK for Windows 7 and .NET Framework 3.5 SP1]]''. Check ''Windows headers and libraries'', ''Visual C++ Compilers'' and ''Win32 Developement Tools'' options only.  * Install ''Microsoft Windows SDK for Windows 7 and .NET Framework 3.5 SP1''. Check ''Windows headers and libraries'', ''Visual C++ Compilers'' and ''Win32 Development Tools'' options only.
Line 77: Line 126:
 * Install ''[[https://www.microsoft.com/download/details.aspx?id=11310|Microsoft Windows SDK for Windows Server 2008 and .NET Framework 3.5]]''. Check ''Windows headers and libraries'', ''Visual C++ Compilers'' and ''Win32 Development Tools'' options only.  * Install ''Microsoft Windows SDK for Windows Server 2008 and .NET Framework 3.5''. Check ''Windows headers and libraries'', ''Visual C++ Compilers'' and ''Win32 Development Tools'' options only.
Line 83: Line 132:
== GCC - MinGW (x86) ==
GCC adapted for Windows		 == GCC - MinGW-w64 (x86, x64) ==
Line 86: Line 134:
MinGW is an alternative C++ compiler that works with all Python versions. [[http://mingw-w64.org|MinGW-w64]] is an alternative C/C++ compiler that works with all Python versions up to 3.4.
Line 88: Line 136:
From http://www.mingw.org/:

MinGW, a contraction of "Minimalist GNU for Windows", is a minimalist development environment for native Microsoft Windows applications.

MinGW provides a complete Open Source programming tool set which is suitable for the development of native MS-Windows applications, and which do not depend on any 3rd-party C-Runtime DLLs. (It does depend on a number of DLLs provided by Microsoft themselves, as components of the operating system; most notable among these is [[https://www.win7dll.info/msvcrt_dll.htm|MSVCRT.DLL]], the Microsoft C runtime library. Additionally, threaded applications must ship with a freely distributable thread support DLL, provided as part of MinGW itself).

MinGW compilers provide access to the functionality of the Microsoft C runtime and some language-specific runtimes. MinGW, being Minimalist, does not, and never will, attempt to provide a POSIX runtime environment for POSIX application deployment on MS-Windows. If you want POSIX application deployment on this platform, please consider Cygwin instead.

Primarily intended for use by developers working on the native MS-Windows platform, but also available for cross-hosted use, (see note below -- you may need to follow the "read more" link to see it), MinGW includes:

 * A port of the GNU Compiler Collection (GCC), including C, C++, ADA and Fortran compilers;
 * [[https://en.wikipedia.org/wiki/GNU_Binutils|GNU Binutils]] for Windows (assembler, linker, archive manager)
 * A command-line installer, with optional GUI front-end, (mingw-get) for MinGW and MSYS deployment on MS-Windows
 * A GUI first-time setup tool (mingw-get-setup), to get you up and running with mingw-get.

 * Install ''[[http://sourceforge.net/projects/mingw/files/|Minimalist GNU For Windows]]'' into ''C:\MinGW''.
 * Open ''MinGW Installation Manager'', check ''mingw32-base'' and ''mingw32-gcc-g++'', and ''Apply Changes'' in the ''Installation'' menu.
 * Add ''C:\MinGW\bin'' to the ''PATH'' environment variable (With ";" before if PATH is not empty).		  * Install ''[[http://win-builds.org/doku.php/download_and_installation_from_windows|Win-builds]]'' into ''C:\MinGW_w64''.
 * Open ''Win-builds'', switch to ''install'' at least ''binutils'', ''gcc'', ''gcc-g++'', ''getext'', ''mingw-w64'', ''win-iconv'', ''winpthreads'', ''zlib'', and click ''Process''.
 * Add ''C:\MinGW_w64\bin'' to the ''PATH'' environment variable.
Line 115: Line 148:
== GCC - MSYS2 ==
GCC for Windows with Extras
Line 118: Line 149:
MSYS2 combines Cygwin (or at least a Cygwin fork) with MinGW - it has a Linux like command line package installer (for non-python things, this is good) named "pacman" ported from Arch Linux. It contains a 4 flavors of Python for Windows: MSYS2 (Cygwin-like) Python 3, MSYS2 (Cygwin-like) Python 2, MinGW (Stand Alone Windows) Python 3, and MinGW (Stand Alone Windows) Python 2. Similarly it has MSYS2 (Cygwin-like) and MinGW flavors of GCC. You can rebuild Python and Python modules using the appropriate gcc. == GCC - MinGW (x86) ==
Line 120: Line 151:
[[http://www.mingw.org/wiki/MSYS|MSYS description From the MinGW Wiki]] [[http://www.mingw.org/|MinGW]] is an alternative C/C++ compiler that works with all Python versions up to 3.4.
Line 122: Line 153:
MSYS (Minimal SYStem) is a collection of GNU utilities such as bash, make, gawk and grep to allow building of applications and programs which depend on traditionally UNIX tools to be present. It is intended to supplement MinGW and the deficiencies of the cmd shell.  * Install ''[[http://sourceforge.net/projects/mingw/files/|Minimalist GNU For Windows]]'' into ''C:\MinGW''.
 * Open ''MinGW Installation Manager'', check ''mingw32-base'' and ''mingw32-gcc-g++'', and ''Apply Changes'' in the ''Installation'' menu.
 * Add ''C:\MinGW\bin'' to the ''PATH'' environment variable.
 * Create a ''distutils.cfg'' file with the following contents in the folder ''\Lib\distutils'' in Python install directory :
Line 124: Line 158:
An example would be building a library that uses the autotools build system. Users will typically run "./configure" then "make" to build it. The configure shell script requires a shell script interpreter which is not present on Windows systems, but provided by MSYS. {{{#!highlight ini
[build]
compiler=mingw32
Line 126: Line 162:
[[https://wiki.qt.io/MSYS2|MSYS2 description From the QT Wiki]]

MSYS2 (Minimal SYStem 2) is an independent rewrite of MSYS, a (command-line) shell for development usage, and based on modern Cygwin (POSIX compatibility layer) and MinGW-w64 (from "MinGW-builds"), with the aim of better interoperability with native Windows software. It includes: MSYS2-shell and MinGW-w64 Win32 shell & MinGW-w64 Win64 shell. It supports & can work with both 32bit & 64bit multiple toolchains & targets, (for 64bit a 64bit operating system is needed). MSYS2 is a successor of MSYS and MinGW-builds. MSYS2-shell uses "pacman" for downloading packages from repo, and these are GPG signed & verified.

'''More MSYS2 Links'''

 * [[https://sourceforge.net/p/msys2/wiki/Home/|sourceforge.net - msys2 - Wiki Home]]
 * [[https://sourceforge.net/p/msys2/wiki/Launchers/|sourceforge.net - msys2 - Launchers]]
 * [[https://github.com/elieux/msys2-launcher|github.com - msys2-launcher]]
 * [[https://sourceforge.net/p/msys2/wiki/MSYS2%20introduction/|sourceforge.net - msys2 - MSYS2 Introduction]]
 * [[https://sourceforge.net/p/msys2/wiki/Contributing%20to%20MSYS2/|sourceforge.net - msys2 - Contributing to MSYS2 (How to Build MSYS2 from Source)]]
 * [[https://sourceforge.net/p/msys2/wiki/MSYS2%20installation/|sourceforge.net - msys2 - MSYS2 Installation (Download and Install)]]
 * [[https://sourceforge.net/p/msys2/wiki/MSYS2%20re-installation/|sourceforge.net - msys2 - MSYS2 Re-Installation (rebuild once you have a base-installation)]]
 * [[https://sourceforge.net/p/msys2/mailman/|sourceforge.net - msys2 - MSYS2 Mailing Lists (Support Forums)]]

 * [[https://sourceforge.net/p/msys2/wiki/Packages/|sourceforge.net - msys2 - MSYS2 Package List]]
  * mingw/mingw-w64-python2
  * mingw/mingw-w64-python3
  * msys/python2
  * msys/python

= Links =
 * [[https://support.microsoft.com/kb/2977003|Microsoft : The latest supported Visual C++ downloads]] : List of up-to-date ''Visual C++ Redistributable'' and ''Visual Studio'' packages.
 * [[http://www.mingw.org/wiki/Interoperability_of_Libraries_Created_by_Different_Compiler_Brands|mingw.org - Interoperability of Libraries Created by Different Compiler Brands]]
 * [[https://en.wikipedia.org/wiki/X86_calling_conventions|Wikipedia - X86 calling conventions]]
 * [[http://www.nasm.us/doc/nasmdoc7.html|nasm.us - Output Formats]]
 * [[http://bugs.python.org/issue4709|bugs.python.org - Mingw-w64 and python on windows x64]]
 * [[http://www.sciencezero.org/index.php?title=How_to_write_x64_assembly_functions_in_Visual_C++|How to write x64 assembly functions in Visual C++]] - Details on ABI concerns		 [build_ext]
compiler=mingw32
}}}

Contents

  1. Which Microsoft Visual C++ compiler to use with a specific Python version ?
  2. Distutils notes
  3. Compilers Installation and configuration
    1. Microsoft Visual C++ 14.x with Visual Studio 2022 (x86, x64, ARM, ARM64)
    2. Microsoft Visual C++ 14.2 standalone: Build Tools for Visual Studio 2019 (x86, x64, ARM, ARM64)
    3. Microsoft Visual C++ 14.2 with Visual Studio 2019 (x86, x64, ARM, ARM64)
    4. Microsoft Visual C++ 14.1 standalone: Build Tools for Visual Studio 2017 (x86, x64, ARM, ARM64)
    5. Microsoft Visual C++ 14.1 with Visual Studio 2017 (x86, x64, ARM, ARM64)
    6. Microsoft Visual C++ 14.0 standalone: Visual C++ Build Tools 2015 (x86, x64, ARM)
    7. Microsoft Visual C++ 14.0 with Visual Studio 2015 (x86, x64, ARM)
    8. Microsoft Visual C++ 10.0 standalone: Windows SDK 7.1 (x86, x64, ia64)
    9. Microsoft Visual C++ 10.0 with Visual Studio 2010 (x86, x64, ia64)
    10. Microsoft Visual C++ 9.0 standalone: Visual C++ Compiler for Python 2.7 (x86, x64)
    11. Microsoft Visual C++ 9.0 standalone: Windows SDK 7.0 (x86, x64, ia64)
    12. Microsoft Visual C++ 9.0 standalone: Windows SDK 6.1 (x86, x64, ia64)
    13. Microsoft Visual C++ 9.0 with Visual Studio 2008 (x86, x64, ia64)
    14. GCC - MinGW-w64 (x86, x64)
    15. GCC - MinGW (x86)

Even though Python is an interpreted language, you may need to install Windows C++ compilers in some cases. Unlike Linux, compilers for Windows are not included by default in the OS.

For example, you will need to use them if you wish to:

Microsoft provides official C++ compilers called Visual C++, you can find them bundled with Visual Studio or, for some versions, in standalone distributions. Some alternative compilers exist like MinGW, but incompatibilities may occur with a CPython official distribution that is built with Microsoft Visual C++.

The compiler's architecture must be the same as Python's (for example: if you use Python 64bit, you have to use an x64 compiler).

Which Microsoft Visual C++ compiler to use with a specific Python version ?

Each Python version uses a specific compiler version (e.g. CPython 2.7 uses Visual C++ 9.0, CPython 3.3 uses Visual C++ 10.0, etc). So, you need to install the compiler version that corresponds to your Python version :

Visual C++

CPython

14.x

3.5 - 3.12+

10.0

3.3 - 3.4

9.0

2.6 - 2.7, 3.0 - 3.2

Please also have a look at The Python Dev Guide for Windows to check for additional requirements or updates to the above table.

Distutils notes

If the package's setup.py (still) uses distutils rather than the recommended setuptools, you may need extra steps:

  • distutils only supports the very minimum of compiler setups. The sections in this guide corresponding to them explicitly mention distutils.

  • For other setups, you need to run the compilation from the "SDK prompt" of the corresponding toolchain and set the DISTUTILS_USE_SDK environment variable to a non-empty value.

Compilers Installation and configuration

Compatible architectures are specified for each compiler in brackets.

/!\ Before do anything, install or upgrade the Setuptools Python package. It contain compatibility improvements and add automatic use of compilers: 

pip install --upgrade setuptools

Microsoft Visual C++ 14.x with Visual Studio 2022 (x86, x64, ARM, ARM64)

  • Install Microsoft Visual Studio 2022 (or later).

  • Install the Python development workload and the optional Python native development tools option.

  • Install the latest Windows SDK (under Native development in the installer).

  • Optional: Set $env:PlatformToolset to your toolset version before building, if it doesn't detect it.

  • Update to the latest setuptools Python package version.

For additional details, please have a look at the Windows section of the Python Development Guide and the PCbuild/python.props file for full details on how Python is built on Windows.

At the time of this writing, CPython is built using VC++ 14.3 (Jan 2022).

Microsoft Visual C++ 14.2 standalone: Build Tools for Visual Studio 2019 (x86, x64, ARM, ARM64)

This is a standalone version of Visual C++ 14.2 compiler, you don't need to install Visual Studio 2019.

  • Install Microsoft Build Tools for Visual Studio 2019.

  • In Build tools, install C++ build tools and ensure the latest versions of MSVCv142 - VS 2019 C++ x64/x86 build tools and Windows 10 SDK are checked.

  • The setuptools Python package version must be at least 34.4.0.

{i} Build Tools also allows to install any previous Visual C++ 14 version (Including 2015, 2017 ones).

Microsoft Visual C++ 14.2 with Visual Studio 2019 (x86, x64, ARM, ARM64)

Visual Studio 2019 contains Visual C++ 14.2 compiler. The setuptools Python package version must be at least 34.4.0.

Microsoft Visual C++ 14.1 standalone: Build Tools for Visual Studio 2017 (x86, x64, ARM, ARM64)

This is a standalone version of Visual C++ 14.1 compiler, you don't need to install Visual Studio 2017.

  • Install Microsoft Build Tools for Visual Studio 2017.

  • The setuptools Python package version must be at least 34.4.0.

/!\ Build Tools for Visual Studio 2017 was upgraded by Microsoft to Build Tools for Visual Studio 2019. See the previous paragraph to install it.

Microsoft Visual C++ 14.1 with Visual Studio 2017 (x86, x64, ARM, ARM64)

Visual Studio 2017 contains Visual C++ 14.1 compiler. The setuptools Python package version must be at least 34.4.0.

/!\ Visual Studio 2017 was upgraded by Microsoft to Visual Studio 2019. See the previous paragraph to install it.

Microsoft Visual C++ 14.0 standalone: Visual C++ Build Tools 2015 (x86, x64, ARM)

This is a standalone version of Visual C++ 14.0 compiler, you don't need to install Visual Studio 2015.

  • Install Microsoft Visual C++ Build Tools 2015. Check Windows 8.1 SDK and Windows 10 SDK options.

  • The setuptools Python package version must be at least 24.0.

/!\ Visual C++ Build Tools 2015 was upgraded by Microsoft to Build Tools for Visual Studio 2017. See the previous paragraph to install it.

Microsoft Visual C++ 14.0 with Visual Studio 2015 (x86, x64, ARM)

Visual Studio 2015 contains Visual C++ 14.0 compiler. Distutils will automatically detect the compiler and use it.

/!\ Visual Studio 2015 was upgraded by Microsoft to Visual Studio 2017. See the previous paragraph to install it.

Microsoft Visual C++ 10.0 standalone: Windows SDK 7.1 (x86, x64, ia64)

This is a standalone version of Visual C++ 10.0 compiler, you don't need to install Visual Studio 2010.

Microsoft Visual C++ 10.0 with Visual Studio 2010 (x86, x64, ia64)

Visual Studio 2010 contains Visual C++ 10.0 compiler. Distutils will automatically detect the compiler and use it. The Express edition of Visual Studio 2010 only bundles a compiler for x86.

Microsoft Visual C++ 9.0 standalone: Visual C++ Compiler for Python 2.7 (x86, x64)

This is a standalone version of Visual C++ 9.0 compiler, you don't need to install Visual Studio 2008.

{i} Even though this package's name refers to Python 2.7 specifically, you can use it with all Python versions that use Visual C++ 9.0.

{i} This package always installs its start menu shortcuts for the installing user (i.e. an administrator) only. To get them for all users, run the installation like this: msiexec /i <full path to .msi> ALLUSERS=1.

Microsoft Visual C++ 9.0 standalone: Windows SDK 7.0 (x86, x64, ia64)

This is a standalone version of Visual C++ 9.0 compiler, you don't need to install Visual Studio 2008.

/!\ The use of Microsoft Visual C++ Compiler for Python 2.7 is recommended (If you don't need to compile for ia64). See the previous paragraph to install it.

  • Install Microsoft .NET Framework 3.5 SP1 if not present.

  • Install Microsoft Windows SDK for Windows 7 and .NET Framework 3.5 SP1. Check Windows headers and libraries, Visual C++ Compilers and Win32 Development Tools options only.

  • The setuptools Python package version must be at least 24.0.

Microsoft Visual C++ 9.0 standalone: Windows SDK 6.1 (x86, x64, ia64)

This is a standalone version of Visual C++ 9.0 compiler, you don't need to install Visual Studio 2008.

/!\ Windows SDK 6.1 was upgraded by Microsoft to Windows SDK 7.0. See the previous paragraph to install it.

  • Install Microsoft .NET Framework 3.5 SP1 if not present.

  • Install Microsoft Windows SDK for Windows Server 2008 and .NET Framework 3.5. Check Windows headers and libraries, Visual C++ Compilers and Win32 Development Tools options only.

  • The setuptools Python package version must be at least 24.0.

Microsoft Visual C++ 9.0 with Visual Studio 2008 (x86, x64, ia64)

Visual Studio 2008 contains Visual C++ 9.0 compiler. Distutils will automatically detect the compiler and use it. The Express edition of Visual Studio 2008 only bundles a compiler for x86.

GCC - MinGW-w64 (x86, x64)

MinGW-w64 is an alternative C/C++ compiler that works with all Python versions up to 3.4.

  • Install Win-builds into C:\MinGW_w64.

  • Open Win-builds, switch to install at least binutils, gcc, gcc-g++, getext, mingw-w64, win-iconv, winpthreads, zlib, and click Process.

  • Add C:\MinGW_w64\bin to the PATH environment variable.

  • Create a distutils.cfg file with the following contents in the folder \Lib\distutils in Python install directory : 

   1 [build]
   2 compiler=mingw32
   3 
   4 [build_ext]
   5 compiler=mingw32

GCC - MinGW (x86)

MinGW is an alternative C/C++ compiler that works with all Python versions up to 3.4.

  • Install Minimalist GNU For Windows into C:\MinGW.

  • Open MinGW Installation Manager, check mingw32-base and mingw32-gcc-g++, and Apply Changes in the Installation menu.

  • Add C:\MinGW\bin to the PATH environment variable.

  • Create a distutils.cfg file with the following contents in the folder \Lib\distutils in Python install directory : 

   1 [build]
   2 compiler=mingw32
   3 
   4 [build_ext]
   5 compiler=mingw32

WindowsCompilers (last edited 2023-06-09 12:03:05 by MarcAndreLemburg)

Unable to edit the page? See the FrontPage for instructions.