Note: Advice in this article will only work for JxBrowser 6. See the corresponding article for JxBrowser 7 here.


Getting crash dump file

By default, on Windows platforms, when Chromium engine is crashed, JxBrowser generates jxbrowser-chromium.dmp crash dump file and stores it in the %localappdata%\JxBrowser\ directory (e.g. c:\users\<username>\appdata\local\JxBrowser\jxbrowser-chromium.dmp).


When you see that Chromium engine is unexpectedly terminated or crashed, please go to the %localappdata%\JxBrowser\ directory and share with us the jxbrowser-chromium.dmp file using an online file sharing service such as Dropbox, Google Drive, etc.


Configuring crash dump folder

To change directory where crash dump files will be generated to and stored, use the jxbrowser.dmp.dir System Property. For example: 

System.setProperty("jxbrowser.dmp.dir", "C:\\JxBrowser\\crash-dumps");

  

Disabling crash dump generation

To disable crash dump generation set the jxbrowser.dmp.dir System Property to an empty string:

System.setProperty("jxbrowser.dmp.dir", "");

 


Getting crash dump file using Microsoft Debug Diagnostic Tool

To debug JxBrowser native binaries please use Microsoft Debug Diagnostic Tool to catch all exceptions in jxbrowser-chromium.exe processes.


Here's instruction about how to configure this software to catch all native crashes/exceptions: 


1. Download Microsoft Debug Diagnostic Tool (both 32- and 64-bit versions).

2. Install it in your target Windows environment. To install it just run MSI file.

3. Run your application and create at least one Browser instance.

4. Run Debug Diagnostic Tool and follow the instruction below:

4.1. Click Add Rule... button:



4.2. Select Rule Type - Crash and click Next:



4.3. Select A specific process and click Next





4.4. In the list of opened processes select jxbrowser-chromium.exe and click Next




4.5. Click Next



4.6. Select directory where Tool will save Dump files (e.g. on your Desktop) and click Next:



4.7. Select Activate Rule Now and click Finish




Now you can work with your Java application and try to reproduce native crash in jxbrowser-chromium.exe process. When native crash happens, this tool will generate DMP file in the directory you provided at 4.6 step.

When you reproduce native crash and get DMP file/files, please report the issue and share the generated crash dump file using an online file sharing service such as Dropbox, Google Drive, etc. 
We will analyze DMP files, find out root cause of the native crash and fix it.