DescriptionJpkg is both a library and a set of Apache Ant tasks for building operating system packages.

FeaturesCurrently the Debian .deb format is supported. Detailed validation of package fields to be conformant with the Debian package specification for the package features supported by Jpkg. Not all Debian package features are supported, only those necessary to generate useful packages. Supports custom package maintainer scripts, backed by Velocity templates. Contains a library called Antidote, which is an attempt to make certain aspects of writing Ant tasks easier, especially dealing with the mutable state of Ant objects and validation of Ant supplied data. Also included is a Java library for working with Unix ar(1) archives. Includes extensive unit tests. UsageBasic pattern for including the Ant task in your build:

Most of the common fields are shown in this example. See the full Ant task schema for more details.

packagename
        1.2
        i386
        Package description

Package Maintainer
            maintainer@package.com

optional
        misc

bin/

1.4

12.1a

Distribution FilesContained within jpkg-bin.zip: jpkg-combined.jar - The Jpkg library and ant tasks as well as all dependencies. antidote.jar - The Antidote library. jpkg-ant.jar - The Jpkg Ant tasks. Depends on the Jpkg library. jpkg-lib.jar - The Jpkg library. Also distributed: jpkg-src.zip - The source bundle, includes javadocs. DependenciesFor both the library and ant tasks:

mail-1.4.1.jar commons-io-1.3.2.jar

For the library:

commons-codec-1.3.jar

For the Ant tasks for velocity:

commons-collections-3.2.jar velocity-1.5-dev.jar uudecode is a requirement when executing the maintainer scripts on the target machine.

For the Antidote library:

The Ant runtime.

Custom Maintainer ScriptsSee com/threerings/jpkg/ant/dpkg/scripts/standard/HelloWorld.java for an example. If you create any custom TemplateScript classes you will need to do something like the following.

Example custom-scripts.xml:

Pattern for including the Ant task in your build with custom TemplateScript classes:

Release NotesVersion 1.5 - Documentation improvements. Version 1.4 - Allow maintainer scripts to optionally fail quietly. Version 1.3 - Improve script_runner error handling. Version 1.2 - Make the recursive property of the field optional and default to false. Version 1.1 - Fix bug in applying recursive permissions. Version 1.0 - Initial release. AuthorJpkg was written by Jonathan Le Plastrier, based on an original Python implementation by Landon Fuller. It is copyright Three Rings Design and is released under a BSD license.