The instructions below will help you setup the IntelliJ IDEA IDE for Visallo development. These instructions should work with both the Community and Ultimate editions.
- Setup configuration on your host machine.
- Install dependencies on your host machine.
- Install the root module on your host machine.
Since you've most likely already cloned the Visallo code to your local machine, you'll need to import the project into IntelliJ. From the IntelliJ File menu or launch screen, select
Import Project and follow the screenshots below to properly import the project.
Choose the Visallo project directory you've cloned and click the OK button.
Select "Import project from external model" and be sure to choose Maven. Click the Next button.
There are a lot of settings to choose from here. Just make your selections match the screenshot and click Next.
The "build-doclint-none" profile should already be selected. Leave it as is and click the Next button.
There should only be one Maven project to import and it should already be selected. If not, choose visallo and click Next.
This screenshot shows the selection of JDK version 1.8. You may need to click the plus button near the top left to navigate the filesystem to your installation of JDK 1.8 if you've never done it before. Click the Next button once your screen looks similar.
The last step is to name the IntelliJ project. The default should be fine, but you can change it to something else if you really want.
Visallo ships with a collection of useful run configurations for IntelliJ. Unfortunately, importing the project into IntelliJ deletes them from their proper location. To get them back, run the following command from the project root directory.
git checkout .idea/
The above command will re-checkout several files into the
$PROJECT_DIR/.idea/runConfigurations directory. These files are the settings for each of the IntelliJ run configurations that ship with Visallo. They should automatically show up in the
Run -> Edit Configurations dialog in IntelliJ.