Plugin Documentation
Goals available for this plugin:
Goal | Description |
---|---|
scm:add | Add a file set to the project. |
scm:bootstrap | Pull the project source from the configured scm and execute the configured goals. |
scm:branch | Branch the project. |
scm:changelog | Dump changelog contents to console. It is mainly used to test maven-scm-api's changelog command. |
scm:check-local-modification | This mojo will fail the build if there is any local modifications |
scm:checkin | Commit changes to the configured scm url. |
scm:checkout | Get a fresh copy of the latest source from the configured scm url. |
scm:diff | Display the difference of the working copy with the latest copy in the configured scm url. |
scm:edit | Edit/lock a set of files. |
scm:export | Get a fresh exported copy of the latest source from the configured scm url. |
scm:help | Display help information on maven-scm-plugin.
Call mvn scm:help -Ddetail=true -Dgoal=<goal-name> to display parameter details. |
scm:list | Get the list of project files. |
scm:remove | Mark a set of files for deletion. |
scm:status | Display the modification status of the files in the configured scm url. |
scm:tag | Tag the project. |
scm:unedit | Unedit/unlock a set of files. |
scm:untag | Untag the project. |
scm:update | Update the local working copy with the latest source from the configured scm url. |
scm:update-subprojects | Updates all projects in a multi project build. This is useful for users who have adopted the flat project structure where the aggregator project is a sibling of the sub projects rather than sitting in the parent directory. |
scm:validate | Validate scm connection string. |
scm:validate-recursively | Validate scm connection string recursively for all projects |
System Requirements
The following specifies the minimum requirements to run this Maven plugin:
Maven | 3.6.3 |
JDK | 1.8 |
Usage
You should specify the version in your project's plugin configuration:
<project> ... <build> <!-- To define the plugin version in your parent POM --> <pluginManagement> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-scm-plugin</artifactId> <version>2.1.0</version> </plugin> ... </plugins> </pluginManagement> <!-- To use the plugin goals in your POM or parent POM --> <plugins> <plugin> <groupId>org.apache.maven.plugins</groupId> <artifactId>maven-scm-plugin</artifactId> </plugin> ... </plugins> </build> ... </project>
For more information, see "Guide to Configuring Plug-ins"