Building PySide on macOS: Difference between revisions

From Qt Wiki
Jump to navigation Jump to search
No edit summary
 
No edit summary
 
(12 intermediate revisions by 6 users not shown)
Line 1: Line 1:
'''English''' [http://qt-devnet.developpez.com/tutoriels/python/pyside/installer/?page=osx#VIII French] ''[qt-devnet.developpez.com]''


=Building PySide on OS X=
{| class="wikitable"
|-
| style="background: #ff6961;text-align: center;"| Attention
|-
| This is a page dedicated to PySide (Qt4). For recent development on PySide2 (Qt5) and PySide6 (Qt6) refer to [[Qt for Python]]
|}


PySide uses the CMake build system to build the source code packages. If you are not familiar with CMake, have a look at our [[PySide CMake Primer|PySide_CMake_Primer]] before going further.
[[Category:PySide]]


==Getting the source code==
'''English''' [http://qt-devnet.developpez.com/tutoriels/python/pyside/installer/?page=osx#VIII French]


The latest source code tarballs for the PySide components can be acquired from [[PySideDownloads]]. Alternatively, if you are interested in the latest and greatest, you might want to clone our [http://qt.gitorious.org/pyside Gitorious repository] ''[qt.gitorious.org]''.


==Prerequisites==
PySide uses the CMake build system to build the source code packages. If you are not familiar with CMake, have a look at our [[PySide_CMake_Primer]] before going further.


* [http://developer.apple.com/technologies/tools/xcode.html Xcode Developer Tools] ''[developer.apple.com]'' Follow the instructions on the site to install
== Getting the source code ==
* CMake &gt;= 2.6.0 (<span class="caps">OBS</span>: cmake 2.8.2 does not work for me with python2.7)
 
** [http://www.cmake.org/files/v2.6/cmake-2.6.4-Darwin-universal.dmg CMake 2.6.4] ''[cmake.org]''
The latest source code tarballs for the PySide components can be acquired from [[PySideDownloads]]. Alternatively, if you are interested in the latest and greatest, you might want to clone our [http://code.qt.io/pyside code.qt.io repository].
* Qt libraries and development headers &gt;= 4.6 (preferably the latest stable release)
 
** [http://qt.nokia.com/downloads/sdk-mac-os-cpp Qt 4.7] ''[qt.nokia.com]''
== Prerequisites ==
* Python libraries and development headers &gt;= 2.5 (for shiboken and pyside)
 
** [http://www.python.org/ftp/python/2.7/python-2.7-macosx10.5.dmg Python 2.7] ''[python.org]''
* [http://developer.apple.com/technologies/tools/xcode.html Xcode - Developer Tools] Follow the instructions on the site to install
* CMake >= 2.6.0 (OBS: cmake 2.8.2 does not work for me with python2.7)  
** [http://www.cmake.org/files/v2.6/cmake-2.6.4-Darwin-universal.dmg CMake 2.6.4]
* Qt libraries and development headers >= 4.6 (preferably the latest stable release)
** [http://download.qt.io/official_releases/qt/4.8/4.8.7/qt-opensource-mac-4.8.7.dmg Qt 4.8.7]
* Python libraries and development headers >= 2.5 (for shiboken and pyside)
** [http://www.python.org/ftp/python/2.7/python-2.7-macosx10.5.dmg Python 2.7]
* Optional
* Optional
** Git (necessary to get the source code)
** Git (necessary to get the source code)
*** [http://git-osx-installer.googlecode.com/files/git-1.7.3.1-intel-leopard.dmg Git 1.7] ''[git-osx-installer.googlecode.com]''
*** [http://git-osx-installer.googlecode.com/files/git-1.7.3.1-intel-leopard.dmg Git 1.7]
** (Documentation) libxml2 and development headers &gt;= 2.6.32 (for apiextractor only)
** (Documentation) libxml2 and development headers >= 2.6.32 (for apiextractor only)
** (Documentation) libxslt and development headers &gt;= 1.1.19 (for apiextractor only)
** (Documentation) libxslt and development headers >= 1.1.19 (for apiextractor only)


==Building and installing==
== Building and installing ==


To build the components, follow the instructions in [[PySide CMake Primer|PySide_CMake_Primer]] for every source code package (apiextractor, generatorrunner, shiboken, pyside).
To build the components, follow the instructions in [[PySide_CMake_Primer]] for every source code package (apiextractor, generatorrunner, shiboken, pyside).


In the most basic case (building with default options, installing into the /usr/local tree), running the following commands in each directory should be sufficient:
In the most basic case (building with default options, installing into the /usr/local tree), running the following commands in each directory should be sufficient:


Remember:<br /> If you are installing the libs in a non default system dir you need specify this new location using the var ‘<span class="caps">DYLD</span>_LIBRARY_PATH’:
<code>
mkdir build
cd build
cmake ..
make
sudo make install
</code>


===Some flags you can use on cmake command===
Remember:
If you are installing the libs in a non default system dir you need specify this new location using the var 'DYLD_LIBRARY_PATH':


* -<span class="caps">DCMAKE</span>_BUILD_TYPE=[Release|Debug]<br /> This can be used to specify which kind of library do you want, if you are only using PySide use Release
<code>
export DYLD_LIBRARY_PATH=~/work/install/lib
</code>


* -<span class="caps">DCMAKE</span>_INSTALL_PREFIX=[Prefix]<br /> Used to specify a different install directory (Remember to export <span class="caps">DYLD</span>_LIBRARY_PATH to the same location)
=== Some flags you can use on cmake command ===


* -<span class="caps">DALTERNATIVE</span>_QT_INCLUDE_DIR=[Qt Include dir] (I use: /Library/Frameworks/)<br /> In cmake 2.6 version there is a problem with QT_INCLUDE_DIR exported on OS X then is recommended use this flag with ‘/Library/Frameworks/’ to avoid generation problems.
* -DCMAKE_BUILD_TYPE=[Release|Debug]
This can be used to specify which kind of library do you want, if you are only using PySide use Release


* -<span class="caps">DSITE</span>_PACKAGE=[Site packages dir] (i.e., /Library/Python/2.6/site-packages)<br /> Use this flag to specify the Python site-packages directory where ‘make install’ will install the packages.
* -DCMAKE_INSTALL_PREFIX=[Prefix]
Used to specify a different install directory (Remember to export DYLD_LIBRARY_PATH to the same location)


===Categories:===
* -DALTERNATIVE_QT_INCLUDE_DIR=[Qt Include dir] (I use: /Library/Frameworks/)
In cmake 2.6 version there is a problem with QT_INCLUDE_DIR exported on OS X then is recommended use this flag with '/Library/Frameworks/' to avoid generation problems.


* [[:Category:LanguageBindings|LanguageBindings]]
* -DSITE_PACKAGE=[Site packages dir] (i.e., /Library/Python/2.6/site-packages)
** [[:Category:LanguageBindings::PySide|PySide]]
Use this flag to specify the Python site-packages directory where 'make install' will install the packages.

Latest revision as of 10:34, 24 February 2022

Attention
This is a page dedicated to PySide (Qt4). For recent development on PySide2 (Qt5) and PySide6 (Qt6) refer to Qt for Python

English French


PySide uses the CMake build system to build the source code packages. If you are not familiar with CMake, have a look at our PySide_CMake_Primer before going further.

Getting the source code

The latest source code tarballs for the PySide components can be acquired from PySideDownloads. Alternatively, if you are interested in the latest and greatest, you might want to clone our code.qt.io repository.

Prerequisites

  • Xcode - Developer Tools Follow the instructions on the site to install
  • CMake >= 2.6.0 (OBS: cmake 2.8.2 does not work for me with python2.7)
  • Qt libraries and development headers >= 4.6 (preferably the latest stable release)
  • Python libraries and development headers >= 2.5 (for shiboken and pyside)
  • Optional
    • Git (necessary to get the source code)
    • (Documentation) libxml2 and development headers >= 2.6.32 (for apiextractor only)
    • (Documentation) libxslt and development headers >= 1.1.19 (for apiextractor only)

Building and installing

To build the components, follow the instructions in PySide_CMake_Primer for every source code package (apiextractor, generatorrunner, shiboken, pyside).

In the most basic case (building with default options, installing into the /usr/local tree), running the following commands in each directory should be sufficient:

mkdir build
cd build
cmake ..
make
sudo make install

Remember: If you are installing the libs in a non default system dir you need specify this new location using the var 'DYLD_LIBRARY_PATH':

export DYLD_LIBRARY_PATH=~/work/install/lib

Some flags you can use on cmake command

  • -DCMAKE_BUILD_TYPE=[Release|Debug]

This can be used to specify which kind of library do you want, if you are only using PySide use Release

  • -DCMAKE_INSTALL_PREFIX=[Prefix]

Used to specify a different install directory (Remember to export DYLD_LIBRARY_PATH to the same location)

  • -DALTERNATIVE_QT_INCLUDE_DIR=[Qt Include dir] (I use: /Library/Frameworks/)

In cmake 2.6 version there is a problem with QT_INCLUDE_DIR exported on OS X then is recommended use this flag with '/Library/Frameworks/' to avoid generation problems.

  • -DSITE_PACKAGE=[Site packages dir] (i.e., /Library/Python/2.6/site-packages)

Use this flag to specify the Python site-packages directory where 'make install' will install the packages.