Run Configurations Tutorial
These series of steps show how to register and implement a simple Run Configuration. Run Configurations are used to run internal and external processes from within IntelliJ Platform based products. To get familiar with the concept of a Run Configuration refer Run/Debug Configuration section of IntelliJ IDEA Web Help
Consider the runConfiguration sample plugin available in the code samples. See Code Samples on how to set up and run the plugin.
Pre-Requirements
Create an empty plugin project as described in Creating a Plugin Project.
Register a New ConfigurationType
Add new com.intellij.configurationType extension to the plugin.xml
Implement ConfigurationType
Implement ConfigurationType interface registered in the Step 1.
Implement a ConfigurationFactory
Implement a new ConfigurationFactory through which custom run configurations will be created.
Implement corresponding configuration options class extending RunConfigurationOptions to store settings.
Implement a Run Configuration
To make your changes visible from the UI, implement a new Run Configuration.
Note: In most of the cases you can derive a custom Run Configuration class from the RunConfigurationBase. If you need to implement specific settings externalization rules and I/O behaviour, use RunConfiguration interface.
Create and Implement Run Configuration UI Form
Make sure UI Designer plugin is enabled.
Create a new UI form that defines, how an inner part of the new Run Configuration should look like.
Default Run Configuration will be looking like this:
Bind the UI Form
The UI Form should be bound with a Java class responsible for handling UI components logic.
Compile and Run the Plugin
Refer to Running and Debugging a Plugin.
After going through the steps described above you can create a custom Run Configuration from your plugin.
