Overview

Mac-Package is a plugin for Apache Ant and Apache Maven that allows you to package native Mac OS X applications from your Java source code. Similar to the Maven "uberjar" goal, it will take all of your program resources and dependencies and place them into an archive. Unlike uberjar, this archive is a native OS X application bundle, complete with custom icon, version strings, VM options, and an assortment of other custom properties.

Once installed, it gives you the Ant task "macPackage" and the Maven goal "mac-package". This plugin is written in Java (using Jelly scripting as a wrapper for Maven), does not require any more Java dependencies than Ant or Maven already needs, but does require the Apple Developer Kit to be installed.

A sample "Hello World" application, complete with Ant and Maven build scripts is included. The testing document will show you how to build and run this sample app.

Using the Mac-Package Plug-in

For more information on the functionality provided by this Maven plugin, please see the Goals document.

For more information on how to customize the functionality provided by this Maven plugin, please see the properties document.

To see how to incorporate this plugin in your Ant project, please see the ant document.

Installing the Mac-Package Plug-in

To install the Mac-Package plugin into Apache Ant or Apache Maven, see the installation document.

Most people will not need to build the Mac-Package plugin, strictly developers who want to contribute to its functionality or robustness. If you would like to help contribute (or just see what Mac-Package looks like on the inside), you may want to look at the build documentation.