diff options
Diffstat (limited to 'sources/pyside6/doc/gettingstarted/windows.rst')
-rw-r--r-- | sources/pyside6/doc/gettingstarted/windows.rst | 37 |
1 files changed, 28 insertions, 9 deletions
diff --git a/sources/pyside6/doc/gettingstarted/windows.rst b/sources/pyside6/doc/gettingstarted/windows.rst index 5fec92bca..f688acd90 100644 --- a/sources/pyside6/doc/gettingstarted/windows.rst +++ b/sources/pyside6/doc/gettingstarted/windows.rst @@ -7,15 +7,17 @@ selected when using the online installer. Requirements ------------ - * `MSVC2022`_ or (MSVC2019) for Python 3 on Windows, - * `OpenSSL`_ (optional for SSL support, Qt must have been configured using the same SSL library). - * ``sphinx`` package for the documentation (optional). +* `MSVC2022`_ or (MSVC2019) for Python 3 on Windows, +* `OpenSSL`_ (optional for SSL support, Qt must have been configured using the same SSL library). +* ``sphinx`` package for the documentation (optional). +* Check the platform dependencies of `Qt for Windows`_. -.. note:: Python 3.8.0 was missing some API required for PySide/Shiboken so it's not possible - to use it for a Windows build. +.. note:: The Python provided by the Microsoft Store is not compatible with PySide. Please + use https://www.python.org/downloads/ to get a Python Interpreter. .. _MSVC2022: https://visualstudio.microsoft.com/downloads/ .. _OpenSSL: https://sourceforge.net/projects/openssl/ +.. _`Qt for Windows`: https://doc.qt.io/qt-6/windows.html Building from source on Windows 10 ---------------------------------- @@ -36,7 +38,7 @@ Setting up CLANG libclang can be downloaded from the `Qt servers <https://download.qt.io/development_releases/prebuilt/libclang>`_. -for example, ``libclang-release_130-based-windows-vs2019_64.7z``. +for example, ``libclang-release_140-based-windows-vs2019_64.7z``. Note that from version 12 onwards, the prebuilt Windows binaries from `LLVM <https://www.llvm.org>`_ no longer contain CMake configuration files; so @@ -55,9 +57,9 @@ Cloning the official repository can be done by:: git clone https://code.qt.io/pyside/pyside-setup -Checking out the version that we want to build, for example, 6.2:: +Checking out the version that we want to build, for example, 6.5:: - cd pyside-setup && git checkout 6.2 + cd pyside-setup && git checkout 6.5 Install the general dependencies:: @@ -69,12 +71,29 @@ Building PySide ~~~~~~~~~~~~~~~ Check your Qt installation path, to specifically use that version of qtpaths to build PySide. -for example, ``C:\Qt\6.4.0\msvc2019_64\bin\qtpaths.exe``. +for example, ``C:\Qt\6.5.0\msvc2019_64\bin\qtpaths.exe``. Build can take a few minutes, so it is recommended to use more than one CPU core:: python setup.py build --qtpaths=c:\path\to\qtpaths.exe --openssl=c:\path\to\openssl\bin --build-tests --ignore-git --parallel=8 +.. _creating_windows_debug_builds: + +Creating Debug Builds +~~~~~~~~~~~~~~~~~~~~~ + +* Choose *Custom Installation* when installing Python and tick the options for + debug binaries and libraries + +* Use ``venv`` to create a virtual environment and pass the debug binary:: + + python_d.exe -m venv testenv_d + +* Use ``python_d.exe`` to invoke ``setup.py`` + +.. note:: Make sure you add the ``--debug`` option to the ``python setup.py install`` to produce a debug build + + Installing PySide ~~~~~~~~~~~~~~~~~ |