PreviousNext

Set BlackBerry Smartphone Simulator preferences

See the BlackBerry Smartphone Simulator Guide for more information about using the BlackBerry® Smartphone Simulator.

> In the BlackBerry Smartphone Simulator, on the Help menu, click Simulator Help Index.

Manage BlackBerry device profiles

    1. On the Edit menu, click Preferences.
    2. Click the Simulator tab.
    3. Perform any of the following actions:
      Task
      Steps

      Create a profile.

      1. Click New.
      2. Type a name for the profile.
      3. Click OK.
      4. Set the BlackBerry Smartphone Simulator options.
      5. Click OK.

      Delete a profile.

      1. In the Profile drop-down list, select a profile.
      2. Click Delete.

      Change a profile.

      1. In the Profile drop-down list, select a profile.
      2. On the Advanced and General tabs, set options.
      3. Click OK.

      Note: You cannot change the Default Simulator profile. To change BlackBerry® Smartphone Simulator options, use one of the numbered profiles or create a new profile.

Specify how the BlackBerry Smartphone Simulator starts on start up of the IDE

    1. On the Edit menu, click Preferences.
    2. Click the Simulator tab.
    3. Click the General tab.
    4. In the Profile drop-down list, select a BlackBerry® Smartphone Simulator profile or create a new profile.

      Note: You cannot change the Default Simulator profile. To set options for the BlackBerry Smartphone Simulator, select a BlackBerry device model number, or create a new profile.

    5. Select one or more of the following options:
      Option
      Description

      Launch simulator

      The BlackBerry Smartphone Simulator starts automatically when you start the debugging process.

      Minimize when launching simulator

      The BlackBerry Smartphone Simulator remains minimized when it starts.

      Launch Mobile Data System Connection Service (MDS-CS) with simulator

      The BlackBerry IDE opens the BlackBerry® MDS Simulator along with the BlackBerry Smartphone Simulator. With BlackBerry MDS Services turned on, you can perform tests on network applications, push applications, and browser applications.

      Launch app or URL on startup

      When the BlackBerry Smartphone Simulator starts, the specified .cod file runs.

      Automatically use default values for all prompts

      In the BlackBerry Smartphone Simulator, use default values for device prompts.

      Specify the number of seconds to wait before the automated response is selected.

      The BlackBerry Smartphone Simulator waits the specified amount of time before selecting automated responses.

      PIN

      The PIN number for the device.

      ESN

      The ESN number for the device.

      Enable device security

      The Smartphone Simulator gives access to secure APIs to signed applications only.

      System locale

      The locale for applications and system software, for example, "en" or "en_US."

      Keypad locale

      The locale for the keypad, for example, "en" or "en_US."

      Do not save settings

      The BlackBerry Smartphone Simulator does not reuse settings configured in this session.

      Do not backlight Effect in GUI

      The BlackBerry Smartphone Simulator does not use the backlight option.

Customize the appearance of the BlackBerry Smartphone Simulator

    1. On the Edit menu, click Preferences.
    2. Click the Simulator tab.
    3. Click the View tab.
    4. Select one or more of the following options:
      Command
      Description

      Disable automatic backlight shutoff

      The backlight on the BlackBerry® Smartphone Simulator remains turned on.

      Hide network-specific information

      The BlackBerry Smartphone Simulator displays the simulated BlackBerry device screen without displaying network information.

      Display the LCD only

      The BlackBerry Smartphone Simulator displays the simulated BlackBerry device screen without the BlackBerry device case and keyboard.

      Full or relative path to a Config-Pack

      The BlackBerry Smartphone Simulator uses the .dat file specified for theme or plastics enhancements.

      LCD zoom

      The BlackBerry Smartphone Simulator displays the LCD screen magnified by a given factor.

      Always keep LCD backlight on

      The BlackBerry Smartphone Simulator displays the LCD screen backlit.

      Do not show help for key mappings

      The BlackBerry Smartphone Simulator does not display help for key mappings.

Set the response of the BlackBerry Smartphone Simulator to deadlocks and exceptions

    1. On the Edit menu, click Preferences.
    2. Click the Simulator tab.
    3. Click the Debugging tab.
    4. Select one or more of the following options:
      Command
      Description

      Interrupt debugger on potential deadlock

      The BlackBerry® Smartphone Simulator interrupts the debug tool when a deadlock occurs.

      Do not stop execution when an exception is caught by "catch (Throwable)"

      The BlackBerry Smartphone Simulator ignores caught Throwable exceptions.

Specify how the BlackBerry Smartphone Simulator interacts with the network

    1. On the Edit menu, select Preferences.
    2. Click the Simulator tab.
    3. Click the Network tab.
    4. Set any of the following options:
      Command
      Description

      Disable registration

      Prevent the BlackBerry® Smartphone Simulator from registering with the wireless network.

      Network

      Specify a string describing one of the available networks. Use the following format: "{param}:value;{param}:value".

      Start with radio off

      Start the BlackBerry Smartphone Simulator with the radio off.

      Phone number

      Specify the phone number of the BlackBerry Smartphone Simulator.

      Automatically answer outgoing calls

      Cause the BlackBerry Smartphone Simulator to automatically answer outgoing calls.

      IMEI

      Specify the International Mobile Equipment Identity (IMEI).

      ICCID Override (GPRS)

      Specify the 19 or 20 digit serial number of the simulated SIM card.

      IMSI Override (GPRS)

      Specify a 15-digit number to designate the subscriber.

      Simulate SIM not present

      Simulate a SIM not present condition.

      IP Address

      Specify the address for the simulated device. This field should normally be left blank.

      Ignore UDP port conflicts

      Do not display errors when a new UDP port opens.

      SMS source port

      Specify a UDP port for receiving SMS text messages.

      SMS destination port

      Specify a UDP port for sending SMS text messages.

      PDE Port

      Specify a PDE port used for GPS access.

Specify how the BlackBerry Smartphone Simulator communicates with the ports on the computer

    1. On the Edit menu, select Preferences.
    2. Click the Simulator tab.
    3. Click the Ports tab.
    4. Set any of the following options:
      Command
      Description

      USB cable connected

      Specify whether the simulated USB cable is connected when the application starts.

      Bluetooth test board port

      Use a Casira® test board connected to the given serial port on the PC.

Specify how the BlackBerry Smartphone Simulator manages the file system and flash memory

    1. On the Edit menu, select Preferences.
    2. Click the Simulator tab.
    3. Click the Memory tab.
    4. Set any of the following options:
      Command
      Description

      Application heap size (in bytes)

      Specify the size of the application heap.

      Branding data

      Specify a file that contains images or sounds that are specific to a wireless service provider.

      Reset the file system on startup

      Specify whether the file system should be reset when the BlackBerry® Smartphone Simulator starts.

      Reset NVRAM on startup

      Specify whether the non-files system flash data should be cleared on startup.

      Filesystem size (bytes)

      Specify the size of the file system.

      Do not save flash data on simulator exit

      Specify whether the flash data should be saved when the BlackBerry Smartphone Simulator closes.

      Do not compact filesystem on exit

      Specify whether the file system should be compacted when the BlackBerry Smartphone Simulator closes.

      Simulate no SD Card inserted

      Simulate an SD Card not present condition.

      Destroy existing SD Card image

      Delete the existing SD Card image on startup and create a new image, if necessary.

      SD Card size

      Specify the size of a new SD Card.

      SD Card image

      Specify the location for an SD Card image file.

      Use PC filesystem for SD Card files

      Specify that the PC filesystem be used for SD Card files.

      PC filesystem path for SD Card files

      Specify the path for files that should appear on the SD Card.

      Do not support Multimedia Card simulation

      Do not support simulation of Multimedia cards.

Start an application when the BlackBerry Smartphone Simulator starts

    1. Right-click a project file. Click Properties.
    2. On the Build tab, in the Output file name field, type the name of the .cod file of the application.
    3. Click OK.
    4. On the Edit menu, select Preferences.
    5. On the General tab, in the Launch app or URL on startup field, type the name of the .cod file of the application.
    6. Click OK.

Open a web site in the BlackBerry Browser when the BlackBerry Smartphone Simulator starts

> Repeat steps 4 through 6 from "Start an application when the BlackBerry Smartphone Simulator starts" on page 16, typing the web site URL in the Launch app or URL on startup field.

Set the working directory for the BlackBerry Smartphone Simulator

> Click the Advanced tab

See "Set advanced command-prompt options for the BlackBerry Smartphone Simulator" for more information on using the BlackBerry® Smartphone Simulator command line.

Related topic


   BlackBerry