Packaging a BlackBerry application project for multiple versions of BlackBerry Device Software

You can create a BlackBerry® device application that is compatible with multiple versions of the BlackBerry Device Software. When you package your BlackBerry application project (and its dependent projects) for multiple versions of the BlackBerry Device Software, the BlackBerry Java Plug-in creates the application files for distribution to BlackBerry device users that run the versions of the BlackBerry Device Software that you include in your BlackBerry application project.

When you distribute your BlackBerry device application by using the BlackBerry Desktop Software or the BlackBerry Enterprise Server push service, the BlackBerry Java Plug-in creates one master .alx file in the Standard folder of your BlackBerry application project.

When you distribute your BlackBerry device application over the Internet, the BlackBerry Java Plug-in creates the .jad and .cod files for each version of the BlackBerry Device Software in the Web folder of your BlackBerry application project.

You can use the auto-signature feature in the BlackBerry Java Plug-in to sign the .cod files automatically after you package a BlackBerry application project.

Packaging output for BlackBerry application projects

Location

File extension

Description

<project-dir>/deliverables/Standard/

.alx

You can use this file to install a BlackBerry device application on a BlackBerry device by using the BlackBerry Device Software or the BlackBerry Enterprise Server.

When you package a BlackBerry application project for multiple versions of the BlackBerry Device Software, this file contains all the application files.

You can configure the .alx file name on the Build tab of the BlackBerry_App_descriptor.xml file editor.

<project-dir>/deliverables/Standard/<x.x.x>

where "x.x.x" represents the version of the BlackBerry Java SDK

.cod

This file is the executable file for the BlackBerry device application.

.csi

This log file is created when you sign the .cod files in your BlackBerry device application.

.cso

This log file contains the signature keys that are available.

.debug

This file permits you to debug a BlackBerry device application.

.jad

This file describes the application that is contained in the .jar file.

.jar

This file is the application archive file that you can use to distribute your BlackBerry device application.

.rapc

This file is necessary for packaging your BlackBerry device application.

<project-dir>/deliverables/Web

The files in this location are generated when you sign your application or when packaging is invoked explicitly. They are intended for sharing with or copying to a deployment system.

<project-dir>/deliverables/Web/<x.x.x>

where "x.x.x" represents the version of the BlackBerry Java SDK

.cod

This file is the executable file for the BlackBerry device application.

x.cod

This file is created when a large .cod file is split into one or more sibling .cod files (for example 1.cod, 2.cod, and so on).

.csi

This log file is created when you sign the .cod files in your BlackBerry device application.

.cso

This log file contains the signature keys that are available.

.debug

This file permits you to debug a BlackBerry device application.

.jad

This file describes the application that is contained in the .jar file.

.jar

This file is the application archive file that you can use to distribute your BlackBerry device application.

.rapc

This file is necessary for packaging your BlackBerry device application.

Back To Top

Was this information helpful? Send us your comments.