Administration Guide

Local Navigation

Installing BlackBerry Java Applications using the BlackBerry Desktop Software

Application developers can use the BlackBerry® Java® Development Environment or the BlackBerry® Java® Plug-in for Eclipse® to create an automated application installer. You can use the application installer to install the files for a BlackBerry Java Application (the .alx identifier file and the application's .cod files) on users’ computers. You can then instruct users to use the application loader tool in the BlackBerry® Desktop Software to install the BlackBerry Java Application on their BlackBerry devices. Users must connect their BlackBerry devices to their computers.

This method has the following advantages:

  • You can control how the application files are distributed to users’ computers.
  • Users are responsible for completing the installation.
  • If you installed the BlackBerry® Desktop Software on users’ computers, they can use it to install the BlackBerry Java Applications.

This method has the following disadvantages:

  • You must install the BlackBerry Desktop Software on users’ computers.
  • The users must use the BlackBerry Desktop Software to install the BlackBerry Java Application.
  • You cannot control when the users install the BlackBerry Java Application.
  • Users must connect their BlackBerry devices to their computers.

Prerequisites: Installing BlackBerry Java Applications using the BlackBerry Desktop Software

BlackBerry® device

  • BlackBerry APIs and Java® ME (standard on BlackBerry devices)

User’s computer

  • Windows® 2000 or later, Windows® XP, or Windows Vista®
  • BlackBerry® Desktop Software version 4.0 or later
  • Research In Motion® USB drivers and a USB connection for the BlackBerry device

BlackBerry Java Application

  • .alx files and .cod files: The .alx file is the application descriptor that provides information about the application and the location of the application's .cod files. A .cod file contains compiled and packaged application code. The application loader tool requires these files so that it can install the BlackBerry Java Application on BlackBerry devices.
  • required modules: Some BlackBerry Java Applications require modules that are part of the BlackBerry® Device Software. The required modules are listed in the .alx file in a <requires> tag. If the required modules do not exist on the BlackBerry device, you need to install the necessary BlackBerry Device Software on the BlackBerry device. For more information about application dependencies, visit www.blackberry.com/developers to read the BlackBerry Java Development Environment Development Guide.

Make the BlackBerry Java Application available to the BlackBerry Desktop Software

  1. Obtain the application installer (.exe file) for the BlackBerry® Java® Application from the application developer, vendor, or wireless service provider.
  2. Run the application installer on the user's computer to install the .alx identifier file and .cod file in an installation folder on the user’s computer. You can also run the application installer to install the .alx identifier file and .cod file in a shared network folder that users can access from their computers.

Install the BlackBerry Java Application using the BlackBerry Desktop Software

The following instructions are for BlackBerry® Desktop Manager version 4.7. If your organization’s environment uses a different version of the BlackBerry Desktop Manager, visit www.blackberry.com/go/docs to find the required version of the BlackBerry Desktop Manager User Guide.
  1. Connect the BlackBerry device to your computer.
  2. In the BlackBerry Desktop Manager, click Application Loader.
  3. In Add/Remove Applications or Update Software, click Start.
  4. If necessary, perform the following actions:
    • If the Device Security Password dialog box appears, type the BlackBerry device password. Click Next.
    • If the Communication Port Selection dialog box appears, specify a communications port. Click Next.
  5. Click Next.
  6. Perform one of the following actions:
    • To add a BlackBerry Java Application that appears in the list, select the check box beside the BlackBerry Java Application.
    • To add a BlackBerry Java Application that does not appear in the list, click Browse. Double-click an .alx file.
  7. Click Next.
  8. Click Finish.

Was this information helpful? Send us your comments.