Using the Packaging Utility:

The SDK for Java* includes the Intel AppUp™ Software Packaging Utility that integrates and packages the required jar files and application manifest into a single jar file prior to submitting the file to the Intel AppUp^SM Developer Program portal.

The jar file produced by the Packaging Utility meets the requirements of the Intel AppUp™ Runnable Jar File Specification.

The AppUp SDK is optional and not required. However, if the application does integrate the SDK, it must function correctly to pass validation.

This output jar file contains the following:

• Application jar files for the project
• Intel AppUp™ SDK jar file
• Other required jar files, such as 3rd party jar files, DLLs, etc.
• Application Manifest

Step 1: Launch the Packaging Utility

Click Start->All Programs->Intel AppUp™ Software Development Kit->Java*->Intel AppUp(TM) Software Packaging Utility for Java* software to launch the utility. You can also double-click on the adp_packager.jar file in the SDK directory. The Packaging Utility launches and displays the welcome screen shown below. Click Next to move the Set Application Information screen.

Step 2: Set Application Information

Fill in the Publisher information and supply the main application jar filename. Click the upper Browse button and browse to select the main jar file. Use the Add button to browse to and select the following file:

• appup_sdk_java_v1.1.jar

Continue using the Add button to browse to and add any other files to be included in the final jar file. To remove a file from the list, select the file and click the Remove button. Click the lower Browse button and browse to select the location and filename for the output file. When finished, click Next to move to the Set Runtime Environment screen.

Step 3: Set Runtime Environment

Specify any Program Arguments (if needed) for the application invocation.

1. Arguments must be separated by spaces.
2. Characters such as a comma or a colon are treated as part of the argument they are next to.
3. Returns are not permitted.

For System Properties, click the New button to open the Property Definition screen. Then enter the Property name and value in the appropriate fields and click OK. (Or Cancel if you don’t want to enter/save the property.)

Spaces can be used in the value field to separate different elements of the value.

To remove a property from the list, select the property and click the Remove button.

To edit a property in the list, select the property and click the Edit button.

When finished, click Next to move to the Confirm Settings screen.

Step 4: Confirm Settings

The Confirm Settings screen displays a summary of the information from the previous screens. This information defines what files will be included in the final jar file and what information will be included in the jar file Manifest.

Click the Back button to go back to previous screens to change any information you want to. If you approve of the configuration, click Next to create the final runnable jar file package.

The utility creates the final output jar file and displays the following screen.

Exporting and Importing Package Settings

The Package Completion screen above provides an Export button to save the current package settings to an XML file. You can select the filename and location for the XML file.

The Welcome screen provides an Import button to import package settings from an existing XML file. You can browse to select the desired XML file.

Intel AppUp™ Software Package Validation Utility for Java* Software

The SDK for Java includes the Intel AppUp™ Software Validation Utility that analyzes runnable jar files to help determine if they comply with the Intel AppUp™ Runnable Jar File Specification. The Utility should be used prior to submitting the jar file to the Intel AppUp^SM Developer Program portal. The utility can help speed the approval process for applications by allowing the developer to catch and correct packaging issues before* applications are submitted.

NOTE

The analysis performed by this utility is only a small part of the total validation performed by Intel for approval of applications. Files that pass this Validation Utility may still have approval issues, and ultimately may not be approved by Intel, after submission to the portal.

Step 1: Launch the Intel AppUp™ Software Package Validation Utility for Java* Software
Click Start->All Programs->Intel AppUp™ Software Development Kit->Java->Intel AppUp(TM) Software Package Validation Utility for Java* software to launch the utility. You can also double-click on the adp_validation.jar file in the SDK directory. The Utility launches and displays the jar package selection screen shown below.

The Browse button allows you to select a jar file to validate. The Validate button starts the validation sequence on the selected file. The Cancel button closes the utility. Click Browse and browse to the file you wish to validate. When you select the file, the path and filename will appear in the file field.

Step 2: Start the Validation

Click Validate to start the validation sequence. The utility performs the following steps:

• Checks for format of the jar package
• Extracts the files from the jar package
• Uses the contents of the package manifest to attempt to launch the application

The utility then prompts you to indicate whether or not the application launched successfully, as shown below.

Step 3: Validation Results

The utility displays the Validation Results screen as shown below. The utility also writes a summary of the analysis to Report.xml.

Click OK to close the screen and exit the Validation Utility.

You may now submit the jar package to the Intel AppUp^SM Developer Program portal