PreviousNext

Set debugging preferences

Set the behavior of the Edit window during debugging

    1. On the Edit menu, click Preferences.
    2. Click the Debug tab.
    3. Click the Editors tab.
    4. Set any of the following options:
      Option
      Description

      Enable editor while debugging

      The BlackBerry® IDE enables the editing of files in the Edit window during debugging.

      Close unmodified editors opened by single stepping

      The BlackBerry IDE closes unmodified files opened by single-stepping through an application during debugging.

      Allow active window to be closed after single stepping

      The BlackBerry IDE enables you to close active windows after single stepping.

      Note: This option is only available if the Close unmodified editors opened by single-stepping option is selected.

Set exception messages

    1. On the Edit menu, click Preferences.
    2. Click the Debug tab.
    3. Click the Display tab.
    4. Set any of the following options:
      Option
      Description

      Display integer and long values ashex

      Editor tooltips display integer and long values in hexadecimal format. When you move the mouse over an expression in your source code, the BlackBerry® IDE displays the current value of this expression as a tooltip.

      Fully expand large arrays

      Exception messages include fully expanded large arrays in the output window.

      Show superclass fields when expanding an object

      The exception message displays superclass fields when expanding an object.

      Display byte[] and char[] as String

      The exception message displays byte and character arrays as strings.

      Display entire Strings contents

      The exception message displays the entire strings contents.

      Log debug strings to output window

      The BlackBerry® IDE logs debug strings in the output window.

Set warning messages

    1. On the Edit menu, click Preferences.
    2. Click the Debug tab.
    3. Click the Warnings tab.
    4. Set any of the following options:
      Option
      Description

      Don't prompt for missing source files

      The BlackBerry® IDE does not prompt for missing source files when a debugging process encounters a missing source file.

      Ignore duplicate classes

      The BlackBerry IDE ignores duplicate classes.

Set options related to debugging on a BlackBerry device

    1. On the Edit menu, click Preferences.
    2. Click the Debug tab.
    3. Click the Other tab.
    4. Set any of the following options:
      Option
      Description

      Remote debug link

      Select a default remote debugging link.

      If you are debugging using the BlackBerry® Smartphone Simulator, select TCP/IP to simulate a real BlackBerry device link.

      If you are debugging using the BlackBerry device, click the USB link.

      Handheld debug file location

      Specify the location of debugging files that correspond to the version of code on a BlackBerry device. See "Debug on a BlackBerry device" for more information.

      Note: If you have BlackBerry Smartphone Simulator version 4.2.2 or later installed on your computer, when you connect the BlackBerry IDE to a BlackBerry® device, the BlackBerry IDE will automatically find the debugging information.

      Note: The USB option does not appear in the drop-down list until you have inserted a BlackBerry device in the cradle and connected the BlackBerry device to the USB port on the computer.

      If the debugging tool is connected to a BlackBerry device that is password-protected, you must type a password before you can begin debugging.

Related topic


   BlackBerry