Edit

Share via

Debug upgrade and install code

To test and troubleshoot issues in install and upgrade code, it's important to ensure that these processes run smoothly when the app is installed for the first time or when it's upgraded. You can add breakpoints in the install or upgrade code, and then attach and trigger publishing of an extension to debug these scenarios.

Attach and debug

  1. In Visual Studio Code, ensure that you've a launch.json file with the request option set to attach. For more information, see Attach and Debug Next.
  2. Add one or more breakpoints in the code that you want to debug. For more information, see Debugging.

    Note

    If you don't increment the version of the app, the install codeunits will not be invoked. If you do increment the version of the app, or if you set the forceUpgrade flag to true in the launch.json file, the upgrade codeunits will be invoked.

  3. If your app isn't yet published, then use Ctrl+F5 to publish the app file first; the attach option won't publish the app. After, start the attach session as you would normally start the debugging session with F5.

Debugging
Snapshot Debugging
Attach and Debug Next