5 Deploying ADF Mobile Client Applications

5.2.1 How to Deploy Using BlackBerry Desktop Manager

You use BlackBerry Desktop Manager to deploy a packaged mobile client application to a single smartphone.

BlackBerry Desktop Manager uses BlackBerry ALX loader program to load COD files.

To deploy the application using BlackBerry Desktop Manager:

1. Ensure that you have both the application COD and ALX files available. These files were placed by JDeveloper in the deploy directory of your application during the deployment stage of development.

2. Connect the smartphone to the PC with the USB cable or Bluetooth.

3. Open BlackBerry Desktop Manager.

4. Click Applications tab. All applications installed on the smartphone are listed in the Applications pane.

5. To add an application, click Import Files.

6. In the dialog that appears, browse and select the ALX file of the mobile client application, and then click OK.

7. Click Apply to complete the deployment.

5.2.2 How to Deploy Using BlackBerry Enterprise Server

You can use BlackBerry Enterprise Server to deploy a packaged mobile client application (COD file) to a smartphone (see How to Deploy and Distribute Applications BlackBerry tutorial).

For more information on BlackBerry Enterprise Server and its usage, see the following BlackBerry Enterprise Server documentation:

• http://us.blackberry.com/apps-software/server

• http://docs.blackberry.com/en/admin/?userType=2

5.2.3 How to Deploy Using a Web Server

A packaged mobile client application can be distributed to the production environment using a Web server. This deployment method enables the end users to download the application from the provided URL and install it on their smartphone.

The process of uploading the application to the Web server varies depending on the following:

• The type of the Web server

• Access configurations

Typically, you distribute the application as follows:

• Place both the JAD file that references the application COD file, as well as the COD file, on the Web server.

• Point the BlackBerry smartphone to the location of the JAD file.

For more information, see BlackBerry documentation.

5.2.4 How to Run an Application on a BlackBerry Smartphone

After successful deployment, the mobile client application appears on the BlackBerry smartphone as an application, or an icon to run the application. To run the application, you would require ALX application loader file to load COD files.

For more information about COD and ALX files, see BlackBerry support forums at http://us.blackberry.com/support.

To run the Application on BlackBerry Smartphone:

1. Install the client database for the BlackBerry smartphone. For more information, see "About Using a Client Database" section in Oracle Fusion Middleware Mobile Client Developer's Guide for Oracle Application Development Framework.

2. Open the smartphone and load the application. The application would be available in the Downloads folder:

   • In the Mobile Sync page, enter the required details.

   • Navigate the selection to the Sync button.

   • Press Enter to run the application.

5.2.5 What You May Need to Know About BlackBerry Deployment Files

Table 5-1 lists files that you deploy to a BlackBerry smartphone.

5.3.1 How to Deploy Using Microsoft ActiveSync

You can use Microsoft ActiveSync 4.5 or Microsoft Windows Mobile Device Center 6.1 or later to deploy a packaged mobile client application.

For more information on Microsoft ActiveSync 4.5 and Microsoft Windows Mobile Device Center 6.1, see "How to Connect the Mobile Device or Emulator" section in Oracle Fusion Middleware Mobile Client Developer's Guide for Oracle Application Development Framework.

Before you begin, ensure that you have deployed the Java Virtual Machine to the Windows Mobile device. For more information, see "Deploying the ADF Mobile Client Runtime" section in Oracle Fusion Middleware Mobile Client Developer's Guide for Oracle Application Development Framework.

To deploy the application using Microsoft ActiveSync:

1. Connect the Windows Mobile device to the PC with the USB cable or Bluetooth.

2. Open Microsoft ActiveSync or Microsoft Windows Mobile Device Center.

3. Click Explore to open the Mobile Device directory.

4. Copy the application's CAB file to the Mobile Device directory, and then close the window.

5. Navigate to the CAB file on the device and click on it to trigger the execution, and then follow the installer prompts.

5.3.2 How to Deploy Using the Mobile Server

You can deploy a packaged mobile client application to the Mobile Server. For more information, see "Publishing Applications to the Mobile Server Repository" section in Oracle Database Lite Administration and Deployment Guide.

For additional information, see the following:

• Oracle Database Lite SQLite Mobile Client Guide

• Oracle Database Lite Administration and Deployment Guide

Once the application is deployed to the Mobile Server, it is available for download from a specific URL (see "Selecting Application Files for Public Use" section in Oracle Database Lite Administration and Deployment Guide).

Once the application is installed on the user device, you can perform a variety of administrative tasks, such as the following:

• Trigger the Mobile Server's device management function to push a new version of the application or a patch to the device. For more information, see "Managing Device Software Updates" section in Oracle Database Lite Administration and Deployment Guide.

• Introduce the device management functionality in the synchronization client and use the synchronization client running on the device. For more information, see "Managing Your SQLite Mobile Client" chapter of Oracle Database Lite SQLite Mobile Client Guide.

• Troubleshoot and tune the application. For more information, see Oracle Database Lite Administration and Deployment Guide.

5.3.3 How to Run an Application on a Windows Mobile Device

After successful deployment, the mobile client application is ready to run on the Windows Mobile device.

To run the application on a Windows Mobile device:

1. Install the client database for the Windows Mobile device. For more information, see "About Using a Client Database" section in Oracle Fusion Middleware Mobile Client Developer's Guide for Oracle Application Development Framework.

2. In the Windows Mobile device, open File Explorer, and then run the application as follows:

   • In the Mobile Sync page, enter the required details.

   • Navigate the selection to the Sync button.

   • Press Enter to run the application.

5.3.4 What You May Need to Know About Windows Mobile Deployment Files

Table 5-2 lists files that you deploy to a Windows Mobile device.