gh-117058: Update GUI and packaging recommendations for macOS. (#117059)

This commit is contained in:
Russell Keith-Magee 2024-03-20 23:32:56 +08:00 committed by GitHub
parent 9221ef2d8c
commit 44fbab43d8
No known key found for this signature in database
GPG key ID: B5690EEEBB952194

View file

@ -152,26 +152,41 @@ Tk toolkit (https://www.tcl.tk). An Aqua-native version of Tk is bundled with
macOS by Apple, and the latest version can be downloaded and installed from macOS by Apple, and the latest version can be downloaded and installed from
https://www.activestate.com; it can also be built from source. https://www.activestate.com; it can also be built from source.
*wxPython* is another popular cross-platform GUI toolkit that runs natively on A number of alternative macOS GUI toolkits are available:
macOS. Packages and documentation are available from https://www.wxpython.org.
*PyQt* is another popular cross-platform GUI toolkit that runs natively on * `PySide <https://www.qt.io/qt-for-python>`__: Official Python bindings to the
macOS. More information can be found at `Qt GUI toolkit <https://qt.io>`__.
https://riverbankcomputing.com/software/pyqt/intro.
*PySide* is another cross-platform Qt-based toolkit. More information at * `PyQt <https://riverbankcomputing.com/software/pyqt/intro>`__: Alternative
https://www.qt.io/qt-for-python. Python bindings to Qt.
* `Kivy <https://kivy.org>`__: A cross-platform GUI toolkit that supports
desktop and mobile platforms.
* `Toga <https://toga.readthedocs.io>`__: Part of the `BeeWare Project
<https://beeware.org>`__; supports desktop, mobile, web and console apps.
* `wxPython <https://www.wxpython.org>`__: A cross-platform toolkit that
supports desktop operating systems.
.. _distributing-python-applications-on-the-mac: .. _distributing-python-applications-on-the-mac:
Distributing Python Applications Distributing Python Applications
================================ ================================
The standard tool for deploying standalone Python applications on the Mac is A range of tools exist for converting your Python code into a standalone
:program:`py2app`. More information on installing and using :program:`py2app` distributable application:
can be found at https://pypi.org/project/py2app/.
* `py2app <https://pypi.org/project/py2app/>`__: Supports creating macOS ``.app``
bundles from a Python project.
* `Briefcase <https://briefcase.readthedocs.io>`__: Part of the `BeeWare Project
<https://beeware.org>`__; a cross-platform packaging tool that supports
creation of ``.app`` bundles on macOS, as well as managing signing and
notarization.
* `PyInstaller <https://pyinstaller.org/>`__: A cross-platform packaging tool that creates
a single file or folder as a distributable artifact.
Other Resources Other Resources
=============== ===============
@ -184,4 +199,3 @@ https://www.python.org/community/sigs/current/pythonmac-sig/
Another useful resource is the MacPython wiki: Another useful resource is the MacPython wiki:
https://wiki.python.org/moin/MacPython https://wiki.python.org/moin/MacPython