Introduction to Jar Bundler User Guide

This document covers the packaging of existing Java applications into Mac app bundles using Jar Bundler.

Who Should Read This Document

You should read this document if you have working Java 1.3.1, Java 1.4.2, and J2SE 5.0 applications that you want to deploy as Mac apps. That is, you want your application’s users to double-click an application package with a nice-looking icon instead of a JAR file with a generic JAR-file icon.

This document is intended for developers as well as regular users. For example, you may be a developer that has several Java applications happily running on several platforms. However, you might want OS X users to enjoy using your applications with the niceties their platform of choice provides, such as the easy-to-use Macintosh menu bar, and straightforward application installation and uninstallation. Or you may be a regular OS X user who wants to take advantage of the myriad of Java-based applications available but want to package them so that you can manage them better.

Or you may be both. Whatever the case is, this document shows you how to group several files containing Java code, and C code in the form of Java Native Interface (JNI) libraries, into a self-contained application package. You also learn how to change the application’s normal behavior so that it provides a familiar interface to OS X users.

Organization of This Document

This document has the following chapters:

This document also contains a revision history.

See Also

There are companion files intended to be used while reading this document. You find them in /Developer/ADC Reference Library/documentation/Java/Conceptual/Jar_Bundler/Jar_Bundler_companion.dmg. That volume is called Jar_Bundler_companion in the remainder of this document. You can also download the companion files from

For detailed information on application packaging, see Bundle Programming Guide and Framework Programming Guide.

For information on Java development in OS X, visit

This product includes software developed by the SpeedLegal Group for use in the Xerlin XML Editor and software developed by ChannelPoint, Inc. for use in the Merlot XML Editor

The Xerlin XML Editor is Copyright © 2002 SpeedLegal Holdings, Inc. and other contributors. It includes software developed for the Merlot XML Editor which is Copyright © 1999-2000 ChannelPoint, Inc. All rights reserved.