If you are having trouble with Builder you can help us help you by trying to do some basic troubleshooting. Here are some steps you can go through to try to discover what is going wrong.
You can increase the log verbosity of Builder by adding up to four
-v when launching from the command line.
# If running from flatpak flatpak run org.gnome.Builder -vvvv # If using distribution packages gnome-builder -vvvv
Builder has support to generate a support log which can provide us with details. From the application menu, select “Generate Support Log”. It will place a log file in your home directory.
Builder has internal counters which can be useful to debug problems.
Use the command bar (activated by
Control+Enter) and type “counters” followed by
This will bring up a new window containing the current values of the counters.
If Builder has locked up, you can access the counters from outside of Builder.
The command line tool
dazzle-list-counters, can be used to access the counters.
dazzle-list-counters `pidof gnome-builder`
When running Builder from Flatpak, we do not currently expose the counters to the host. Use
flatpak enter $PID /bin/bash to enter the mount namespace and then run
Test Builder Nightly¶
If you are running the stable branch or an older distribution package, please consider trying our Nightly release to see if the bug has already been fixed. Doing this before reporting bugs helps reduce the amount of bug traffic we need to look at. We’ll usually ask you to try Nightly anyway before continuing the troubleshooting process.
See installing from Flatpak for installation notes.