invoker:install

Full name:

org.apache.maven.plugins:maven-invoker-plugin:3.4.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 - 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.
<useLocalRepository> boolean 3.2.1 if the local repository is not used as test repo, the parameter can force get artifacts from local repo if available instead of download the artifacts again.
Default value is: false.
User property is: invoker.useLocalRepository.

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
  • 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

<useLocalRepository>

if the local repository is not used as test repo, the parameter can force get artifacts from local repo if available instead of download the artifacts again.
  • Type: boolean
  • Since: 3.2.1
  • Required: No
  • User Property: invoker.useLocalRepository
  • Default: false