Sorry about the red box, but we really need you to update your browser. Read this excellent article if you're wondering why we are no longer supporting this browser version. Go to Browse Happy for browser suggestions and how to update.

Packaging and distributing your apps

You can create an app 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 for Eclipse 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 app by using the BlackBerry Desktop Software or the BlackBerry Enterprise Server push service, the BlackBerry Java Plug-in for Eclipse 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 for Eclipse 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 for Eclipse 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 of 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>

.cod

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

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

.csi

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

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

.cso

This log file contains the signature keys that are available.

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

.debug

This file permits you to debug a BlackBerry device application.

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

.jad

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

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

.jar

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

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

.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>

.cod

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

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

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).

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

.csi

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

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

.cso

This log file contains the signature keys that are available.

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

.debug

This file permits you to debug a BlackBerry device application.

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

.jad

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

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

.jar

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

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

.rapc

This file is necessary for packaging your BlackBerry device application.

Distributing an app from a web page

You can use the BlackBerry Application Web Loader to allow BlackBerry device users to install a BlackBerry device application from a web page.

When you package the project by using the BlackBerry Java Plug-in for Eclipse, you can distribute the .jad and .the cod files that are located in the deliverables folder of the project. When BlackBerry device users use Windows Internet Explorer to visit the web page that hosts the .jad and the .cod files, they are asked to connect their BlackBerry device to the USB port on their computer. A are trademarks of Microsoft Corporation. ActiveX control installs the BlackBerry device application . For more information about using the BlackBerry Application Web Loader, see the BlackBerry Application Web Loader Developer Guide.

Distributing an app from the BlackBerry Desktop Software

In the BlackBerry Desktop Software, you can use the application loader tool to allow BlackBerry device users to download a BlackBerry device application onto their computers and install the application on their BlackBerry devices. For more information about using .alx files, see the Application Loader Online Help.

  1. In the Package Explorer view, expand a BlackBerry device application project.
  2. Double-click the BlackBerry_App_Descriptor.xml file.
  3. Click the Build tab.
  4. Select Generate .alx file (Desktop Deployment / BlackBerry Enterprise Server Push).
  5. Distribute the .alx file and the .cod files for the BlackBerry device application to BlackBerry device users.

Turning off .alx generation when you package a BlackBerry application project

By default, when you package a BlackBerry application project, an .alx file is generated automatically to permit you to distribute your BlackBerry device application by using the BlackBerry Desktop Software or the BlackBerry Enterprise Server push service.

To turn off this feature, complete the following task:

  1. In the Package Explorer view, expand a BlackBerry application project.
  2. Double-click the BlackBerry_App_Descriptor.xml file.
  3. Click the Build tab.
  4. Clear the Generate .alx file (Desktop Deployment / BlackBerry Enterprise Server Push) option.
  5. Close the BlackBerry_App_Descriptor.xml file.
  6. Click Yes.