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.

Testing applications using the BlackBerry Smartphone Simulator

Load an application for testing

Perform one of the following tasks:

Task

Steps

Load an application while the BlackBerry Smartphone Simulator

  1. Compile the application as a .cod file.
  2. On the File menu, click on Load Theme or Application.
  3. Click the .cod file that contains the application.
  4. Click OK.
  5. If your application consists of multiple .cod files, repeat steps 1 to 4 for each file.

Load an application while the BlackBerry Smartphone Simulator is running.

  1. Compile the application as a .cod file.
  2. On the desktop, drag the .cod file to the BlackBerry Smartphone Simulator.

Load an application by file placement when starting the BlackBerry Smartphone Simulator.

  1. Compile the application as a .cod file.
  2. Copy the .cod file into the BlackBerry Smartphone Simulator folder.
  3. Start the BlackBerry Smartphone Simulator.

Load an application by using the BlackBerry Java Plug-in for Eclipse.

  1. In the Eclipse Package Manager, right-click the folder that contains the application and select Run As > Simulator or Debug As > Simulator.

Testing GPS applications

You can test GPS applications using the BlackBerry Smartphone Simulator. A GPS application on the BlackBerry Smartphone Simulator can access GPS data such as the direction, the speed, and the number of visible satellites (satellites provide GPS information). The GPS feature in the BlackBerry Smartphone Simulator should function the same as when the GPS application runs on a BlackBerry smartphone.

The current simulated location determines the number of satellites that are visible. When you create a new location, the value you specify in the Visible satellites field becomes the default value for that field. Most locations are visible to four satellites or more.

Testing JavaScript and webpages

If you use the BlackBerry Smartphone Simulator version earlier than 6.0, you must save a webpage as a BlackBerry WebWorks application to test its appearance.

If you use the BlackBerry Smartphone Simulator 6.0 or later, the BlackBerry Browser can interpret a webpage and any JavaScript on it. With the BlackBerry Browser, you can load a file from a web server. With the Files icon, you can load a file directly from a simulated media card.

Test MIDlets

If the MIDlet is contained in .jad and .jar files, you need to convert these files to a .cod file before loading the .cod file to the BlackBerry Smartphone Simulator. You can use the BlackBerry MDS Simulator to convert the .jad and .jar files to a .cod file.
  1. Place the .jad and .jar files on a web server.
  2. Start the BlackBerry MDS Simulator.
  3. Start the BlackBerry Smartphone Simulator.
  4. On the BlackBerry Smartphone Simulator screen, click the Browser icon.
  5. Use the browser to navigate to the location of the application .jad file.
  6. Download the .jad file to the BlackBerry Smartphone Simulator.
After you finish: The BlackBerry Smartphone Simulator will automatically load the .cod file on start up.

Configuring the BlackBerry MDS Simulator and the BlackBerry Smartphone Simulator for BlackBerry Messenger

To test a BBM connected application on a BlackBerry Smartphone Simulator, you must install and configure the BlackBerry MDS Simulator and the BlackBerry Smartphone Simulator with settings that enable communication between the BlackBerry MDS Simulator and two instances of the BlackBerry Smartphone Simulator. To learn how to configure the simulators for BBM, see Installing and configuring simulators to support the BBM SDK.