tycho-eclipse:eclipse-run

Full name:

org.eclipse.tycho:tycho-eclipse-plugin:4.0.9:eclipse-run

Description:

Launch an eclipse process with arbitrary commandline arguments. The eclipse installation is defined by the dependencies to bundles specified.

Attributes:

Requires a Maven project to be executed.
The goal is thread-safe and supports parallel builds.

Optional Parameters

Name	Type	Since	Description
`<addDefaultDependencies>`	`boolean`	`-`	Whether to add default dependencies to bundles org.eclipse.equinox.launcher, org.eclipse.osgi and org.eclipse.core.runtime. Default: `true`
`<appArgLine>`	`String`	`-`	Arbitrary applications arguments to set on the command line. It is recommended to use `applicationArgs` instead because it provides more explicit control over argument separation and content, avoiding the need to quote arguments that contain spaces. See also: applicationArgs
`<applicationArgs>`	`List<String>`	`0.24.0`	List of applications arguments set on the command line. Example: `<applicationArgs> <arg>-buildfile</arg> <arg>build-test.xml</arg> </applicationArgs>` Alias: `applicationsArgs`
`<argLine>`	`String`	`-`	Arbitrary JVM options to set on the command line. It is recommended to use `jvmArgs` instead because it provides more explicit control over argument separation and content, avoiding the need to quote arguments that contain spaces. See also: jvmArgs
`<bundleStartLevel>`	`BundleStartLevel[]`	`-`	Bundle start level and auto start configuration used by the eclipse runtime. Example: <bundleStartLevel> <bundle> <id>foo.bar.myplugin</id> <level>6</level> <autoStart>true</autoStart> </bundle> </bundleStartLevel>
`<clearWorkspaceBeforeLaunch>`	`boolean`	`-`	Whether the workspace should be cleared before running eclipse. If `false` and a workspace from a previous run exists, that workspace is reused. Default: `true`
`<defaultStartLevel>`	`BundleStartLevel`	`-`	The default bundle start level and auto start configuration used by the runtime for bundles where the start level/auto start is not configured in `bundleStartLevel`. Example: <defaultStartLevel> <level>6</level> <autoStart>true</autoStart> </defaultStartLevel>
`<dependencies>`	`List<Dependency>`	`-`	Dependencies which will be resolved transitively to make up the eclipse runtime. Example: <dependencies> <dependency> <artifactId>org.eclipse.ant.core</artifactId> <type>eclipse-plugin</type> </dependency> </dependencies>
`<environmentVariables>`	`Map<String,String>`	`-`	Additional environments to set for the forked JVM.
`<executionEnvironment>`	`String`	`-`	Execution environment profile name used to resolve dependencies. Default: `JavaSE-17`
`<forkedProcessTimeoutInSeconds>`	`int`	`-`	Kill the forked process after a certain number of seconds. If set to 0, wait forever for the process, never timing out. User Property: `eclipserun.timeout`
`<installation>`	`File`	`-`	Allows to use a prebuild installation to perform the run instead of one assembled by Tycho
`<jvmArgs>`	`List<String>`	`0.25.0`	List of JVM arguments set on the command line. Example: `<jvmArgs> <arg>-Xdebug<arg> <arg>-Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=1044</arg> </jvmArgs>`
`<project>`	`MavenProject`	`-`	No description. User Property: `project`
`<repositories>`	`List<Repository>`	`-`	p2 repositories which will be used to resolve dependencies. Example: <repositories> <repository> <id>juno</id> <layout>p2</layout> <url>https://download.eclipse.org/releases/juno</url> </repository> </repositories>
`<skip>`	`boolean`	`-`	Whether to skip mojo execution. Default: `false` User Property: `eclipserun.skip`
`<work>`	`File`	`-`	Work area. This includes: <work>/configuration: The configuration area (-configuration) <work>/data: The data ('workspace') area (-data) Default: `${project.build.directory}/eclipserun-work`

Parameter Details

<addDefaultDependencies>

Whether to add default dependencies to bundles org.eclipse.equinox.launcher, org.eclipse.osgi and org.eclipse.core.runtime.

Type: boolean
Required: No
Default: true

<appArgLine>

Arbitrary applications arguments to set on the command line. It is recommended to use applicationArgs instead because it provides more explicit control over argument separation and content, avoiding the need to quote arguments that contain spaces.
See also: applicationArgs

Type: java.lang.String
Required: No

<applicationArgs>

List of applications arguments set on the command line. Example: <applicationArgs> <arg>-buildfile</arg> <arg>build-test.xml</arg> </applicationArgs>

Type: java.util.List<java.lang.String>
Since: 0.24.0
Required: No
Alias: applicationsArgs

<argLine>

Arbitrary JVM options to set on the command line. It is recommended to use jvmArgs instead because it provides more explicit control over argument separation and content, avoiding the need to quote arguments that contain spaces.
See also: jvmArgs

Type: java.lang.String
Required: No

<bundleStartLevel>

Bundle start level and auto start configuration used by the eclipse runtime. Example:

<bundleStartLevel>
  <bundle>
    <id>foo.bar.myplugin</id>
    <level>6</level>
    <autoStart>true</autoStart>
  </bundle>
</bundleStartLevel>

Type: org.eclipse.sisu.equinox.launching.BundleStartLevel[]
Required: No

<clearWorkspaceBeforeLaunch>

Whether the workspace should be cleared before running eclipse.

If false and a workspace from a previous run exists, that workspace is reused.

Type: boolean
Required: No
Default: true

<defaultStartLevel>

The default bundle start level and auto start configuration used by the runtime for bundles where the start level/auto start is not configured in bundleStartLevel. Example:

  <defaultStartLevel>
    <level>6</level>
    <autoStart>true</autoStart>
  </defaultStartLevel>

Type: org.eclipse.sisu.equinox.launching.BundleStartLevel
Required: No

<dependencies>

Dependencies which will be resolved transitively to make up the eclipse runtime. Example:

<dependencies>
 <dependency>
  <artifactId>org.eclipse.ant.core</artifactId>
  <type>eclipse-plugin</type>
 </dependency>
</dependencies>

Type: java.util.List<org.apache.maven.model.Dependency>
Required: No

<environmentVariables>

Additional environments to set for the forked JVM.

Type: java.util.Map<java.lang.String, java.lang.String>
Required: No

<executionEnvironment>

Execution environment profile name used to resolve dependencies.

Type: java.lang.String
Required: No
Default: JavaSE-17

<forkedProcessTimeoutInSeconds>

Kill the forked process after a certain number of seconds. If set to 0, wait forever for the process, never timing out.

Type: int
Required: No
User Property: eclipserun.timeout

<installation>

Allows to use a prebuild installation to perform the run instead of one assembled by Tycho

Type: java.io.File
Required: No

<jvmArgs>

List of JVM arguments set on the command line. Example: <jvmArgs> <arg>-Xdebug<arg> <arg>-Xrunjdwp:transport=dt_socket,server=y,suspend=n,address=1044</arg> </jvmArgs>

Type: java.util.List<java.lang.String>
Since: 0.25.0
Required: No

<project>

No description.

Type: org.apache.maven.project.MavenProject
Required: No
User Property: project

<repositories>

p2 repositories which will be used to resolve dependencies. Example:

<repositories>
 <repository>
  <id>juno</id>
  <layout>p2</layout>
  <url>https://download.eclipse.org/releases/juno</url>
 </repository>
</repositories>

Type: java.util.List<org.eclipse.tycho.eclipserun.Repository>
Required: No

<skip>

Whether to skip mojo execution.

Type: boolean
Required: No
User Property: eclipserun.skip
Default: false

<work>

Work area. This includes:

<work>/configuration: The configuration area (-configuration)
<work>/data: The data ('workspace') area (-data)

Type: java.io.File
Required: No
Default: ${project.build.directory}/eclipserun-work