Working with IntelliJ IDEA

Version 5.1 by Vincent Massol on 2018/08/25 10:10

Install IntelliJ IDEA

Get the source for XWiki

The source for XWiki is available via a source repository.

Create an IntelliJ IDEA project

IntelliJ IDEA supports Maven out of the box so all you need to do is open the pom.xml file for the project you wish to build/debug.

Building sources

In IDEA's menu, click on Build > Make Project.

Troubleshooting

Plenty of errors in imports

This mean IDEA wasn't able to resolve the dependencies of the module you're in. One typical cause is because IDEA failed to read the XWiki Maven POMs. And one reason for that is that XWiki requires a very recent version of Maven (3.5.4 as of this writing), while IDEA embeds an oldish version (3.3.9 as of this writing). This is causing problems such as the one in the following screenshot, preventing IDEA from resolving dependencies:

maven-idea-bug.png

org.suigeneris.jrcs.rcs package problems

IDEA will highlight and compilation may fail too depending on the version of IDEA you're using. The reason is because this package is called rcs which is a special name that is ignored by default by IntelliJ. Fix:


    • On old versions: File > Settings... > General > ignore files and folders : remove the rcs and RCS entries (you can safely remove this as xwiki does not use the rcs versioning system).
    • On more recent versions: File Types, then Ignore Files and Folders at the bottom. Remove rcs from the list.
Tags:
   

Get Connected