Debug builds

How to enable debug mode and collect logs for troubleshooting

If you encounter issues while running a Java Web Start application with CheerpJ JNLP Runner, enabling Debug Mode can provide detailed logs that help our support team identify the problem.

Enabling Debug Mode

To enable the debug build of CheerpJ:

1. Click the CheerpJ JNLP Runner icon in your browser’s toolbar.
2. In the popup page, toggle the “Enable debugging mode” switch to On.
3. The extension will now use the debug version of the runtime, which includes extensive logging.

Collecting Debug Information

To help us troubleshoot, we typically need two files: the Console log and a Network HAR file.

Step 1: Open Browser DevTools

For the JNLP Runner, you can open the browser’s developer tools directly on the “start app” page (the intermediate page that appears before the application launches).

1. Press F12 (Windows/Linux) or Cmd + Opt + I (Mac) to open the DevTools.
2. Alternatively, right-click anywhere on the page and select Inspect.

Step 2: Save the Browser Console Output

Follow these instructions to save the browser console output.

Step 3: Extract a HAR File

Follow these instructions to extract a HAR file.

Once you have collected these files, please attach them to your support request or bug report.