+++ /dev/null
-#!/bin/sh
-
-# File : constructPkgContent.sh
-#
-# Purpose : Create the hierarchy of folders and files that will
-# comprise the installation package and zip them.
-#
-# Copyright : Written by and Copyright (C) 2001-2013 the
-# Privoxy team. http://www.privoxy.org/
-#
-# This program is free software; you can redistribute it
-# and/or modify it under the terms of the GNU General
-# Public License as published by the Free Software
-# Foundation; either version 2 of the License, or (at
-# your option) any later version.
-#
-# This program is distributed in the hope that it will
-# be useful, but WITHOUT ANY WARRANTY; without even the
-# implied warranty of MERCHANTABILITY or FITNESS FOR A
-# PARTICULAR PURPOSE. See the GNU General Public
-# License for more details.
-#
-# The GNU General Public License should be included with
-# this file. If not, you can view it at
-# http://www.gnu.org/copyleft/gpl.html
-# or write to the Free Software Foundation, Inc.,
-# 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301,
-# USA
-#
-# Modification : If you modify this file please consider whether your
-# changes ought to be passed back to the iOSPackageBuilder
-# module.
-#
-
-# Use the common script to locate the directory containing Privoxy's source ($SOURCEDIR)
-. ./common.sh
-
-# Remove existing 'pkg content' folder if found
-echo ""
-echo "Remove existing 'pkg content' folder if found"
-rm -rf pkg\ content
-
-# Copy the package skeleton (the unchanging content) to a new folder named 'pkg content'
-echo ""
-echo "Copy the package skeleton (the unchanging content) to a new folder named 'pkg content'"
-echo ""
-cp -vR pkg\ content\ skeleton pkg\ content
-
-# Copy the compiled privoxy binary from the '${SOURCE_DIR}' directory
-echo ""
-echo ""
-echo "Copy the compiled privoxy binary from the '${SOURCE_DIR}' directory"
-echo ""
-cp -v ../${SOURCE_DIR}/privoxy pkg\ content/usr/local/sbin
-
-# Copy the configuration hierarchy from the '${SOURCE_DIR}' directory
-echo ""
-echo ""
-echo "Copy most of the configuration hierarchy from the '${SOURCE_DIR}' directory"
-echo ""
-for i in default.action default.filter match-all.action trust user.action user.filter templates; do
- if [ "$i" = "templates" ]; then
- # for the templates subfolder copy all files therein
- cp -vR ../${SOURCE_DIR}/$i pkg\ content/usr/local/etc/privoxy/$i
- else
- # for all regular files just copy them across
- cp -v ../${SOURCE_DIR}/$i pkg\ content/usr/local/etc/privoxy/$i
- fi
-done
-
-# Enter the correct values for confdir, logdir and enable-edit-actions into the config file
-echo ""
-echo ""
-echo "Copy the config file from the '${SOURCE_DIR}' directory, modifying confdir, logdir and enable-edit-actions in passing"
-echo ""
-sed 's/confdir ./confdir \/usr\/local\/etc\/privoxy/g' ../${SOURCE_DIR}/config > pkg\ content/usr/local/etc/privoxy/config_temp
-sed 's/logdir ./logdir \/var\/log\/privoxy/g' pkg\ content/usr/local/etc/privoxy/config_temp > pkg\ content/usr/local/etc/privoxy/config_temp2
-sed 's/enable-edit-actions 0/enable-edit-actions 1/g' pkg\ content/usr/local/etc/privoxy/config_temp2 > pkg\ content/usr/local/etc/privoxy/config
-rm -f pkg\ content/usr/local/etc/privoxy/config_temp
-rm -f pkg\ content/usr/local/etc/privoxy/config_temp2
-
-# Copy the documentation hierarchy from the '${SOURCE_DIR}' directory
-echo ""
-echo ""
-echo "Copy the documentation hierarchy from the '${SOURCE_DIR}' directory"
-echo ""
-# copy the required directory hierarchies
-for i in developer-manual faq images man-page team user-manual; do
- cp -vR ../${SOURCE_DIR}/doc/webserver/$i pkg\ content/usr/local/share/doc/privoxy/$i
-done
-# copy the top-level files
-for i in announce.txt p_doc.css privoxy-index.html; do
- cp -v ../${SOURCE_DIR}/doc/webserver/$i pkg\ content/usr/local/share/doc/privoxy/$i
-done
-# copy the project's AUTHORS, ChangeLog, LICENSE and README files
-for i in AUTHORS ChangeLog LICENSE README; do
- cp -v ../${SOURCE_DIR}/$i pkg\ content/usr/local/share/doc/privoxy/$i
-done
-
-# Copy the manpage from the '${SOURCE_DIR}' directory
-echo ""
-echo ""
-echo "Copy the manpage from the '${SOURCE_DIR}' directory"
-echo ""
-cp -v ../${SOURCE_DIR}/privoxy.1 pkg\ content/usr/local/share/man/man1
-
-# Optionally copy the PCRE libraries
-if [ "$1" == "-pcre" ]; then
- echo ""
- echo ""
- echo "Copy the external PCRE libraries"
- echo ""
- mkdir pkg\ content/usr/local/lib
- cp -v /usr/local/lib/libpcre* pkg\ content/usr/local/lib
- mkdir pkg\ content/usr/local/lib/pkgconfig
- cp -v /usr/local/lib/pkgconfig/libpcre* pkg\ content/usr/local/lib/pkgconfig
-fi
-
-# Remove CVS administration files
-echo ""
-echo ""
-echo "Remove CVS administration files"
-echo ""
-find pkg\ content -name CVS.sandboxinfo -exec rm -rf {} \;
-find pkg\ content -name CVS -exec rm -rf {} \;
-
-# Build zip file
-cd pkg\ content
-zip -r org.ijbswa.privoxy.zip *
-cd ..
+++ /dev/null
-INTRODUCTION
-
-This document will guide you through the complete process necessary to create a Privoxy zip package (hereafter 'package') for iOS, starting from the Privoxy source code. This package can then be sent to the maintainer of the chosen Cydia repository for processing and hosting.
-
-
-ASSUMPTIONS
-
-1. That the Privoxy CVS project is available in a folder parallel to the one containing this file. If building for release it should have 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), you might have simply checked out the head of the CVS project to a folder named 'current'. If you are using a folder name other than these two you will be prompted to enter it.
-2. That you have Xcode installed, including the SDKs for the minimum iOS 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 iOSBuildSystem folder unless stated otherwise.
-
-
-OVERVIEW OF STEPS
-
-1. Build the privoxy binary
-1.1 Consider whether to use external or bundled PCRE.
-2. Construct the package contents zip file
-3. How to install manually
-
-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 minimum platform. For example:
-
-./build.sh 4.3
-
-will build an ARM binary that'll run on all iOS devices running iOS 4.3 and upwards.
-
-Running build.sh without supplying any parameters will cause it to list all the possible options.
-
-1.1 Consider whether to use external or bundled PCRE.
-
-Privoxy uses the Perl Compatible Regular Expressions (PCRE) library when matching its rules against the folder-and-file part of a target URL. Privoxy ships with a bundled PCRE library that, whilst convenient, is very out of date. The recommendation is therefore to download, make and install the latest PCRE distribution to your build machine and compile Privoxy against that instead.
-
-build.sh takes an optional second parameter (-pcre) which tells it to look for an installation of the PCRE library in the standard location on the build machine.
-
-
-2. Construct the package contents hierarchy
-
-Use constructZip.sh to build the hierarchy of folders and files and zip them into the destination zip file - org.ijbswa.privoxy.zip. This will construct a new folder named 'pkg content' and copy in the binary, documentation and supporting files. If you are bundling an external PCRE fileset, use the optional switch -pcre to instruct constructPkgContent.sh to include those files.
-
-
-3. How to install manually
-
-Privoxy can only be installed and run on a jailbroken iDevice.
-
-- Copy the zip file from 'pkg content' into the root directory on the iDevice. This can be achieved in many ways; I used the NetATalk Cydia package that installs the AFP file protocol on the iDevice which allows one to connect to it as a shared drive.
-- unzip org.ijbswa.privoxy.zip
-- change into the newly-created DEBIAN subfolder
-- chmod the scripts to make them executable
-- run ./preinstall
-- run ./postinstall
-- In Settings->WiFi->[your network name]->HTTP Proxy enter 127.0.0.1 for the server and 8118 for the port
-
-From now on, all HTTP communications whilst on the WiFi network will pass via Privoxy's filtering.
\ No newline at end of file
projects / OSXPackageBuilder.git / commitdiff