diff options
Diffstat (limited to 'sources/pyside6/doc/building_from_source/macOS.rst')
| -rw-r--r-- | sources/pyside6/doc/building_from_source/macOS.rst | 28 |
1 files changed, 18 insertions, 10 deletions
diff --git a/sources/pyside6/doc/building_from_source/macOS.rst b/sources/pyside6/doc/building_from_source/macOS.rst index bb6a0dd2b..dca804cba 100644 --- a/sources/pyside6/doc/building_from_source/macOS.rst +++ b/sources/pyside6/doc/building_from_source/macOS.rst @@ -4,7 +4,7 @@ macOS Requirements ------------ -* `XCode`_ 8.2 (macOS 10.11), 8.3.3 (macOS 10.12), 9 (macOS 10.13), 10.1 (macOS 10.14) +* `Xcode`_ 8.2 (macOS 10.11), 8.3.3 (macOS 10.12), 9 (macOS 10.13), 10.1 (macOS 10.14) * ``sphinx`` package for the documentation (optional). * Depending on your OS, the following dependencies might also be required: @@ -12,7 +12,7 @@ Requirements * Check the platform dependencies of `Qt for macOS`_. -.. _XCode: https://developer.apple.com/xcode/ +.. _Xcode: https://developer.apple.com/xcode/ .. _`Qt for macOS`: https://doc.qt.io/qt-6/macos.html Building from source @@ -37,17 +37,17 @@ project management. The following command creates a virtual environment using `u .. note:: Since the Qt for Python project still uses `setup.py` and not `pyproject.toml`, currently `uv` can only be used as a replacement for `pyenv` for building Qt for Python. If you - have already the `.python_version` file(used by .pyenv) in the project, make sure to + have already the `.python-version` file (used by `pyenv`) in the project, make sure to change the version to the `uv`_ Python you want to use. Setting up CLANG ~~~~~~~~~~~~~~~~ -If you don't have libclang already in your system, you can download from the Qt servers:: +If you don't have `libclang` already in your system, you can download from the Qt servers:: wget https://download.qt.io/development_releases/prebuilt/libclang/libclang-release_18.1.5-based-macos-universal.7z -Extract the files, and leave it on any desired path, and set the environment +Extract the files, and leave it in any desired path, and set the environment variable required:: 7z x libclang-release_18.1.5-based-macos-universal.7z @@ -86,7 +86,7 @@ Build can take a few minutes, so it is recommended to use more than one CPU core python setup.py build --qtpaths=/opt/Qt/6.8.0/gcc_64/bin/qtpaths --build-tests --ignore-git --parallel=8 -With `uv`_, this commands becomes:: +With `uv`_, this command becomes:: uv run setup.py build --qtpaths=/opt/Qt/6.8.0/gcc_64/bin/qtpaths --build-tests --ignore-git --parallel=8 @@ -94,13 +94,19 @@ With `uv`_, this commands becomes:: Installing PySide ~~~~~~~~~~~~~~~~~ -To install on the current directory, just run:: +First, create the wheels using the `create_wheels.py`_ script:: - python setup.py install --qtpaths=/opt/Qt/6.8.0/gcc_64/bin/qtpaths --build-tests --ignore-git --parallel=8 + python create_wheels.py --build-dir=/directory/where/pyside/is/built --no-examples -With `uv`_, this commands becomes:: +On successful completion, the wheels will be created in the `dist` directory. - uv run setup.py install --qtpaths=/opt/Qt/6.8.0/gcc_64/bin/qtpaths --build-tests --ignore-git --parallel=8 +.. note:: The `build-dir` typically looks like `build/<your_python_environment_name>`. The + requirement is that this `build-dir` should contain the `packages_for_wheel` directory. + If the `python setup.py` build command was successful, this directory should be present. + +Finally, to install the wheels, use the following command:: + + pip install dist/*.whl Test installation ~~~~~~~~~~~~~~~~~ @@ -111,3 +117,5 @@ Remember to properly set the environment variables for Qt and PySide:: python examples/widgets/widgets/tetrix/tetrix.py .. _`uv`: https://docs.astral.sh/uv/ +.. _`create_wheels.py`: https://code.qt.io/cgit/pyside/pyside-setup.git/tree/create_wheels.py + |