Skip to main content Link Menu Expand (external link) Document Search Copy Copied
Developer Documentation

Trouble shooting

Changes in src/main/resources/csl-styles are shown

You need to remove these directories from the “Directory Mappings” in IntelliJ. Look for the setting in preferences. A long how-to is contained in Step 1: Get the code into IntelliJ.

Issues with buildSrc

  1. Open the context menu of buildSrc.
  2. Select “Load/Unload modules”.
  3. Unload jabRef.buildSrc.

Issues with generated source files

In rare cases you might encounter problems due to out-dated automatically generated source files. Running gradle task “clean” (Command line: ./gradlew clean) deletes these old copies. Do not forget to run at least ./gradlew assemble or ./gradlew eclipse afterwards to regenerate the source files.

Issue with “Module org.jsoup” not found, required by org.jabref

Following error message appears:

Error occurred during initialization of boot layer
java.lang.module.FindException: Module org.jsoup not found, required by org.jabref

This can include different modules.

  1. Go to File -> Invalidate caches…
  2. Check “Clear file system cache and Local History”.
  3. Check “Clear VCS Log caches and indexes”.
  4. Uncheck the others.
  5. Click on “Invalidate and Restart”.
  6. After IntelliJ restarted, you have to do the “buildSrc”, “Log4JAppender”, and “src-gen” steps again.

Issues with OpenJFX libraries in local maven repository

There might be problems with building if you have OpenJFX libraries in local maven repository, resulting in errors like this:

 > Could not find javafx-fxml-20-mac.jar (org.openjfx:javafx-fxml:20).
     Searched in the following locations:
         file:<your local maven repository path>/repository/org/openjfx/javafx-fxml/20/javafx-fxml-20-mac.jar

As a workaround, you can remove all local OpenJFX artifacts by deleting the whole OpenJFX folder from specified location.

Issues with JournalAbbreviationLoader

In case of a NPE at Files.copy at org.jabref.logic.journals.JournalAbbreviationLoader.loadRepository(JournalAbbreviationLoader.java:30) ~[classes/:?], invalidate caches and restart IntelliJ. Then, Build -> Rebuild Project.

If that does not help:

  1. Save/Commit all your work
  2. Close IntelliJ
  3. Delete all non-versioned items: git clean -xdf. This really destroys data
  4. Execute ./gradlew run
  5. Start IntelliJ and try again.

Java installation

An indication that JAVA_HOME is not correctly set or no JDK 21 is installed in the IDE is following error message:

compileJava FAILED

FAILURE: Build failed with an exception.

* What went wrong:
Execution failed for task ':compileJava'.
> java.lang.ExceptionInInitializerError (no error message)

Another indication is following output

java.lang.UnsupportedClassVersionError: org/javamodularity/moduleplugin/ModuleSystemPlugin has been compiled by a more recent version of the Java Runtime (class file version 55.0), this version of the Java Runtime only recognizes class file versions up to 52.0