Administration Guide

Local Navigation

Installing BlackBerry Java Applications using the standalone application loader tool

The standalone application loader tool is included in the BlackBerry® Enterprise Server installation files. You can make the standalone application loader tool available from a shared network folder and provide users with a link to run the tool and install the BlackBerry Java® on their BlackBerry devices. The users must connect their BlackBerry devices to their computers to install the BlackBerry Java Application.

You must install the BlackBerry® Device Manager on users’ computers so that users can use this method to install BlackBerry Java Applications. The BlackBerry Device Manager manages the connection between the standalone application loader tool and the BlackBerry device. The BlackBerry Device Manager is included in the BlackBerry® Desktop Software. You can also install the BlackBerry Device Manager on users' computers without installing the full BlackBerry Desktop Software. To download the BlackBerry Device Manager or the BlackBerry Desktop Software, visit na.blackberry.com/eng/support/downloads/.

You can also use the standalone application loader tool to install BlackBerry Java Applications in automated mode on BlackBerry devices. Automated mode installs the BlackBerry Java Application on BlackBerry devices without giving users the option to cancel the installation.

Advantages of this method include:

  • The installation process is straightforward.
  • Users are responsible for completing the installation.

Disadvantages of this method include:

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

Prerequisites: Installing BlackBerry Java Applications using the standalone application loader tool

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
  • BlackBerry® Device Manager version 4.1 (for automated mode)
  • Research In Motion USB drivers and USB connection

BlackBerry Java Application

  • .alx file 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 standalone application loader tool requires these files to install the BlackBerry Java Application.
  • 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 must install the required 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.
  • required BlackBerry Java Applications: To configure a BlackBerry Java Application as required on a BlackBerry device, in the .alx file, after the copyright statement, add the following tag: <required>true</required>.

Add BlackBerry Java Application files to a shared network folder

Before you begin:
  • The standalone application loader tool is installed when you install the BlackBerry® Enterprise Server. Verify that the standalone application loader tool is installed in <drive>:\Program Files\Common Files\Research In Motion\AppLoader.
  • Obtain the .alx and .cod files for the BlackBerry® Java® Application from the application developer, vendor, or wireless service provider.
  1. In <drive:>\Program Files\Common Files\Research In Motion\Shared\Applications\, create a folder with a unique name to contain the application files. Maintain the application’s file structure.
  2. Copy the .cod, .alx, and .dll files for the BlackBerry Java Application to the folder that you created.

Share the Research In Motion folder that contains the BlackBerry Java Application

  1. Navigate to <drive>:\Program Files\Common Files\Research In Motion.
  2. Right-click the Research In Motion folder. Click Properties.
  3. On the Sharing tab, click Share this folder. Provide read-only permissions.
  4. If necessary, configure other required options.
  5. Click OK.
After you finish: Select a distribution method (for example, an email message or an intranet web page) that you can use to provide users with a link to the loader.exe file (for example, \\<shared_computer_name>\Research In Motion\Apploader\loader.exe.

Configure the standalone application loader tool to install the BlackBerry Java Application in automated mode

Use automated mode if you do not want to give users the option to cancel the installation of the BlackBerry® Java® Application.
Before you begin: Verify that BlackBerry® Device Manager version 4.1 or later is installed on the user’s computer.
When you distribute the link to the shared network folder to users, specify the loading command using the following format:
  • USB: \\<shared_computer_name>\Research In Motion\Apploader\loader.exe /defaultUSB /forceload

Install the BlackBerry Java Application using the standalone application loader tool

Send these instructions to users.
Before you begin: Verify that the BlackBerry® Desktop Software is installed on your computer. If it is not, contact your administrator.
  1. Connect the BlackBerry device to your computer.
  2. If prompted, type your BlackBerry device password.
  3. Click Next.
  4. On your computer, click the link to the loader.exe file that your administrator provided you with.
  5. If a security warning displays, click Run.
  6. Complete the instructions on the screen.
  7. When the installation process completes, click Close.

Was this information helpful? Send us your comments.