Download the JDK
Search the Tutorials
Hide the TOC
Trail: Deployment
Lesson: Packaging Programs in JAR Files
Section: Working with Manifest Files: The Basics
Packaging Programs in JAR Files
Using JAR Files: The Basics
Creating a JAR File
Viewing the Contents of a JAR File
Extracting the Contents of a JAR File
Updating a JAR File
Running JAR-Packaged Software
Working with Manifest Files: The Basics
Understanding the Default Manifest
Modifying a Manifest File
Setting an Application's Entry Point
Adding Classes to the JAR File's Classpath
Setting Package Version Information
Sealing Packages within a JAR File
Signing and Verifying JAR Files
Understanding Signing and Verification
Signing JAR Files
Verifying Signed JAR Files
Using JAR-related APIs
The JarClassLoader Class
The JarRunner Class
Home Page > Deployment > Packaging Programs in JAR Files
« Previous • Trail • Next »
Setting Package Version Information

> You may need to include package version information in a JAR file's manifest. You provide this information with the following headers in the manifest:

> Headers in a manifest
> Header | Definition
> --- | ---
> `Name` | The name of the specification.
> `Specification-Title` | The title of the specification.
> `Specification-Version` | The version of the specification.
> `Specification-Vendor` | The vendor of the specification.
> `Implementation-Title` | The title of the implementation.
> `Implementation-Version` | The build number of the implementation.
> `Implementation-Vendor` | The vendor of the implementation.

> One set of such headers can be assigned to each package. The versioning headers should appear directly beneath the `Name` header for the package. This example shows all the versioning headers:

> >     Name: java/util/
> >     Specification-Title: Java Utility Classes
> >     Specification-Version: 1.2
> >     Specification-Vendor: Sun Microsystems, Inc.
> >     Implementation-Title: java.util
> >     Implementation-Version: build57
> >     Implementation-Vendor: Sun Microsystems, Inc.

> For more information about package version headers, see the Package Versioning specification .

### An Example

> We want to include the headers in the example above in the manifest of MyJar.jar.

> We first create a text file named `Manifest.txt` with the following contents:

> >     Name: java/util/
> >     Specification-Title: Java Utility Classes
> >     Specification-Version: 1.2
> >     Specification-Vendor: Sun Microsystems, Inc.
> >     Implementation-Title: java.util
> >     Implementation-Version: build57
> >     Implementation-Vendor: Sun Microsystems, Inc.

> > Warning : The text file must end with a new line or carriage return. The last line will not be parsed properly if it does not end with a new line or carriage return.

> We then create a JAR file named `MyJar.jar` by entering the following command:

> >     jar cmf MyJar.jar Manifest.txt MyPackage/*.class

> This creates the JAR file with a manifest with the following contents:

> >     Manifest-Version: 1.0
> >     Created-By: 1.6.0 (Sun Microsystems Inc.)
> >     Name: java/util/
> >     Specification-Title: Java Utility Classes
> >     Specification-Version: 1.2
> >     Specification-Vendor: Sun Microsystems, Inc.
> >     Implementation-Title: java.util
> >     Implementation-Version: build57
> >     Implementation-Vendor: Sun Microsystems, Inc.

« Previous • Trail • Next »
Previous page: Adding Classes to the JAR File's Classpath
Next page: Sealing Packages within a JAR File