cpython/Mac/BuildScript/resources
Ned Deily b29d0a5a78
[3.8] bpo-41100: Support macOS 11 Big Sur and Apple Silicon Macs (#25806)
* bpo-41100: Support macOS 11 and Apple Silicon on Python 3.8

This is a partial backport of bpo-41100 changes `e8b1c038b1` and `96d906b144` for Python 3.8. We introduce the ability to build Python from source for `arm64` on macOS, but we do not make a promise of support. This allows us to omit support for Universal2 binaries as well as weak-linking of symbols from the macOS SDK based on the deployment target, which are larger changes much more difficult to merge.

This also includes a backport of subsequent bpo-42688 change `7e729978fa` to fix build errors with external `libffi`.

* bpo-41116: Ensure system supplied libraries are found on macOS 11 (GH-23301) (GH-23455)

On macOS system provided libraries are in a shared library cache
and not at their usual location. This PR teaches distutils to search
in the SDK, even if there was no "-sysroot" argument in
the compiler flags.
(cherry picked from commit 404a719b51)

* bpo-42504: fix for MACOSX_DEPLOYMENT_TARGET=11 (GH-23556)

macOS releases numbering has changed as of macOS 11 Big Sur.  Previously, major releases were of the form 10.x, 10.x+1, 10.x+2, etc; as of Big Sur, they are now x, x+1, etc, so, for example, 10.15, 10.15.1, ..., 10.15.7, 11, 11.0.1, 11.1, ..., 12, 12.1, etc. Allow Python to build with single-digit deployment target values. Patch provided by FX Coudert.
(cherry picked from commit 5291639e61)

* bpo-42504: Ensure that get_config_var('MACOSX_DEPLOYMENT_TARGET') is a string (GH-24341) (GH-24410)

* bpo-42504: Ensure that get_config_var('MACOSX_DEPLOYMENT_TARGET') is a string
(cherry picked from commit 49926cf2bc)

Co-authored-by: Ronald Oussoren <ronaldoussoren@mac.com>
Co-authored-by: FX Coudert <fxcoudert@gmail.com>
Co-authored-by: Max Bélanger <aeromax@gmail.com>
2021-05-02 11:18:58 +02:00
..
background.jpg
Conclusion.rtf Add macOS installer Conclusion file 2018-03-12 16:49:59 -04:00
install_certificates.command pypi.python.org -> pypi.org (GH-7613) 2018-06-11 00:45:50 -04:00
License.rtf bpo-39883: Update macOS installer copy of LICENSE. (GH-22235) 2020-09-13 22:38:20 -07:00
ReadMe.rtf [3.8] bpo-41100: Support macOS 11 Big Sur and Apple Silicon Macs (#25806) 2021-05-02 11:18:58 +02:00
Welcome.rtf [3.8] Update macOS installer display files for 3.8.0 (GH-16766) 2019-10-14 04:36:34 -04:00

{\rtf1\ansi\ansicpg1252\cocoartf2580
\cocoatextscaling0\cocoaplatform0{\fonttbl\f0\fswiss\fcharset0 Helvetica;\f1\fswiss\fcharset0 Helvetica-Bold;\f2\fmodern\fcharset0 CourierNewPSMT;
\f3\fswiss\fcharset0 Helvetica-Oblique;}
{\colortbl;\red255\green255\blue255;}
{\*\expandedcolortbl;;}
\margl1440\margr1440\vieww13380\viewh14600\viewkind0
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural\partightenfactor0

\f0\fs24 \cf0 This package will install Python $FULL_VERSION for macOS $MACOSX_DEPLOYMENT_TARGET for the following architecture(s): $ARCHITECTURES.\
\
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\pardirnatural\partightenfactor0

\f1\b \cf0 \ul \ulc0 macOS 11 (Big Sur) and Apple Silicon Mac support [new in 3.8.10]\

\f0\b0 \ulnone \
As of Python 3.8.10, Python is now supported on macOS 11 Big Sur.  The binaries included in this installer install on macOS releases from macOS 10.9 through macOS 11 Big Sur and will run on Apple Silicon Macs using Rosetta 2 translation.  Starting with Python 3.9.1, we provide a new 
\f2 universal2
\f0  installer variant which includes binaries that run natively on both Apple Silicon Macs and Intel-based Macs. \
\

\f1\b \ul Certificate verification and OpenSSL\

\f0\b0 \ulnone \
This package includes its own private copy of OpenSSL 1.1.1.   The trust certificates in system and user keychains managed by the 
\f3\i Keychain Access 
\f0\i0 application and the 
\f3\i security
\f0\i0  command line utility are not used as defaults by the Python 
\f2 ssl
\f0  module.  A sample command script is included in 
\f2 /Applications/Python 3.8
\f0  to install a curated bundle of default root certificates from the third-party 
\f2 certifi
\f0  package ({\field{\*\fldinst{HYPERLINK "https://pypi.org/project/certifi/"}}{\fldrslt https://pypi.org/project/certifi/}}).  Double-click on 
\f2 Install Certificates
\f0  to run it.\
\
The bundled 
\f2 pip
\f0  has its own default certificate store for verifying download connections.\
\

\f1\b \ul Using IDLE or other Tk applications 
\f0\b0 \ulnone \
\
This package includes its own private version of Tcl/Tk 8.6. It does not use any system-supplied or third-party supplied versions of Tcl/Tk.\
\
Due to new security checks on macOS 10.15 Catalina, when launching IDLE macOS may open a window with a message 
\f1\b "Python" would like to access files in your Documents folder
\f0\b0 .  This is normal as IDLE uses your 
\f1\b Documents
\f0\b0  folder as its default when opening and saving files; you can still choose other locations in the 
\f1\b Open
\f0\b0  and 
\f1\b Save
\f0\b0  file dialog windows.  Click on the 
\f1\b OK
\f0\b0  button to proceed.\

\f1\b \ul \
macOS 10.15 (Catalina) Gatekeeper Requirements [changed in 3.8.2]\

\f0\b0 \ulnone \
As of 2020-02-03, Apple has changed how third-party installer packages, like those provided by python.org, are notarized for verification by Gatekeeper and begun enforcing additional requirements such as code signing and use of the hardened runtime.  As of 3.8.2, python.org installer packages now meet those additional notarization requirements.  The necessary changes in packaging should be transparent to your use of Python but, in the unlikely event that you encounter changes in behavior between 3.8.1 and newer 3.8.x releases in areas like ctypes, importlib, or mmap, please check bugs.python.org for existing reports and, if necessary, open a new issue.\

\f1\b \ul \
Python 2.7 end-of-life [changed in 3.8.4]\
\

\f0\b0 \ulnone Python 2.7 has now reached end-of-life. As of Python 3.8.4, the 
\f2 Python Launcher
\f0  app now has 
\f2 python3
\f0  factory defaults.  Also, the 
\f2 Current
\f0  link in the 
\f2 /Library/Frameworks/Python.framework/Versions
\f0  directory is now updated to point to the Python 3 being installed; previously, only Python 2 installs updated 
\f2 Current
\f0 .  This change might affect developers using the framework to embed Python in their applications.  If another version is desired for embedding, the 
\f2 Current
\f0  symlink can be changed manually without affecting 3.8.x behavior.\

\f1\b \ul \
Other changes\

\f0\b0 \ulnone \
For other changes in this release, see the 
\f3\i What's new
\f0\i0  section in the {\field{\*\fldinst{HYPERLINK "https://www.python.org/doc/"}}{\fldrslt Documentation Set}} for this release and its 
\f3\i Release Notes
\f0\i0  link at {\field{\*\fldinst{HYPERLINK "https://www.python.org/downloads/"}}{\fldrslt https://www.python.org/downloads/}}.\
}