Skip to content

Commit ea39a90

Browse files
authored
Update setup-building.rst
1 parent f36b0ef commit ea39a90

File tree

1 file changed

+19
-0
lines changed

1 file changed

+19
-0
lines changed

getting-started/setup-building.rst

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -699,6 +699,25 @@ wrap the invocation of the Xcode :program:`xcrun` tool, removing user- and
699699
version-specific paths from the values encoded in the :py:mod:`sysconfig`
700700
module. Copies of these scripts are included in the final build products.
701701

702+
703+
.. note::
704+
705+
The ``--enable-framework`` option installs Python as a macOS Framework.
706+
This changes the install location to
707+
``/Library/Frameworks/Python.framework/Versions/X.Y/`` and integrates
708+
Python with macOS’s native framework system.
709+
710+
Framework builds are required for some GUI libraries (such as ``tkinter`` or
711+
``PyObjC``) and allow Python to be embedded in Cocoa applications via
712+
``NSBundle``.
713+
714+
Without ``--enable-framework``, you still get a working command-line
715+
``python3``, but certain macOS-specific integrations (GUI event loops,
716+
app embedding, etc.) will not work.
717+
718+
719+
720+
702721
Once this build completes, the ``iOS/Frameworks`` folder will contain a
703722
``Python.framework`` that can be used for testing.
704723

0 commit comments

Comments
 (0)