Ipr

Build runner

Select Ipr from the drop-down list. This runner generates a JUnit task for the tests in the project.

Artifact Paths

Use this field to specify directories containing Build Artifact or file names as a comma-separated string. If a directory is specified its contents will be uploaded to the server. \(!) In version 3.1 this field is located on the 1.General Settings page.

Path to the project file

Use this field to specify the path to the project file (.ipr). This build runner requires this file to understand the structure of the project.

tip

Detect global libraries and module-based JDK in *.iml files

If this option is checked, the form all of the module files will be automatically scanned for references to the global libraries and module JDKs when saved. This helps you ensure all references will be properly resolved.

warning

When this option is selected, the process of opening and saving the build runner settings may become time-consuming, because it involves loading and parsing all project module files.

Build working directory

Enter a building working directory is your CVS checkout mode is set to Do not checkout files automatically.

<path_variable_name>

This field appears, if the project file contains path macros, defined in the Path Variables dialog of IntelliJ IDEA's Settings dialog. In the Set value to field, specify a path to project resources, to be used on different build agents.

JDK Home

Use this field to specify JDK home for the project.

note

When building with the Ipr runner, this JDK will be used to compile the sources of corresponding IDEA modules. For Inspections and Duplicate Finder builds, this JDK will be used internally to resolve the Java API used in your project. To run the build process itself the JDK specified in the JAVA_HOME environment variable will be used.

JDK jar file patterns

Click this link to open a text area, where you can define templates for the jar files of the project JDK. Use Ant rules to define the jar file patterns. The default value is used for Linux and Windows operating systems:

jre/lib/*.jar

For Mac OS X, use the following lines:

lib/*.jar ../Classes/*.jar

IDEA Home

If your project uses the IDEA JDK, specify the location of IDEA's home directory

IDEA Jar Files Patterns

Click this link to open a text area, where you can define templates for the jar files of the IDEA JDK.

Path to Library

Use this field to specify root directory which contains library jar files.

Library Jar Files Patterns

Click this link to open a text area, where you can define templates for the jar files of the library (default *.jar)

JVM command line parameters

Specify the desired Java Virtual Machine parameters, such as maximum heap size or parameters that enable remote debugging. These settings are passed to the JVM used to run your build. Example:

-Xmx512m -Xms256m

Run before build

In the appropriate fields, enter the Ant scripts and targets (optional) that you want to run prior to starting the build. The path to the Ant file should be relative to the project root directory.

Run after build

In the appropriate fields, enter the Ant scripts and targets (optional) that you want to run after the build is completed. The path to the Ant file should be relative to the project root directory.

Test patterns

Click the Type test patterns link, and specify the required test patterns in a text area. These patterns are used to generate parameters of the batchtest JUnit task section. Each pattern generates either include or exclude section. These patterns are also used to compose classpath for the test run. Each module mentioned in the patterns adds its classpath to the whole classpath. Each pattern should be placed on a separate line and has the following format:

[-]moduleName:[testFileNamePattern]

where:

• [-]: If a pattern starts with minus character, the corresponding files will be excluded from the build process.

• moduleName: this name can contain wildcards.

• [ testFileNamePattern] : Default value for testFileNamePattern is **/*Test.java , i.e. all files ending with Test.java in all directories. You can use Ant syntax for file patterns.The sample below includes all test files from modules ending with "test" and excludes all files from packages containing the "ui" subpackage: *test:**/*Test.java -*:**/ui/**/*.java

Classpath in Tests

By default the whole classpath is composed of all classpaths of the modules used to get tests from. The following two options define whether you will use the default classpath, or take it from the specified module.

Override classpath in tests

If this option is checked, you can define test classpath from a single, explicitly specified module.

Module name to use JDK and classpath from

If the option Override classpath in tests is checked, you have to specify the module, where the classpath to be used for tests is specified.

JUnit Fork mode

Select the desired fork mode from the combobox:

• Do not fork: fork is disabled.

• Fork per test: fork is enabled, and each test class runs in a separate JVM

• Fork once: fork is enabled, and all test classes run in a single JVM

New classloader instance for each test

Check this option, if you want a new classloader to be instantiated for each test case. This option is available only if Do not fork option is selected.

Include Ant runtime

Check this option to add Ant classes, required to run JUnit tests. This option is available if fork mode is enabled (Fork per test or Fork once).

JVM executable

Specify the command that will be used to invoke JVM. This option is available if fork mode is enabled (Fork per test or Fork once).

Stop build on error

Check this option, if you want the build to stop if an error occurs during test run.

JVM command line parameters for JUnit

Specify JVM parameters to be passed to JUnit task.

Tests working directory

Specify the path to the working directory for tests.

Tests timeout

Specify the lapse of time in milliseconds, after which test will be canceled. This value is ignored, if Do not fork option is selected.

Verbose Ant

Check this option, if the generated JUnit task has to produce verbose output in ant terms.