Skip to content

Update IntelliJ setup instructions with Gradle workaround#14234

Merged
koppor merged 13 commits into
mainfrom
koppor-patch-3
Nov 21, 2025
Merged

Update IntelliJ setup instructions with Gradle workaround#14234
koppor merged 13 commits into
mainfrom
koppor-patch-3

Conversation

@koppor

@koppor koppor commented Nov 5, 2025

Copy link
Copy Markdown
Member

I had issues on a Linux machine. Here a tested workaround.

Steps to test

Setup development environment on Debian 12.

Mandatory checks

  • I own the copyright of the code submitted and I license it under the MIT license
  • I manually tested my changes in running JabRef (always required)
  • [/] I added JUnit tests for changes (if applicable)
  • [/] I added screenshots in the PR description (if change is visible to the user)
  • [/] I described the change in CHANGELOG.md in a way that is understandable for the average user (if change is visible to the user)
  • [/] I checked the user documentation: Is the information available and up to date? If not, I created an issue at https://github.com/JabRef/user-documentation/issues or, even better, I submitted a pull request updating file(s) in https://github.com/JabRef/user-documentation/tree/main/en.

@koppor koppor marked this pull request as ready for review November 5, 2025 09:44
@koppor koppor enabled auto-merge November 5, 2025 09:44
@koppor koppor requested a review from subhramit November 5, 2025 09:44

## Pre-condition: Gradle caches filled

On Linux, with IntelliJ IDEA 2025.2.4 (Ultimate Edition), there are issues with importing.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Are we sure the community edition doesn't have this issue?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Haven't tried yet. Can try on Monday.

@Siedlerchr

Copy link
Copy Markdown
Member

Have you tried to increse java memory heap size in intellij?
Did you import as gradle project after cloning?

@koppor

koppor commented Nov 6, 2025

Copy link
Copy Markdown
Member Author

Have you tried to increse java memory heap size in intellij?

No. 16 GB RAM of the machine was already full.

IntelliJ ran OKish, but gradle was unable to compile its Kotlin build files.

Did you import as gradle project after cloning?

Happens automatically by IntelliJ

Co-authored-by: Subhramit Basu <subhramit.bb@live.in>
@koppor koppor marked this pull request as draft November 6, 2025 23:23
auto-merge was automatically disabled November 6, 2025 23:23

Pull request was converted to draft

@koppor

koppor commented Nov 6, 2025

Copy link
Copy Markdown
Member Author

Converted to draft - needs to be checked with IntelliJ Community Edition

@koppor koppor mentioned this pull request Nov 10, 2025
1 task
@Siedlerchr

Copy link
Copy Markdown
Member

what's the status here`is this still necessary?

@koppor

koppor commented Nov 14, 2025

Copy link
Copy Markdown
Member Author

what's the status here`is this still necessary?

IDK.

It worked with the Community Edition on Debian 12.

Step to test:

  1. Clean VM (maybe https://github.com/JabRef/jabref/tree/main/scripts/vms/debian-12)
  2. Test intellij ultimate
  3. Clean VM (maybe https://github.com/JabRef/jabref/tree/main/scripts/vms/debian-12)
  4. Test intellij community

By "Test" I mean: First the normal instructions - and then this patched ones - and see if the normal ones do not work and the patched ones do. Maybe, we need to add "If you use ultimate" - or we need to add some hints that if gradle import goes wrong.

@koppor koppor added the status: ready-for-review Pull Requests that are ready to be reviewed by the maintainers label Nov 20, 2025
@koppor koppor added status: ready-for-review Pull Requests that are ready to be reviewed by the maintainers and removed status: ready-for-review Pull Requests that are ready to be reviewed by the maintainers labels Nov 20, 2025
@github-actions github-actions Bot marked this pull request as ready for review November 20, 2025 13:28
@koppor

koppor commented Nov 20, 2025

Copy link
Copy Markdown
Member Author

Side track - workflow https://github.com/JabRef/jabref/blob/main/.github/workflows/on-pr-labeled-update-pr-status.yml works

Just adding label "ready for review" changes also the status of the PR.

image

@Siedlerchr Siedlerchr added this pull request to the merge queue Nov 20, 2025
@github-merge-queue github-merge-queue Bot removed this pull request from the merge queue due to failed status checks Nov 20, 2025
@koppor koppor merged commit ff2e898 into main Nov 21, 2025
70 checks passed
@koppor koppor deleted the koppor-patch-3 branch November 21, 2025 21:17
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

status: ready-for-review Pull Requests that are ready to be reviewed by the maintainers

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants