Force.com IDE Developer Guide

Get Started with the Force.com IDE
Develop with the Force.com IDE
Test Code with the Force.com IDE
Deploy Code with the Force.com IDE
Get Started with the Apex Debugger
Get Started with the Apex Debugger
Set Up the Apex Debugger
Explore a Simple Debugging Puzzle
Manage Debugging Sessions
Apex Debugger Limits and Considerations
Apex Debugger Troubleshooting
Get Started with the ISV Customer Debugger
Set Up the Apex Debugger
Set Up a Debugging Session
Create an Eclipse Workspace
Log In to a Customer Org
Start a Debugging Session
Initiate a Debugging Session from Setup
Download Your Subscriber's Code
Set Up a Debug Configuration
Debug Your Project
Renew a Debugging Session
Delete Your Copy of Your Customer's Code
ISV Customer Debugger Limits and Considerations
Solutions to Common Force.com IDE Problems
Force.com IDE Release Notes
Useful References
PDF

Set Up a Debug Configuration

Before you start your first debugging session for a project, set up a debug configuration.

Force.com IDE is in a maintenance-only state. We still provide support for the product through our official channels, but updates prior to October 12, 2019 will be only for critical security issues that arise. On October 12, 2019, we will no longer provide support or updates of any kind for Force.com IDE. On that date, we will also begin archiving documentation and removing download links for the product. We recommend that you start migrating to Salesforce Extensions for Visual Studio Code or one of the great tools made by our partners. For more information, see The Future of Salesforce IDEs on the Salesforce Developers Blog.

Warning

  1. Switch to the Debug perspective by choosing Window | Open Perspective | Other | Debug.

    After you’ve completed the initial Debugger setup, you can switch between perspectives by clicking the icons in the upper right corner of your Eclipse window.

    Tip

  2. Click the debug icon (Debug icon) in the toolbar and select Debug Configurations.
  3. Select Remote Apex Debugger.
  4. To create a configuration for your project, click the New launch configuration icon (New launch configuration icon).
  5. Name the configuration.
  6. Click Browse and select your project.
  7. During an ISV Customer Debugger session, all actions in your subscriber’s org are debugged. If you want to debug actions only for specific users or request types, to set up whitelisting, select Whitelisting Enabled in your Remote Apex Debugger configuration. For more information, see Whitelist Users and Request Types.
  8. Click Apply, and then click Debug.
  9. Click the debug icon (Debug icon) and launch the new debug configuration.