高效開發(fā)Maven架構(gòu)設(shè)計圖解/掌握項目工程自動化技巧

作者：肖哥彈架構(gòu) 2024-10-06 13:05:43

settings.xml?中的?<localRepository/>?標(biāo)簽用于定義本地倉庫的位置。如果未指定，Maven 默認(rèn)使用?~/.m2/repository（用戶主目錄下的?.m2?文件夾內(nèi)的?repository）。

Maven是一個項目管理和構(gòu)建自動化工具，主要服務(wù)于基于Java的項目。它使用一個名為POM（Project Object Model）的XML文件來描述項目的構(gòu)建過程、依賴、插件等信息。

0、基本操作

安裝Maven

wget http://apache.mirrors.tds.net/maven/maven-3/3.6.3/binaries/apache-maven-3.6.3-bin.tar.gz
tar -xzf apache-maven-3.6.3-bin.tar.gz
cd apache-maven-3.6.3

配置環(huán)境變量

export M2_HOME=/path/to/maven
export M2=$M2_HOME/bin
export PATH=$M2:$PATH

1、maven 框架設(shè)計

Maven 圖說明

Maven 項目：是使用Maven構(gòu)建的軟件項目。
項目對象模型 POM：是Maven項目的核心，它是一個XML文件，描述了項目的構(gòu)建過程、依賴、插件等信息。
坐標(biāo)：包括GroupId、ArtifactId和Version，它們是Maven項目的唯一標(biāo)識。
依賴：項目所依賴的外部庫和模塊。
插件：用于項目構(gòu)建過程中的特定任務(wù)，例如編譯、測試、打包。
構(gòu)建配置：定義了項目的構(gòu)建過程和細(xì)節(jié)。
構(gòu)建生命周期：Maven的構(gòu)建生命周期定義了項目構(gòu)建的一系列階段，如編譯、測試、打包、部署等。
編譯(compile) ：將源代碼編譯成字節(jié)碼。
測試(test) ：運行測試用例。
打包(package) ：將編譯后的代碼打包成JAR、WAR等格式。
部署(deploy) ：將最終的包部署到遠(yuǎn)程倉庫或其他服務(wù)器上。
清理(clean) ：清理項目生成的所有生成物。
目標(biāo)：Maven 插件可以定義多個目標(biāo)，每個目標(biāo)都是一個任務(wù)，可以在構(gòu)建生命周期中執(zhí)行。
依賴樹：Maven解析項目的依賴關(guān)系，構(gòu)建依賴樹。
倉庫：存儲項目依賴的庫和插件的服務(wù)器，分為本地倉庫和遠(yuǎn)程倉庫。
本地倉庫：存儲所有項目依賴的本地文件夾。
遠(yuǎn)程倉庫：中央倉庫或其他私有倉庫，用于下載和上傳依賴。

2、Maven settings配置相關(guān)組件和模塊

settings.xml: Maven的主要配置文件。

本地倉庫: 存儲所有下載的依賴和插件的本地目錄。

交互模式: 控制Maven是否需要用戶交互。

插件注冊表: 控制是否使用插件注冊表。

離線模式: 當(dāng)無法訪問外部網(wǎng)絡(luò)時使用。

插件組 : 定義一組插件組的ID，這可以用來改變插件的查找順序。

服務(wù)器認(rèn)證信息: 存儲用于訪問服務(wù)器的認(rèn)證信息。

鏡像: 定義遠(yuǎn)程倉庫的鏡像地址。

代理服務(wù)器: 定義網(wǎng)絡(luò)代理的配置。

配置文件: 定義一組配置文件，用于不同的構(gòu)建環(huán)境。

激活配置文件: 定義在構(gòu)建時應(yīng)該激活的配置文件。

2.1 模塊介紹

在Maven中， settings.xml 文件主要關(guān)聯(lián)和影響以下Maven的組件和模塊：

2.1.1 本地倉庫（Local Repository） :

settings.xml 中的 <localRepository/> 標(biāo)簽用于定義本地倉庫的位置。如果未指定，Maven 默認(rèn)使用 ~/.m2/repository（用戶主目錄下的 .m2 文件夾內(nèi)的 repository）。

作用：定義本地倉庫的位置，用于存儲所有下載的依賴和插件。
默認(rèn)值： ~/.m2/repository（用戶主目錄下的 .m2 文件夾內(nèi)的 repository）。

<!-- 定義本地倉庫的位置 -->
<localRepository>/path/to/local/repo</localRepository>

2.1.2 交互模式（Interactive Mode） :

<interactiveMode/> 標(biāo)簽控制 Maven 是否在需要輸入時（如輸入密碼）以交互模式運行。

作用：控制 Maven 是否在需要輸入時（如輸入密碼）以交互模式運行。

<!-- 控制 Maven 是否在需要輸入時以交互模式運行 -->
<interactiveMode>true</interactiveMode>

2.1.3 插件注冊表（Plugin Registry） :

<usePluginRegistry/> 標(biāo)簽決定是否使用插件注冊表，這可以加速構(gòu)建過程。

作用：決定是否使用插件注冊表，這可以加速構(gòu)建過程。

<!-- 決定是否使用插件注冊表 -->
<usePluginRegistry>true</usePluginRegistry>

2.1.4 離線模式（Offline Mode） :

<offline/> 標(biāo)簽用于設(shè)置 Maven 是否運行在離線模式。

作用：用于設(shè)置 Maven 是否運行在離線模式。

<!-- 設(shè)置 Maven 是否運行在離線模式 -->
<offline>true</offline>

2.1.5 服務(wù)器（Servers） :

<servers/> 標(biāo)簽用于配置服務(wù)器信息，這包括用于部署到遠(yuǎn)程倉庫的認(rèn)證信息。

作用：用于配置服務(wù)器信息，這包括用于部署到遠(yuǎn)程倉庫的認(rèn)證信息。

<!-- 配置服務(wù)器信息，包括用于部署到遠(yuǎn)程倉庫的認(rèn)證信息 -->
<servers>
  <!-- 服務(wù)器配置 -->
  <server>
    <!-- 服務(wù)器的唯一標(biāo)識 -->
    <id>server1</id>
    <!-- 服務(wù)器的用戶名 -->
    <username>myusername</username>
    <!-- 服務(wù)器的密碼 -->
    <password>mypassword</password>
  </server>
</servers>

2.1.6 鏡像（Mirrors） :

<mirrors/> 標(biāo)簽定義了倉庫鏡像，允許用戶通過更快的鏡像訪問遠(yuǎn)程倉庫。

作用：定義了倉庫鏡像，允許用戶通過更快的鏡像訪問遠(yuǎn)程倉庫。

<!-- 定義倉庫鏡像，允許用戶通過更快的鏡像訪問遠(yuǎn)程倉庫 -->
<mirrors>
  <!-- 鏡像配置 -->
  <mirror>
    <!-- 鏡像的唯一標(biāo)識 -->
    <id>mymirror</id>
    <!-- 指定被鏡像的倉庫 -->
    <mirrorOf>central</mirrorOf>
    <!-- 鏡像的名稱 -->
    <name>My Mirror</name>
    <!-- 鏡像的URL -->
    <url>http://mymirror.com/maven/</url> 
  </mirror>
</mirrors>

2.1.7 代理（Proxies） :

<proxies/> 標(biāo)簽配置代理服務(wù)器的信息，用于在存在網(wǎng)絡(luò)代理的環(huán)境中訪問外部資源。

作用：配置代理服務(wù)器的信息，用于在存在網(wǎng)絡(luò)代理的環(huán)境中訪問外部資源。
代理與鏡像區(qū)別

鏡像（Mirrors）

目的：提高下載速度和可用性。鏡像是遠(yuǎn)程倉庫的本地副本，通常用于提供一個更快的訪問路徑到一個遠(yuǎn)程倉庫，特別是當(dāng)遠(yuǎn)程倉庫很慢或者不可用時。

工作方式：Maven 會從配置的鏡像地址去嘗試下載所需的構(gòu)件（Artifacts）和插件。如果鏡像上有這個構(gòu)件，Maven 就會從鏡像下載，否則它會回退到原始倉庫地址。

使用場景：當(dāng)你位于一個訪問中央倉庫（或其他遠(yuǎn)程倉庫）較慢或者有網(wǎng)絡(luò)限制的地區(qū)時，使用鏡像可以顯著提高構(gòu)建速度。

代理（Proxies）

目的：當(dāng)你需要通過一個網(wǎng)絡(luò)代理來訪問外部網(wǎng)絡(luò)時，配置代理使 Maven 能夠通過這個代理服務(wù)器進(jìn)行所有的外部 HTTP 請求。
工作方式：Maven 配置了代理后，所有的 Maven 網(wǎng)絡(luò)請求（包括從遠(yuǎn)程倉庫下載構(gòu)件和上傳構(gòu)件到遠(yuǎn)程倉庫）都會通過指定的代理服務(wù)器進(jìn)行。
使用場景：在公司內(nèi)網(wǎng)或者某些需要通過 HTTP 代理訪問外網(wǎng)的環(huán)境，配置代理使得 Maven 能夠正確地訪問遠(yuǎn)程倉庫。

區(qū)別總結(jié)

鏡像是遠(yuǎn)程倉庫的替代地址，用于加速下載過程。
代理是網(wǎng)絡(luò)中介，用于在受限制的網(wǎng)絡(luò)環(huán)境中訪問外部網(wǎng)絡(luò)。

<!-- 配置代理服務(wù)器的信息 -->
<proxies>
  <!-- 代理配置 -->
  <proxy>
    <!-- 代理的唯一標(biāo)識 -->
    <id>myproxy</id>
    <!-- 是否激活代理 -->
    <active>true</active>
    <!-- 代理協(xié)議 -->
    <protocol>http</protocol>
    <!-- 代理服務(wù)器地址 -->
    <host>proxy.somewhere.com</host>
    <!-- 代理服務(wù)器端口 -->
    <port>8080</port>
    <!-- 代理服務(wù)器用戶名 -->
    <username>proxyuser</username>
    <!-- 代理服務(wù)器密碼 -->
    <password>somepassword</password>
    <!-- 指定不通過代理訪問的主機(jī) -->
    <nonProxyHosts>*.google.com|*.apache.org</nonProxyHosts>
  </proxy>
</proxies>

2.1.8 插件組（Plugin Groups） :

<pluginGroups/> 標(biāo)簽定義了一組插件組的ID，這可以用來改變插件的查找順序。

作用：定義了一組插件組的ID，這可以用來改變插件的查找順序。

<!-- 定義插件組的ID -->
<pluginGroups>
  <!-- 插件組ID -->
  <pluginGroup>my.custom.plugins</pluginGroup>
</pluginGroups>

2.1.9 配置文件（Profiles） :

<profiles/> 標(biāo)簽定義了一組配置文件，每個配置文件可以包含特定的構(gòu)建設(shè)置、激活條件、屬性、倉庫等，如下圖。

作用：定義了一組配置文件，每個配置文件可以包含特定的構(gòu)建設(shè)置、激活條件、屬性、倉庫等。

<!-- 定義一組配置文件 -->
<profiles>
  <!-- 配置文件項 -->
  <profile>
    <!-- 配置文件的唯一標(biāo)識 -->
    <id>dev</id>
    <!-- 配置文件的激活條件 -->
    <activation>
      <!-- 是否默認(rèn)激活 -->
      <activeByDefault>true</activeByDefault>
      <!-- JDK版本限制 -->
      <jdk>1.8</jdk>
      <!-- 操作系統(tǒng)限制 -->
      <os>
        <name>Windows</name>
        <family>Windows</family>
        <arch>x86_64</arch>
        <version>10.0</version>
      </os>
    </activation>
    <!-- 配置文件特有的屬性 -->
    <properties>
      <maven.compiler.source>1.8</maven.compiler.source>
      <maven.compiler.target>1.8</maven.compiler.target>
    </properties>
    <!-- 配置文件特有的倉庫列表 -->
    <repositories>
      <!-- 倉庫配置 -->
      <repository>
        <!-- 倉庫的唯一標(biāo)識 -->
        <id>central</id>
        <!-- 倉庫的名稱 -->
        <name>Central Repository</name>
        <!-- 倉庫的URL -->
        <url>https://repo.maven.apache.org/maven2</url> 
        <!-- 倉庫的布局 -->
        <layout>default</layout>
        <!-- 快照版本設(shè)置 -->
        <snapshots>
          <!-- 是否啟用快照版本 -->
          <enabled>true</enabled>
        </snapshots>
        <!-- 正式發(fā)布版本設(shè)置 -->
        <releases>
          <!-- 是否啟用正式發(fā)布版本 -->
          <enabled>true</enabled>
        </releases>
      </repository>
    </repositories>
    <!-- 配置文件特有的插件倉庫列表 -->
    <pluginRepositories>
      <!-- 插件倉庫配置 -->
      <pluginRepository>
        <!-- 插件倉庫的唯一標(biāo)識 -->
        <id>central</id>
        <!-- 插件倉庫的名稱 -->
        <name>Central Repository</name>
        <!-- 插件倉庫的URL -->
        <url>https://repo.maven.apache.org/maven2</url> 
        <!-- 插件倉庫的布局 -->
        <layout>default</layout>
        <!-- 插件快照版本設(shè)置 -->
        <snapshots>
          <!-- 是否啟用插件快照版本 -->
          <enabled>true</enabled>
        </snapshots>
        <!-- 插件正式發(fā)布版本設(shè)置 -->
        <releases>
          <!-- 是否啟用插件正式發(fā)布版本 -->
          <enabled>true</enabled>
        </releases>
      </pluginRepository>
    </pluginRepositories>
  </profile>
</profiles>

2.1.10 激活配置文件（Active Profiles） :

<activeProfiles/> 標(biāo)簽定義了在 Maven 構(gòu)建期間應(yīng)該激活的配置文件列表。

作用：定義了在 Maven 構(gòu)建期間應(yīng)該激活的配置文件列表。

<!-- 定義在 Maven 構(gòu)建期間應(yīng)該激活的配置文件列表 -->
<activeProfiles>
  <!-- 激活的配置文件名稱 -->
  <activeProfile>dev</activeProfile>
</activeProfiles>

2.1.11 屬性（Properties） :

在 <properties/> 標(biāo)簽內(nèi)，可以定義一些通用屬性，這些屬性可以在POM文件或構(gòu)建腳本中使用。

作用：定義一些通用屬性，這些屬性可以在 POM 文件或構(gòu)建腳本中使用。

<!-- 定義一些通用屬性 -->
<properties>
  <!-- 屬性名和屬性值 -->
  <property.name>value</property.name>
</properties>

2.1.12 倉庫管理（Repositories & PluginRepositories） :

作用：在 <profiles/> 下的 <repositories/> 和 <pluginRepositories/> 標(biāo)簽定義了配置文件特定的倉庫源，用于解析項目依賴和插件。

<!-- 配置文件特定的倉庫源 -->
<profiles>
  <!-- 配置文件項 -->
  <profile>
    ...
    <!-- 配置文件特有的倉庫列表 -->
    <repositories>
      <!-- 倉庫配置 -->
      <repository>
        <!-- 倉庫的唯一標(biāo)識 -->
        <id>central</id>
        <!-- 倉庫的名稱 -->
        <name>Central Repository</name>
        <!-- 倉庫的URL -->
        <url>https://repo.maven.apache.org/maven2</url> 
        <!-- 倉庫的布局 -->
        <layout>default</layout>
        <!-- 快照版本設(shè)置 -->
        <snapshots>
          <!-- 是否啟用快照版本 -->
          <enabled>true</enabled>
        </snapshots>
        <!-- 正式發(fā)布版本設(shè)置 -->
        <releases>
          <!-- 是否啟用正式發(fā)布版本 -->
          <enabled>true</enabled>
        </releases>
      </repository>
    </repositories>
    <!-- 配置文件特有的插件倉庫列表 -->
    <pluginRepositories>
      <!-- 插件倉庫配置 -->
      <pluginRepository>
        <!-- 插件倉庫的唯一標(biāo)識 -->
        <id>central</id>
        <!-- 插件倉庫的名稱 -->
        <name>Central Repository</name>
        <!-- 插件倉庫的URL -->
        <url>https://repo.maven.apache.org/maven2</url> 
        <!-- 插件倉庫的布局 -->
        <layout>default</layout>
        <!-- 插件快照版本設(shè)置 -->
        <snapshots>
          <!-- 是否啟用插件快照版本 -->
          <enabled>true</enabled>
        </snapshots>
        <!-- 插件正式發(fā)布版本設(shè)置 -->
        <releases>
          <!-- 是否啟用插件正式發(fā)布版本 -->
          <enabled>true</enabled>
        </releases>
      </pluginRepository>
    </pluginRepositories>
    ...
  </profile>
</profiles>

2.1.13 構(gòu)建生命周期（Build Lifecycle） :

盡管 settings.xml 不直接定義構(gòu)建生命周期，但它通過配置（如代理、鏡像等）影響構(gòu)建過程，代理、鏡像看上面內(nèi)容。

2.1.14 依賴管理和解析（Dependency Management and Resolution） :

Maven 使用 settings.xml 中定義的鏡像和倉庫設(shè)置來解析和下載項目依賴；鏡像與倉庫看上面內(nèi)容。

2.2 模塊整體配置案例說明

<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
          xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
          xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">

  <!-- 本地倉庫路徑 -->
  <localRepository>/path/to/local/repo</localRepository>
  <!-- 控制 Maven 是否在需要輸入時以交互模式運行 -->
  <interactiveMode>true</interactiveMode>
  <!-- 決定是否使用插件注冊表，這可以加速構(gòu)建過程 -->
  <usePluginRegistry>true</usePluginRegistry>
  <!-- 設(shè)置 Maven 是否運行在離線模式 -->
  <offline>false</offline>

  <!-- 服務(wù)器認(rèn)證信息，用于部署到遠(yuǎn)程倉庫 -->
  <servers>
    <server>
      <!-- 服務(wù)器的唯一標(biāo)識 -->
      <id>server1</id>
      <!-- 服務(wù)器的用戶名 -->
      <username>myusername</username>
      <!-- 服務(wù)器的密碼 -->
      <password>mypassword</password>
    </server>
  </servers>

  <!-- 定義倉庫鏡像，允許用戶通過更快的鏡像訪問遠(yuǎn)程倉庫 -->
  <mirrors>
    <mirror>
      <!-- 鏡像的唯一標(biāo)識 -->
      <id>mymirror</id>
      <!-- 指定被鏡像的倉庫 -->
      <mirrorOf>central</mirrorOf>
      <!-- 鏡像的名稱 -->
      <name>My Mirror</name>
      <!-- 鏡像的URL -->
      <url>http://mymirror.com/maven/</url>
    </mirror>
  </mirrors>

  <!-- 配置代理服務(wù)器的信息，用于在存在網(wǎng)絡(luò)代理的環(huán)境中訪問外部資源 -->
  <proxies>
    <proxy>
      <!-- 代理的唯一標(biāo)識 -->
      <id>myproxy</id>
      <!-- 是否激活代理 -->
      <active>true</active>
      <!-- 代理協(xié)議 -->
      <protocol>http</protocol>
      <!-- 代理服務(wù)器地址 -->
      <host>proxy.somewhere.com</host>
      <!-- 代理服務(wù)器端口 -->
      <port>8080</port>
      <!-- 代理服務(wù)器用戶名 -->
      <username>proxyuser</username>
      <!-- 代理服務(wù)器密碼 -->
      <password>somepassword</password>
      <!-- 指定不通過代理訪問的主機(jī) -->
      <nonProxyHosts>*.google.com|*.apache.org</nonProxyHosts>
    </proxy>
  </proxies>

  <!-- 定義一組插件組的ID，這可以用來改變插件的查找順序 -->
  <pluginGroups>
    <pluginGroup>my.custom.plugins</pluginGroup>
  </pluginGroups>

  <!-- 定義一組配置文件，每個配置文件可以包含特定的構(gòu)建設(shè)置、激活條件、屬性、倉庫等 -->
  <profiles>
    <profile>
      <!-- 配置文件的唯一標(biāo)識 -->
      <id>dev</id>
      <!-- 配置文件的激活條件 -->
      <activation>
        <!-- 是否默認(rèn)激活 -->
        <activeByDefault>true</activeByDefault>
        <!-- JDK版本限制 -->
        <jdk>1.8</jdk>
        <!-- 操作系統(tǒng)限制 -->
        <os>
          <name>Windows</name>
          <family>Windows</family>
          <arch>x86_64</arch>
          <version>10.0</version>
        </os>
      </activation>
      <!-- 配置文件特有的屬性 -->
      <properties>
        <maven.compiler.source>1.8</maven.compiler.source>
        <maven.compiler.target>1.8</maven.compiler.target>
      </properties>
      <!-- 配置文件特有的倉庫列表 -->
      <repositories>
        <repository>
          <!-- 倉庫的唯一標(biāo)識 -->
          <id>central</id>
          <!-- 倉庫的名稱 -->
          <name>Central Repository</name>
          <!-- 倉庫的URL -->
          <url>https://repo.maven.apache.org/maven2</url>
          <!-- 倉庫的布局 -->
          <layout>default</layout>
          <!-- 快照版本設(shè)置 -->
          <snapshots>
            <!-- 是否啟用快照版本 -->
            <enabled>true</enabled>
          </snapshots>
          <!-- 正式發(fā)布版本設(shè)置 -->
          <releases>
            <!-- 是否啟用正式發(fā)布版本 -->
            <enabled>true</enabled>
          </releases>
        </repository>
      </repositories>
      <!-- 配置文件特有的插件倉庫列表 -->
      <pluginRepositories>
        <pluginRepository>
          <!-- 插件倉庫的唯一標(biāo)識 -->
          <id>central</id>
          <!-- 插件倉庫的名稱 -->
          <name>Central Repository</name>
          <!-- 插件倉庫的URL -->
          <url>https://repo.maven.apache.org/maven2</url>
          <!-- 插件倉庫的布局 -->
          <layout>default</layout>
          <!-- 插件快照版本設(shè)置 -->
          <snapshots>
            <!-- 是否啟用插件快照版本 -->
            <enabled>true</enabled>
          </snapshots>
          <!-- 插件正式發(fā)布版本設(shè)置 -->
          <releases>
            <!-- 是否啟用插件正式發(fā)布版本 -->
            <enabled>true</enabled>
          </releases>
        </pluginRepository>
      </pluginRepositories>
    </profile>
  </profiles>

  <!-- 定義在 Maven 構(gòu)建期間應(yīng)該激活的配置文件列表 -->
  <activeProfiles>
    <activeProfile>dev</activeProfile>
  </activeProfiles>
</settings>

3、Maven Wrapper

Maven Wrapper 是一個用于在多環(huán)境（如不同的開發(fā)機(jī)器、持續(xù)集成服務(wù)器等）中提供一致的 Maven 版本經(jīng)驗的工具。它允許項目包含一個特定版本的 Maven 可執(zhí)行文件，這樣即使用戶本地沒有安裝 Maven，也可以使用項目指定的 Maven 版本來構(gòu)建項目。

3.0 目錄結(jié)構(gòu)

當(dāng)您在項目中添加 Maven Wrapper 后，它會在項目的根目錄下創(chuàng)建一個 .mvn 目錄，其中包含 wrapper 目錄。以下是添加 Maven Wrapper 后生成的目錄結(jié)構(gòu)：

<project-root-directory>
└── .mvn
    └── wrapper
        ├── maven-wrapper.jar
        ├── maven-wrapper.properties
        └── (on Windows)
            └── maven-wrapper.cmd
        └── (on Unix/Linux/Mac)
            └── maven-wrapper.sh

目錄結(jié)構(gòu)說明

.mvn: Maven Wrapper 專用目錄，通常被添加到 .gitignore 文件中，以避免將 Maven Wrapper 下載的 Maven 歸檔文件納入版本控制。
wrapper: 包含 Wrapper 腳本和配置文件的目錄。
maven-wrapper.jar: Maven Wrapper 的 Java 程序，用于啟動構(gòu)建過程。
maven-wrapper.properties: 配置文件，指定了 Maven 歸檔文件的 URL 和其他配置信息。
maven-wrapper.cmd: Windows 系統(tǒng)上的 Wrapper 啟動腳本。
maven-wrapper.sh: Unix、Linux 和 macOS 系統(tǒng)上的 Wrapper 啟動腳本。

使用 Maven Wrapper 構(gòu)建項目

使用以下命令使用 Maven Wrapper 來構(gòu)建項目：

# 在 Unix、Linux 或 macOS 上
./mvnw clean install

# 在 Windows 上
mvnw.cmd clean install

這些腳本（ mvnw 和 mvnw.cmd）是 Maven Wrapper 的啟動器，它們會檢查 maven-wrapper.properties 文件中指定的 Maven 版本，如果本地不存在該版本的 Maven，則會先下載并安裝。以下是安裝和使用 Maven Wrapper 的詳細(xì)步驟：

3.1 安裝 Maven Wrapper

下載 Maven Wrapper 腳本前往 Maven Wrapper 官方頁面下載 mvnw 和 mvnw.cmd 腳本，以及 maven-wrapper.properties 配置文件。
使用 Maven 命令安裝在項目根目錄下，運行以下命令來初始化 Maven Wrapper：

mvn -N wrapper

這個命令會下載 Wrapper 腳本和配置文件到項目的 .mvn/wrapper 目錄。

配置 Gradle Wrapper（如果使用 Gradle）如果項目使用 Gradle，可以在項目的 build.gradle 文件中添加以下配置：

wrapper {
    gradleVersion = '7.0'
}

然后運行以下命令生成 Wrapper：

gradle wrapper

3.2 使用 Maven Wrapper

構(gòu)建項目使用以下命令使用 Wrapper 構(gòu)建項目：

./mvnw clean install

在 Windows 上，使用：

mvnw.cmd clean install

這些命令會調(diào)用項目自帶的 Maven 版本來執(zhí)行構(gòu)建。

查看和修改 Maven 版本 maven-wrapper.properties 文件中指定了 Maven 的版本。如果需要修改 Maven 的版本，可以編輯此文件：

distributionUrl=https://repo.maven.apache.org/maven2/org/apache/maven/apache-maven/3.6.3/apache-maven-3.6.3-bin.zip

修改 distributionUrl 來指定不同的 Maven 發(fā)行版。

為 Wrapper 下載 Maven 如果這是第一次使用 Wrapper，或者本地沒有指定版本的 Maven，運行 mvnw 命令時，Wrapper 會自動下載配置文件中指定的 Maven 版本。
分發(fā)項目在將項目分發(fā)給其他開發(fā)者或部署到 CI 服務(wù)器時，不需要包含 Maven 安裝程序，但需要包含 .mvn/wrapper 目錄和腳本。

3.3 Maven Wrapper 的優(yōu)勢

版本一致性：確保所有開發(fā)者和構(gòu)建環(huán)境使用相同的 Maven 版本。
離線支持：一旦下載，即使在離線狀態(tài)下也可以使用 Maven Wrapper 構(gòu)建項目。
簡化環(huán)境配置：新成員不需要單獨安裝 Maven，可以快速開始項目構(gòu)建。

Maven Wrapper 是一個非常有用的工具，可以提高項目構(gòu)建的可靠性和便攜性。

責(zé)任編輯：武曉燕來源： Solomon肖哥彈架構(gòu)

Maven 架構(gòu)技巧