Home : Tools & SDK : Ide Integration : Borland : Integrating Openwave simulators with Borland JBuilder Enterprise
 

Integrating Openwave simulators with Borland JBuilder Enterprise

 

You do this by installing an Openwave add-on which enables integration of Openwave SDKs 6.1 or higher with JBuilder 7 or higher.  This add-on was created using Borland's Open Tools API.  This technote describes integration with JBuilder 7, but similar steps can be taken with later versions.

SDK 6.x (also called phone simulator) contain Openwave mobile browser versions that adhere to the WAP 2.0 standard, and render content in XHTML Mobile Profile and CSS. These SDKs are also backward compatible with WML and cHTML.  You can use various simulators, depending on your needs and the target devices for your market. For details on browser capabilities and device deployments, see Supported Phones.

Requirements

• Borland JBuilder 7 Enterprise or higher
• Openwave SDK 6.1 or higher
• Openwave JBuilder add-on (OpwvSim-JBuilder7.jar) DOWNLOAD NOW

Installing the Openwave JBuilder add-on

1. If JBuilder 7 is running, close it.
   
   
2. Copy the Openwave JBuilder add-on (OpwvSim-JBuilder7.jar) to the directory:
   
   [jbuilder_home]\lib\ext
   
   If you performed a default installation of JBuilder 7, this is equivalent to:
   
   c:\jbuilder7\lib\ext
   
   If you installed a previous version of the Openwave Jbuilder add-on, just overwrite that file, or delete the old file and save the new one in this directory.
   
   
3. Launch JBuilder 7.
   
   
4. From the Tools menu, select Openwave Simulator > Openwave Simulator Options.
   
   
5. In the Openwave Simulator Options dialog box, click on the 6.1 tab and enter the path to the Openwave SDK 6.1 executable in the Openwave 6.1 Path field.  If you installed the SDK in the default location, this path is:
   
   c:\Program Files\Openwave\SDK 6.1\program\http\OSDK61http.exe
   
   To configure SDK 6.2.2, just click on the 6.2 tab and enter the path to the Openwave SDK 6.2.2 executable, the default location is:
   
   c:\Program Files\Openwave\SDK 6.2.2\program\http\OSDK62http.exe
   
   
6. In the Openwave Simulator Options dialog's Default Command-Line Options field, enter any special arguments you want passed to the Openwave SDK when it is launched, such as -clearcache or -lang ja-jp.  For a complete list and description of simulator command-line arguments, see the appropriate Openwave SDK release notes.
   
   Do not include the -reload argument in this field; it is automatically added at runtime.
   
   
7. Click OK to close the dialog and save your settings.

Testing with the Openwave simulator

To test your JSP or servlet applications with the Openwave simulator in JBuilder 7, you must configure JBuilder to use Web View.  To do so, go to Tools->IDE Options, open the Web tab, and select one of the following two options:

Launch separate process and use Web View

Use Web View on running process if possible

Then, use the Run > Run Project or Run > Debug Project command to compile your project and launch it within its configured server.  After the project has opened in JBuilder's Web View browser, you can select the Tools > Openwave Simulator > View in Openwave 6.1 (or 6.2) command to launch the SDK and view the project.

As you make changes to your project, you can reload the content by again selecting the Tools > Openwave Simulator > View in Openwave 6.1 (or 6.2) command, or by selecting the Edit > Reload command from within the SDK.  You can also navigate using the Openwave simulator itself, selecting links or entering URLs in the simulator's "Go" field.