86 lines
3.1 KiB
Markdown
86 lines
3.1 KiB
Markdown
---
|
|
parent: Set up a local workspace
|
|
grand_parent: Getting into the code
|
|
nav_order: 99
|
|
---
|
|
|
|
# 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](intellij-11-code-into-ide.md).
|
|
|
|
## 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:
|
|
|
|
```text
|
|
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:
|
|
|
|
```text
|
|
> 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:
|
|
|
|
```text
|
|
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
|
|
|
|
```text
|
|
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
|
|
```
|