maven的scm插件介绍及使用示例

拼搏现实的明天。 2022-09-18 11:44 242阅读 0赞

![rmMvIv.gif][]

Maven中为我们集成了软件配置管理的（SCM：Software Configuration Management）功能，他可以支持我们常用SVN、CVS等，到现在我使用的1.8.1版本，共支持18个命令：

scm:branch - branch the project（创建项目的分支）
    scm:validate - validate the scm information in the pom（校验SCM的配置信息）
    scm:add - command to add file（增加一个文件）
    scm:unedit - command to stop editing the working copy（停止编辑当前COPY）
    scm:export - command to get a fresh exported copy（拉一个全新的分支）
    scm:bootstrap - command to checkout and build a project（checkout并编译工程）
    scm:changelog - command to show the source code revisions（显示源码版本）
    scm:list - command for get the list of project files（列出工程的文件）
    scm:checkin - command for commiting changes（提交变更）
    scm:checkout - command for getting the source code（获取源码）
    scm:status - command for showing the scm status of the working copy（获取本地项目的状态）
    scm:update - command for updating the working copy with the latest changes（从服务器获取最新的版本）
    scm:diff - command for showing the difference of the working copy with the remote one（比较本地与远程服务器的差异）
    scm:update-subprojects - command for updating all projects in a multi project build（更新子项目）
    scm:edit - command for starting edit on the working copy（编辑）
    scm:tag - command for tagging a certain revision（打标签）

#### **常用命令介绍** ####

而我们常用只有以下这两个命令：  
Usage  
The SCM Plugin maps a lot of commands to a variety of scm implementations. But there are only 2 frequently used commands:

checkin - 提交变更
    update - 从服务器上获取最新的版本

#### **配置及使用** ####

其它的SCM都有自己独特的命令来操作提交变更、或从服务器上获取最新的源吗，如SVN及CVS的操作就很不相同，使用Maven担任的SCM机制，就可以使得SCM的操作变得统一，以下是一个SVN配置示例，将以下的示例配置到pom.xml文件中

<project>
      ...
      <packaging>jar</packaging>
      <version>1.0-SNAPSHOT</version>
      <name>SCM Sample Project</name>
      <url>http://somecompany.com</url>
      <scm>
        <connection>scm:svn:http://somerepository.com/svn_repo/trunk</connection>
        <developerConnection>scm:svn:https://somerepository.com/svn_repo/trunk</developerConnection>
        <url>http://somerepository.com/view.cvs</url>
      </scm>
      ...
    </project>

照这样配置好的，现在我们要做提交或者更新，就按如下按行命令  
提交：

mvn -Dmessage="<commit_log_here>" scm:checkin

获取最新版本：

mvn scm:update

#### **SCM支持的连接类型** ####

SCM支持两种连接类型：connection 及 developerConnection。  
以下是一个连接类型为connection的配置示例：

<project>
      ...
      <build>
        [...]
        <plugins>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-scm-plugin</artifactId>
            <version>1.8.1</version>
            <configuration>
              <connectionType>connection</connectionType>
            </configuration>
          </plugin>
          ...
        </plugins
        ...
      </build>
      ...
    </project>

以下是一个连接类型为developerConnection的配置示例：

<project>
      ...
      <build>
        ...
        <plugins>
          <plugin>
            <groupId>org.apache.maven.plugins</groupId>
            <artifactId>maven-scm-plugin</artifactId>
            <version>1.8.1</version>
            <configuration>
              <connectionType>developerConnection</connectionType>
            </configuration>
          </plugin>
          ...
        </plugins
        ...
      </build>
      ...
    </project>

[rmMvIv.gif]: /images/20220828/695346efcf9a4a93ab4d5e289d13f1dc.png