To capture the execution of a program to BugJail, the only thing you need to do is start Java Virtual Machine with one additional option.
This article links to two alternative ways how to construct the BugJail Agent option string and then shows how to use the option to enable BugJail capturing from IntelliJ IDEA.
Step 1: Construct BugJail Agent option & copy to clipboard
Alternative A: construct BugJail Agent option string by using Capturing Assistant (easy user-interface, but supports only the two most common configuration options currently).
Alternative B: construct BugJail Agent option string manually (more effort, but allows using additional options).
Step 2: Paste the BugJail Agent option to IntelliJ IDEA 'run configuration'
- In IntelliJ IDEA, open "Run" menu.
- Select "Edit Configurations..." menu item.
- Select the 'run configuration' you want to use with BugJail capturing.
- Paste clipboard contents to "VM Options" input box
- Note: if you have existing VM arguments, just append the BugJail Agent option string from clipboard to the beginning or end.
- Click "OK" to save the changes to the configuration you just edited.
Step 3: Run or Debug the IntelliJ IDEA 'run configuration'
- In IntelliJ IDEA, Run or Debug the run configuration you just edited
Step 4: Verify that capturing worked
- In IntelliJ IDEA console output, you should see extra logging from BugJail Agent
- In BugJail, the "Welcome to BugJail" or "Capturing Assistant" dialog box should disappear within 1-2 seconds, if it was visible, revealing a list of captures.
- In BugJail "Captures" -panel, you should see a new capture row within 1-2 seconds.