Pillow/docs/build.rst
2014-03-21 16:52:05 -07:00

84 lines
2.5 KiB
ReStructuredText

Building Pillow on Windows
==========================
.. note:: For most people, the :doc:`installation instructions
<installation>` should be sufficient
This page will describe a build setup to build Pillow against the
supported python versions in 32 and 64 bit modes, using freely
availble Microsoft compilers. This has been developed and tested
against a bare Windows Server 2012 64bit RTM version on Amazon EC2.
Prerequsites
------------
Extra Build Helpers
^^^^^^^^^^^^^^^^^^^
* Google Chrome (optional - for sanity)
* GPG (for checking signatures) (UNDONE -- python signature checking)
* Powershell (available by default on Windows Server)
* Github client (provides git+bash shell)
Pythons
^^^^^^^
Download and install Python 2.6, 2.7, 3.2, 3.3, and 3.4, both 32 and
64 bit versions. There is a python script that will download the
installers in `winbuild/get_pythons.py`. It requires python to run, so
download and install one of them first.
::
for version in ['2.6.5', '2.7.6', '3.2.5', '3.3.5', '3.4.0']:
http://legacy.python.org/ftp/python/%s/python-%s['','.amd64'].msi['','.asc']
UNDONE -- gpg verify the signatures
We also need virtualenv and setuptools in at least one of the pythons
to build testing versions.
Compilers
^^^^^^^^^
Download and install:
* `Microsoft Windows SDK for Windows 7 and .NET Framework 3.5
SP1 <http://www.microsoft.com/en-us/download/details.aspx?id=3138>`_
* `Microsoft Windows SDK for Windows 7 and .NET Framework
4 <http://www.microsoft.com/en-us/download/details.aspx?id=8279>`_
* `CMake-2.8.10.2-win32-x86.exe <http://www.cmake.org/cmake/resources/software.html>`_
The samples and the .NET SDK portions aren't required, just the
compilers and other tools. UNDONE -- check exact wording.
Dependencies
------------
Run `winbuild/build_dep.cmd` in a command window. There are times when
the output clears the terminal, so it's best to run it in the
Powershell IDE, which has a more powerful terminal than the standard
Powershell window.
This will download libjpeg, libtiff, libz, and freetype. It will then
compile 32 and 64 bit versions of the libraries, with both versions of
the compilers.
UNDONE -- lcms fails.
UNDONE -- webp not included yet.
Testing Builds
--------------
Use the script UNDONE to build, install, selftest, and test Pillow in
virtualenvs for each Python that is installed.
Installer Builds
----------------
Run `winbuild/build.cmd` in a powershell terminal to build Pillow
installers against each of the Pythons.