Code: Select all
This document describes building the Mac OS X version of Scan Tailor.
This requires that you have installed Apple's developer tools. These are
an optional install on the installation disks that come with your computer,
or can be downloaded (free registration may be required) Apple's web site
at http://developer.apple.com/mac
Downloading Prerequisites
First, download the following software. Unless stated otherwise, take the
latest stable version.
1. CMake 2.8.x (tested with 2.8.2)
Homepage: http://www.cmake.org
I recommend just downloading the binary installer so you can just download,
click, have it all installed and ready to go. Be sure to have it install
the command-line utilities.
2. Qt4 - Tested with Qt4.7.3 - some odd problems when using 4.6 stable
Homepage: http://qt.nokia.com
From there: Download -> LGPL / Free -> Download Qt Carbon for Mac OS X
I recommend just downloading the binary installer for Carbon. Since we are
building with dependencies for Tiger (10.4) and forward, we cannot build
a fully 64-bit executable anyway. The Qt Carbon build is ppc/i386 only.
3. jpeg-8b
Homepage: http://www.ijg.org/
The file we need will be named jpegsrc.v8b.tar.gz or similarly.
4. libpng (tested with v1.4.3)
Homepage: http://www.libpng.org/pub/png/libpng.html
We need a file named like libpng-x.x.x.tar.gz, where x.x.x represents
the version number.
5. libtiff (tested with 3.9.4)
Homepage: http://www.remotesensing.org/libtiff/
The file should be named like tiff-3.9.4.tar.gz
6. Boost (tested with 1.43.0)
Homepage: http://boost.org/
For Boost, I recommend the file named like boost_1_43_0.tar.gz.
Instructions
1. Create a build directory. Its full path should have no spaces. This can be
in your home directory or even on your desktop.
2. Unpack jpeg-8b, libpng, libtiff, boost, and scantailor itself to this
build directory. You should get a directory structure like
this:
build
| boost_1_43_0
| jpeg-8b
| libpng-1.4.3
| scantailor-0.9.9
| tiff-3.9.4
3. Two more subdirectories will be created there:
| scantailor-build
| scantailor-deps-build
4. Install Qt
5. Install CMake.
6. You can either locate the "buildscantailor.sh" file in the Finder
(It is in scantailor/packaging/osx/ in the folder you created above)
and right-click (or control-click) on it to "Open With...." Terminal.app,
or you can open Terminal.app directly and run it from there.
This will build all required dependencies and scantailor itself. It will
only rebuild the parts needed each time, so once a particular piece is
built you will not have to wait for it to be built again.
Make sure the building process finishes without errors. Warnings may
be ignored.
If everything went right, the application exists in the scantailor-build
folder named ScanTailor.app with a distributable disk image in the same
folder named ScanTailor-VERSION.dmg. The VERSION part of the name will
be replaced by the actual version, taken from a file called "VERSION" in
the root of the source directory.