This document is about configuring Gerrit Code Review into an Eclipse workspace for development.
Java 8 or later SDK is required.
In your Eclipse installation’s
add the following line in the
Without this setting, annotation processing does not work reliably and the build is likely to fail with errors like:
Could not write generated class ... javax.annotation.processing.FilerException: Source file already created
AutoAnnotation_Commands_named cannot be resolved to a type
First, generate the Eclipse project by running the
Then, in Eclipse, choose 'Import existing project' and select the
from the current working directory.
gerrit project, right-click on the
eclipse-out folder, select
'Properties', and then under 'Attributes' check 'Derived'.
Note that if you make any changes in the project configuration
that get saved to the
.project file, for example adding Resource
Filters on a folder, they will be overwritten the next time you run
Eclipse project with custom plugins
To add custom plugins to the eclipse project add them to
the same way you would when
bundling in release.war
[[Newer Java versions]]
Java 9 and later are supported, but some adjustments must be done, because Java 8 is still the default:
Add JRE, e.g.: directory: /usr/lib64/jvm/java-9-openjdk, name: java-9-openjdk-9
Change execution environment for gerrit project to: JavaSE-9 (java-9-openjdk-9)
Check that compiler compliance level in gerrit project is set to: 9
Code Formatter Settings
To format source code, Gerrit uses the
tool (version 1.7), which automatically formats code to follow the
style guide. See Code Style for the
instruction how to set up command line tool that uses this formatter.
The Eclipse plugin is provided that allows to format with the same
formatter from within the Eclipse IDE. See
for details how to install it. It’s important to use the same plugin version
PolyGerrit UI is served by
server.go process. To launch it,
run this command:
$ bazel run polygerrit-ui:devserver
Running the Daemon
Duplicate the existing launch configuration:
In Eclipse select Run → Debug Configurations …
Java Application →
Right click, Duplicate
Modify the name to be unique.
Switch to Arguments tab.
-dprogram argument flag to match the path used during 'init'. The template launch configuration resolves to
../gerrit_testsitesince that is what the documentation recommends.
Switch to Common tab.
Change Save as to be Local file.
Close the Debug Configurations dialog and save the changes when prompted.
Part of Gerrit Code Review