INTRODUCTION

This document will guide you through the complete process necessary to create a Privoxy installer package (hereafter 'package') for any OS X version, starting from the Privoxy source code.


ASSUMPTIONS

1. That the read-only Privoxy CVS project has been downloaded from Sourceforge, pinned at whichever release you intend to build.
2. That you have Xcode installed, including the SDKs for each OS X version you intend your package(s) to support.
3. That your build machine runs Snow Leopard (OS X 10.6). It will likely work equally well on Leopard or Lion (or later), but PackageMaker is substantially different in Tiger and earlier versions of OS X (even the project file format is different).
4. All references to files and folders in this document should be assumed to be within the OSXBuildSystem folder unless stated otherwise.


OVERVIEW OF STEPS

1. Build the privoxy binary
2. Construct the package contents hierarchy
3. Build the package


DETAILS

1. Build the privoxy binary

Use privoxy-create.sh (run via sudo) to create the privoxy group and user; these are a prerequisite for the build process.

Use build.sh to build a privoxy binary for the desired (range of) platform(s). The recommended usage is:

./build.sh leopardupwards

which will build a Universal binary containing targets for PPC, i386 and x86_64 processor architectures that'll run on all Macintosh OS X versions from 10.5 (Leopard) and upwards.


2. Construct the package contents hierarchy

Use constructPkgContent.sh to build the hierarchy of folders and files necessary for building the package. This will construct a new folder named 'pkg content' and copy in the binary, documentation and supporting files.

Once this is done, the following files will need to be edited:

pkg content/Applications/Privoxy/uninstall.command
- the two lines that delete the package installation receipt need correcting for the Privoxy version being built

pkg resources/interface texts/ReadMe.txt
- this can be distilled from the README for the latest Privoxy project release


3. Build the package

Open OSX 10.5+.pmdoc in PackageMaker (OSX 10.4.pmdoc is supplied for Tiger since a different package format is required there). See the separate document "Packagemaker Instructions.txt" if you wish to create a package from scratch; otherwsie only the following list of entries will need to be changed to match the Privoxy version you're working with:

Distribution left-menu item>Configuration>Title
pkg content left-menu item>pkg content>Configuration>Package Identifier

You will then need to navigate to the following pane:

pkg content left-menu item>pkg content>Scripts

and drag and drop 'pkg resources/single-binary scripts' into the 'Scripts directory' entry box. This MUST be left as an 'absolute' path due to a bug in PackageMaker; if you select 'relative to project' then the scripts will not be found nor added to the package at build time.

Finally click the 'Build' button at screen top-left. The package filename is up to you but I recommend "Privoxy <version>.pkg", e.g. "Privoxy 3.0.19.pkg". For the down-level release I have used "Privoxy <version> OS X 10.4.mpkg"