ASSUMPTIONS
-1. That the read-only Privoxy CVS project has been downloaded from Sourceforge, pinned at whichever release you intend to build.
+1. That the Privoxy CVS project has been exported from Sourceforge to a folder named 'dist', pinned at whichever release you intend to build (as per the instructions in the developer manual).
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.
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
+Once this is done, the following file will need to be edited:
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:
+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; otherwise only the following list of entries will need to be changed to match the Privoxy version you're working with (see Packagemaker Instructions.txt for more details about restrictions on the values you can set):
Distribution left-menu item>Configuration>Title
pkg content left-menu item>pkg content>Configuration>Package Identifier
Destination is /
No custom location
-The Package Identifier should be in the form: 'org.ijbswa.privoxy3019.pkg'. This value also needs to be plugged into the uninstall.command script since I have not yet worked out how to do that programmatically from one of the pre/postinstall scripts.
+The Package Identifier _MUST_ be in the form: 'org.ijbswa.privoxyX.Y.ZZ.pkg' where X.Y.ZZ is the release version (e.g. 3.0.19). This is important since the uninstall.command script is populated with this name by a separate process.
Package Version is irrelevant.
Restart Action: None
Require admin authentication should be ticked.
echo ""
cp -vR pkg\ content\ skeleton pkg\ content
+# Replace the version number placeholders in the uninstallation script
+echo ""
+echo "Replace the version number placeholders in the uninstallation script"
+echo ""
+VERSION=`perl findversion.pl ../current/ChangeLog`
+sed "s/PRIVOXY_VERSION/${VERSION}/g" pkg\ content\ skeleton/Applications/Privoxy/uninstall.command > pkg\ content/Applications/Privoxy/uninstall.command
+
# Copy the compiled privoxy binary from the 'current' project
echo ""
echo ""
# Delete all items referenced by the installation package
echo 'Delete package installation receipt (ignore errors relating to other bundle identifiers).'
- # TODO overwrite PKGNAME during postinstall execution with the name of the package being installed.
- # In the meantime, the package name must be manually entered for each release.
- #pkgutil --forget PKGNAME
- # if OS X 10.5 or newer then use the new pkgutil command else simply delete the receipt file
+ # On OS X 10.5 or newer we can use the new pkgutil command else simply delete the receipt file
if [ -x /usr/sbin/pkgutil ]; then
- pkgutil --forget org.ijbswa.privoxy3019.pkg
+ pkgutil --forget org.ijbswa.privoxyPRIVOXY_VERSION.pkg
else
- rm -rf /Library/Receipts/Privoxy\ 3.0.19\ OS\ X\ 10.4.pkg
+ rm -rf /Library/Receipts/Privoxy\ PRIVOXY_VERSION\ OS\ X\ 10.4.pkg
fi
# Check the Trash, just in case the user manually removed the only obvious item from /Applications