invoker:install

Full name:

org.apache.maven.plugins:maven-invoker-plugin:3.0.0:install

Description:

Installs the project artifacts of the main build into the local repository as a preparation to run the sub projects. More precisely, all artifacts of the project itself, all its locally reachable parent POMs and all its dependencies from the reactor will be installed to the local repository.

Attributes:

  • Requires a Maven project to be executed.
  • Requires dependency resolution of artifacts in scope: runtime.
  • The goal is thread-safe and supports parallel builds.
  • Since version: 1.2.
  • Binds by default to the lifecycle phase: pre-integration-test.

Required Parameters

Name Type Since Description
localRepositoryPath File 1.2 The path to the local repository into which the project artifacts should be installed for the integration tests. If not set, the regular local repository will be used. To prevent soiling of your regular local repository with possibly broken artifacts, it is strongly recommended to use an isolated repository for the integration tests (e.g. ${project.build.directory}/it-repo).
Default value is: ${session.localRepository.basedir}.
User property is: invoker.localRepositoryPath.

Optional Parameters

Name Type Since Description
extraArtifacts String[] 1.6 Extra dependencies that need to be installed on the local repository.
Format:
groupId:artifactId:version:type:classifier
Examples:
org.apache.maven.plugins:maven-clean-plugin:2.4:maven-plugin
org.apache.maven.plugins:maven-clean-plugin:2.4:jar:javadoc
If the type is 'maven-plugin' the plugin will try to resolve the artifact using plugin remote repositories, instead of using artifact remote repositories.
skipInstallation boolean 1.4 A flag used to disable the installation procedure. This is primarily intended for usage from the command line to occasionally adjust the build.
Default value is: false.
User property is: invoker.skip.

Parameter Details

extraArtifacts:

Extra dependencies that need to be installed on the local repository.
Format:
groupId:artifactId:version:type:classifier
Examples:
org.apache.maven.plugins:maven-clean-plugin:2.4:maven-plugin
org.apache.maven.plugins:maven-clean-plugin:2.4:jar:javadoc
If the type is 'maven-plugin' the plugin will try to resolve the artifact using plugin remote repositories, instead of using artifact remote repositories.
  • Type: java.lang.String[]
  • Since: 1.6
  • Required: No

localRepositoryPath:

The path to the local repository into which the project artifacts should be installed for the integration tests. If not set, the regular local repository will be used. To prevent soiling of your regular local repository with possibly broken artifacts, it is strongly recommended to use an isolated repository for the integration tests (e.g. ${project.build.directory}/it-repo).
  • Type: java.io.File
  • Since: 1.2
  • Required: Yes
  • User Property: invoker.localRepositoryPath
  • Default: ${session.localRepository.basedir}

skipInstallation:

A flag used to disable the installation procedure. This is primarily intended for usage from the command line to occasionally adjust the build.
  • Type: boolean
  • Since: 1.4
  • Required: No
  • User Property: invoker.skip
  • Default: false