This section explains how to build PySide in Windows, Linux, and Macintosh operating systems.
Before starting to build PySide on Windows, ensure that the following prerequisites are installed:
- Visual Studio Express 2008 (Python 2.6, 2.7, or 3.2) / Visual Studio Express 2010 (Python 3.3). Find results from http://www.microsoft.com/visualstudio/eng/products/visual-studio-express-products.
- Qt 4.8 libraries for Windows from http://releases.qt-project.org/qt4/source/qt-win-opensource-4.8.4-vs2008.exe.
- CMake from http://www.cmake.org/cmake/resources/software.html.
- Git from http://git-scm.com/download/win.
- Python 2.6, 2.7, 3.2, or 3.3 from http://www.python.org/download/.
- OpenSSL from http://slproweb.com/products/Win32OpenSSL.html (Optional).
Make sure that Git and CMake executable is set in your system PATH. Now, follow these steps to start building PySide:
- Git clone the PySide repository from Github:
c:/> git clone https://github.com/PySide/pyside-setup.git pyside-setup - Change your working directory to "pyside-setup":
c:/> cd pyside-setup - Build the installer:
c:> c:Python27python.exe setup.py bdist_wininst --msvc-version=9.0 --make=c:Qt4.8.4inqmake.exe --openssl=c:OpenSSL32bitin - Upon successful installation, the binaries can be found in the sub-folder "dist":
c:pyside-setupdist
On completion of these steps, the PySide should have been successfully built on your system.
To build PySide on Linux, the following prerequisites must be available. Check if you have them already or download them using the following links.
- CMake >= 2.6.0: http://www.cmake.org/cmake/resources/software.html
- Qt libraries and development headers >= 4.6: http://origin.releases.qt-project.org/qt4/source/qt-everywhere-opensource-src-4.8.4.tar.gz
- libxml2 and development headers >= 2.6.32: http://www.xmlsoft.org/downloads.html
- libxslt and development headers >= 1.1.19: http://xmlsoft.org/XSLT/downloads.html
- Python libraries and development headers >= 2.5: http://www.python.org/download/
PySide is a collection of four interdependent packages API Extractor, Generator Runner, Shiboken Generator, and Pyside Qt bindings. In order to build PySide, you have to download and install the packages mentioned previously in that order.
- API Extractor: A set of libraries used by the bindings generator to parse the header and typesystem files to create an internal representation of the API. [https://distfiles.macports.org/apiextractor/]
- Generator Runner: Program that controls the bindings generation process according to the rules given by the user through headers, typesystem files, and generator frontends. It is dependent on the API Extractor. [https://distfiles.macports.org/generatorrunner/]
- Shiboken Generator: Plugin that creates the PySide bindings source files from Qt headers and auxiliary files (typesystems, global.h, and glue files). It is dependent on Generator Runner and API Extractor. [https://distfiles.macports.org/py-shiboken/]
- PySide Qt Bindings: Set of typesystem definitions and glue code that allows generations or a generation of Python Qt binding modules using the PySide tool chain. It is dependent on Shiboken and Generator Runner. [http://download.qt-project.org/official_releases/pyside/]
Always make sure that you are downloading the packages mentioned previously and building them in the same order as mentioned, since each of the packages are interdependent. Follow these steps to build the packages:
- Unzip the downloaded packages and change into the package directory:
tar –xvf <package_name> cd <package_directory>
- Create a build directory under the package directory and enter that directory:
mkdir build && cd build - Make the build using CMake:
cmake .. && make - On successful make, build and install the package:
sudo make install - Note that you require sudo permissions to install the packages.
- To update the runtime linker cache, issue the following command:
sudo ldconfig
Once you follow these steps in order for each of the packages, the PySide should have been successfully built on your system.