-

Maven - 构建自动化

构建自动化定义为一种场景：一旦该工程成功构建完成，其相关的依赖工程即开始构建，目的是为了保证其依赖项目的稳定。

实例

考虑一个团队正在开发一个关于总线核心 Api（称其为 bus-core-api）的工程，依赖它的工程有 2 个，分别为网页 UI（称其为 app-web-ui）和应用程序桌面 UI（称其为 app-desktop-ui）。

app-web-ui 工程使用 1.0-SNAPSHOT 总线核心 Api 工程，其 POM 文件如下：

  1. <project xmlns="http://maven.apache.org/POM/4.0.0" 
  2.    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3.    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
  4.    http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5.    <modelVersion>4.0.0</modelVersion>
  6.    <groupId>app-web-ui</groupId>
  7.    <artifactId>app-web-ui</artifactId>
  8.    <version>1.0</version>
  9.    <packaging>jar</packaging>
  10.    <dependencies>
  11.       <dependency>
  12.       <groupId>bus-core-api</groupId>
  13.          <artifactId>bus-core-api</artifactId>
  14.          <version>1.0-SNAPSHOT</version>
  15.       </dependency>
  16.    </dependencies>
  17. </project>

app-desktop-ui 工程也正在使用 1.0-SNAPSHOT 总线核心 Api 工程，其 POM 文件如下：

  1. <project xmlns="http://maven.apache.org/POM/4.0.0"
  2.    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3.    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
  4.    http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5.    <modelVersion>4.0.0</modelVersion>
  6.    <groupId>app-desktop-ui</groupId>
  7.    <artifactId>app-desktop-ui</artifactId>
  8.    <version>1.0</version>
  9.    <packaging>jar</packaging>
  10.    <dependencies>
  11.       <dependency>
  12.       <groupId>bus-core-api</groupId>
  13.          <artifactId>bus-core-api</artifactId>
  14.          <version>1.0-SNAPSHOT</version>
  15.       </dependency>
  16.    </dependencies>
  17. </project>

bus-core-api 工程的 POM 文件如下：

  1. <project xmlns="http://maven.apache.org/POM/4.0.0" 
  2.    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3.    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
  4.    http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5.    <modelVersion>4.0.0</modelVersion>
  6.    <groupId>bus-core-api</groupId>
  7.    <artifactId>bus-core-api</artifactId>
  8.    <version>1.0-SNAPSHOT</version>
  9.    <packaging>jar</packaging>   
  10. </project>

现在，app-web-ui 和 app-desktop-ui 工程的团队需要保证当 bus-core-api 工程有变化时他们自己相应的工程可以随时被构建。

使用快照可以保证最新的 bus-core-api 工程可以被使用，但是为了达到上述的需求，我们仍需做一些额外的工作。

我们有 2 种方式：

  • 在 bus-core-api 的 pom 文件里添加一个编译目标来提醒 app-web-ui 工程和 app-desktop-ui 工程启动创建。
  • 使用一个持续集成（CI）的服务器，比如 Hudson，来实现自动化创建。

使用 Maven

更新 bus-core-api 工程的 pom.xml 文件

  1. <project xmlns="http://maven.apache.org/POM/4.0.0" 
  2.    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  3.    xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 
  4.    http://maven.apache.org/xsd/maven-4.0.0.xsd">
  5.    <modelVersion>4.0.0</modelVersion>
  6.    <groupId>bus-core-api</groupId>
  7.    <artifactId>bus-core-api</artifactId>
  8.    <version>1.0-SNAPSHOT</version>
  9.    <packaging>jar</packaging>
  10.    <build>
  11.    <plugins>
  12.    <plugin>
  13.    <artifactId>maven-invoker-plugin</artifactId>
  14.    <version>1.6</version>
  15.       <configuration>
  16.          <debug>true</debug>
  17.          <pomIncludes>
  18.             <pomInclude>app-web-ui/pom.xml</pomInclude>
  19.             <pomInclude>app-desktop-ui/pom.xml</pomInclude> 
  20.          </pomIncludes>
  21.       </configuration>
  22.       <executions>
  23.          <execution>
  24.             <id>build</id>
  25.             <goals>
  26.                <goal>run</goal>
  27.             </goals>
  28.          </execution>
  29.       </executions>
  30.    </plugin>
  31.    </plugins>
  32.    <build>
  33. </project>

打开命令终端，进入到 C:\ > MVN > bus-core-api 的目录下，然后执行如下的 mvn 的命令。

  1. C:\MVN\bus-core-api>mvn clean package -U

Maven 将会开始构建 bus-core-api 工程，输出日志如下：

  1. [INFO] Scanning for projects...
  2. [INFO] ------------------------------------------------------------------
  3. [INFO] Building bus-core-api
  4. [INFO]    task-segment: [clean, package]
  5. [INFO] ------------------------------------------------------------------
  6. ...
  7. [INFO] [jar:jar {execution: default-jar}]
  8. [INFO] Building jar: C:\MVN\bus-core-ui\target\
  9. bus-core-ui-1.0-SNAPSHOT.jar
  10. [INFO] ------------------------------------------------------------------
  11. [INFO] BUILD SUCCESSFUL
  12. [INFO] ------------------------------------------------------------------

一旦 bus-core-api 构建成功，Maven 将会自动开始构建 app-web-ui 项目， 日志如下：

  1. [INFO] ------------------------------------------------------------------
  2. [INFO] Building app-web-ui 
  3. [INFO]    task-segment: [package]
  4. [INFO] ------------------------------------------------------------------
  5. ...
  6. [INFO] [jar:jar {execution: default-jar}]
  7. [INFO] Building jar: C:\MVN\app-web-ui\target\
  8. app-web-ui-1.0-SNAPSHOT.jar
  9. [INFO] ------------------------------------------------------------------
  10. [INFO] BUILD SUCCESSFUL
  11. [INFO] ------------------------------------------------------------------

等到 app-web-ui 创建成功，Maven 接着开始构建 app-desktop-ui 工程，日志输出如下：

  1. [INFO] ------------------------------------------------------------------
  2. [INFO] Building app-desktop-ui 
  3. [INFO]    task-segment: [package]
  4. [INFO] ------------------------------------------------------------------
  5. ...
  6. [INFO] [jar:jar {execution: default-jar}]
  7. [INFO] Building jar: C:\MVN\app-desktop-ui\target\
  8. app-desktop-ui-1.0-SNAPSHOT.jar
  9. [INFO] -------------------------------------------------------------------
  10. [INFO] BUILD SUCCESSFUL
  11. [INFO] -------------------------------------------------------------------

使用持续集成服务器（CI）

由于开发人员不需要每次多一个新的依赖工程时都去更新 bus-core-api 工程的 pom 文件， 因此使用一个持续集成的服务器更加合适，例如，添加一个新的 app-mobile-ui 的工程，它同样依赖于 bus-core-ui 工程。Hudson 将会借助 Maven 的依赖管理功能实现工程的自动化创建。

automated build

Hunson 把每次创建工程看做一个工作。一旦工程代码合入到 svn 或者其他任何的映射到Hudson上的代码源管理工具上，Hunson 便开始一次的创建工作，等到该工作完成后，它将会自动创建其他相关的依赖工作或者依赖工程。

在上面的例子中，当 bus-core-api 的源代码在 SVN 上有更新时， Hudson 将会启动创建。当创建完成后，Hudson 开始自动寻找其依赖的工程，然后启动 app-web-ui 和 app-desktop-ui 工程。

© 2023 mianshi8.net MIT license