Setting up a BlackBerry Simulator

Good Setting up a Blackberry Simulator

by Chaim Langermann

Senior Mobile App Consultant, Professional Services

Verivo Software, Inc.

 

 

Overview:

  1. Where to download:
    1. Blackberry simulator installation files can be downloaded directly from RIM's Blackberry Developer website: http://us.blackberry.com/developers/resources/simulators.jsp
  2. Recommended simulators:

It is recommended to have a variety of different Blackberry simulators to develop and test width to provide a breadth of coverage across screen size, trackpad vs. touchscreen, and OS.  At a minimum, the below are recommended

                                                  i.      Blackberry 9700, OS 5.0, trackpad

                                                 ii.      Blackberry 9800, OS 6.0, touchscreen

                                                iii.      Blackberry 9900, OS 7.0, trackpad/touchscreen

        3. MDS simulator:

To mimic BES traffic, an MDS simulator can be downloaded from RIM’s Blackberry Developer website: https://swdownloads.blackberry.com/Downloads/entry.do?code=996009F2374006606F4C0B0FDA878AF1.  Select the “BlackBerry Email and MDS Services Simulator Package” from the dropdown.

 

 

Adding .cod files to the simulator:

When building for Blackberry, the Merlin build system will generate a ZIP file which contains 3 additional ZIP files:

  1. <appname>_JAR.zip
  2. BBClientBESPush_<appname>.zip
  3. BBClientPull_<appname>.zip

The five (5) .cod files needed for the simulator can be found in the BBClientBESPush_<appname>.zip file.  Extracting the ZIP file will create a directory structure organized by Blackberry OS.  Select the five (5) .cod files from the appropriate OS folder for the simulator.

 

Copy the five (5) .cod files to the simulator’s installation directory.  This will vary by Windows version, but it is usually:

C:\Program Files (x86)\Research In Motion\BlackBerry Smartphone Simulators <OS>\<OS> (<devicemodel>)

 

 


 

Starting the simulator

To launch the simulator, run the <devicemodel>.bat file in the simulator’s installation directory.  A shortcut is usually created in the Windows Start Menu as part of the simulator installation.

 

There are two (2) connection options to use when using the application on a simulator: MDS and WiFi.  In the past, WiFi was not supported on all Blackberry devices and so MDS was the only option.  For most devices since Blackberry OS 6.0, WiFI is available and is the easier option to use.

 

  1. Starting the application with MDS
    1. Start the Blackberry simulator and MDS software
    2. Launch the application
    3. Click on the Blackberry menu button and select “Options”
    4. Set the Connection Type = “Corporate Server (BES/MDS)”
    5. Click on the Blackberry menu button select “Save”
    6. Starting the application with WiFi
      1. Start the Blackberry simulator
      2. Click on the Manage Connections icon
      3. Click “Set Up Wi-Fi Network” and select “Default WLAN Network”
      4. Launch the application
      5. Click on the Blackberry menu button and select “Options”
      6. Set the Connection Type = “WIFI”
      7. Click on the Blackberry menu button select “Save”

 

 

Configuring an SD card

Starting in v7.3 and onwards, a requirement for SD card or eMMC was added to Blackberry.  The majority of the newer simulators are installed with an eMMC already configured, but the older simulators (i.e. Blackberry 9700) require manually configuring a SD card.

 

  1. Configuring a SD card
    1. Start the Blackberry simulator
    2. On the menu bar, select Simulate > Change SD Card…
    3. Click the “Add Directory…” button
    4. Select a folder location where you want the SD Card file to be created
    5. Close the SD Card window

 

 

Closing the simulator

The best practice to close the simulator is too kill the “fledge.exe” process from the Windows Task Manager.

 

Troubleshooting

  1. Deleting dump files

If the application crashes or gets into a bad state, the simulator dump files should be deleted to restore the simulator to its original state.

                                                              i.      Close the simulator

                                                             ii.      Navigate to the simulator’s installation directory.  This will vary by Windows version, but it is usually:  

C:\Program Files (x86)\Research In Motion\BlackBerry Smartphone Simulators <OS>\<OS> (<devicemodel>)

                                                            iii.      Delete all the .dmp files

                                                            iv.      Restart the simulator
   2. Clean.bat

  1. If deleting the dump files does not resolve all issues, the simulators contain a batch file which deletes all installed .cods and restores the simulator to its original, brand new state.  Note that this will require re-adding the .cod files to the simulator.

                                                               i.      Close the simulator

                                                              ii.      Navigate to the simulator’s installation directory.  This will vary by Windows version, but it is usually: 

C:\Program Files (x86)\Research In Motion\BlackBerry Smartphone Simulators <OS>\<OS> (<devicemodel>)

                                                            iii.      Execute the clean.bat batch file

 

 

 

 

Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.
Powered by Zendesk