Quick Start Guide

Follow these steps to debug a sample Android Application.

System Requirements

Hardware

  • A computer with Windows 7, Ubuntu Linux, or Mac OSX

Software

Device

  • Android 4.4+ devices for C/C++ NDK debugging
  • Snapdragon Android devices with Adreno A3x or A4x GPU for OpenCL kernel debugging

Eclipse Plug-in Installation

  1. Start the Eclipse IDE.
  2. Go to the Help menu and select Install New Software.
  3. In the Work with text field, enter CDT Juno – http://download.eclipse.org/tools/cdt/releases/juno and press Enter.
  4. Wait for the Available Software window to refresh.
  5. Expand CDT Main Features.
  6. Select C/C++ Development Tools and click Next.
  7. In the ensuing window, click Next to install the selected plug-in.
  8. Accept the Licensing Agreement and Terms of Services. Click Finish.
  9. When the install is finished, a dialog prompts you to restart the IDE; do so.
  10. When the IDE has reinitialized, repeat Step 2 to navigate to the Install New Software window via the Help menu.
  11. Uncheck the Group items by category checkbox.
  12. Click Add.
  13. When the Add Repository window appears, click Archive.
  14. Navigate to the directory containing the SnapdragonDebuggerPlugin.zip file and select it.

    Note: For Windows systems, the default location of this file is C:\Program Files (x86)\Qualcomm\Snapdragon Debugger for Eclipse\Eclipse\SnapdragonDebuggerPlugin.zip.
  15. Click OK.
  16. When the Install window has refreshed, select the checkbox next to Qualcomm OpenCL Plugin and click Next.
  17. A new window appears. Click Next again.
  18. Accept the Licensing Agreement and Terms of Services. Click Finish.
  19. Restart the IDE when prompted.

Configuration and Launch

  1. Go to the File menu and select New -> Project.
  2. In the ensuing window, expand C/C++ and select C Project.
  3. Enter a project name and select Executable -> Empty Project.

    Note: If Executable -> Empty Project is not visible, uncheck Show project types and toolchains only if they are supported on the platform.
  4. Click Finish.
  5. Note: If you have existing source code, you can import it into your project by right-clicking and selecting Import -> File System and then navigating to your source code.
  6. Click the small arrow next to the debug icon and select Debug Configurations.
  7. Select the C/C++ Remote Application and click the New Launch Configuration icon  that appears toward the top of the window.
  8. At the bottom of the window that appears after you have selected New Launch Configuration, you will see – next to the Apply button – a label reading Multiple launchers available. Click Select one....
  9. Select the Use configuration specific settings checkbox.
  10. Select LLDB Remote OpenCL Debugging Launcher and click OK.
  11. In the Main tab of the Launch Configuration window, there is a Project text field. Click Browse and choose the project you wish to debug.
  12. Select your newly created project and click OK.
  13. Click Search project… or Browse… and select the binary to debug.
  14. Click the OpenCL (LLDB) Debugger tab.
  15. Click Browse to specify the lldbmi executable.
  16. NOTE:     For Windows systems, the default location of this file is C:\Program Files (x86)\Qualcomm\Snapdragon Debugger for Eclipse\Windows\lldbmi.exe.
  17. Click the Connection tab.
  18. Make sure localhost is entered in the Host name or IP address field.
  19. Enter port 1234 in the Port number field.
  20. Click Apply.
  21. Click Debug to attach to debugserver if already running. Please make sure the debugserver has been launched on the device.

Known Limitations

  • Snapdragon Debugger for Eclipse can only debug 32bit applications.
  • Snapdragon Debugger for Eclipse only functions correctly with one Android device attached to the host PC at a time. Running with more than one device or emulator attached could lead to undefined behavior.