Apache Maven 是一种广泛使用的构建自动化和项目管理工具,主要用于 Java 开发。它通过使用标准化的项目结构和库和插件的中央存储库,简化了 Java 项目依赖项的构建、打包和管理过程。Apache Maven 能够简化项目工作流程,使其成为开发大型 Java 应用程序的开发人员的重要工具。
在 Ubuntu 24.04、22.04 或 20.04 上,您可以通过两种主要方法安装 Apache Maven。第一种方法是使用 Ubuntu 默认存储库,它提供了适合大多数用户的稳定且简单的安装。或者,对于那些需要最新版本或特定版本的 Maven 的用户,您可以从源存档中手动下载并安装 Maven。本指南将引导您完成这两种安装方法,让您选择最适合您开发需求的选项。
方法 1:通过 APT 终端命令安装 Apache Maven
在 Apache Maven 安装之前更新 Ubuntu 系统
在我们深入安装过程之前,确保您的 Ubuntu 系统是最新的至关重要。此步骤有助于避免潜在的冲突,并确保您拥有最新的安全补丁和系统改进。要更新系统,您需要在终端中执行以下命令:
sudo apt update && sudo apt upgrade
此命令执行两项操作。sudo apt update 更新需要升级的软件包的升级包列表,以及刚刚进入存储库的新软件包。
通过 APT 命令安装 Apache Maven
系统更新后,您现在可以安装 Apache Maven。如前所述,Ubuntu 在其默认存储库中包含 Apache Maven,从而简化了安装过程。要安装 Apache Maven,请执行以下命令:
sudo apt install maven
此命令告诉 APT 安装 maven 包。 sudo 前缀确保该命令以系统范围安装所需的超级用户权限运行。
通过 APT 验证 Apache Maven 安装
安装后,请验证是否正确安装了 Apache Maven 并检查其版本。此步骤可确保安装过程顺利进行,并确认您拥有适当的 Maven 版本。要验证安装并确定版本,请使用以下命令:
mvn -version
此命令要求 Maven 显示其版本号,该版本号应输出有关已安装的 Maven 版本的信息。
方法 2:通过源安装 Apache Maven
步骤 1:安装默认 Java 开发工具包 (JDK)
首先,要通过源存档在 Ubuntu 上安装 Apache Maven,请确保您的 Ubuntu 系统上安装了 Java。Apache Maven 需要 Java 才能运行。使用以下命令在 Ubuntu 上安装默认 JDK:
sudo apt install default-jdk -y
此命令指示 APT 安装 default-jdk 包。-y 标志会自动确认安装,无需您手动批准。
下载 Apache Maven 档案
安装 Java 后,我们现在可以下载 Apache Maven 档案。我们将使用 wget 命令来执行此操作,这是一个用于从 Web 非交互式下载文件的实用程序。
要查找 Apache Maven 的最新版本,您可以访问 Apache Maven 下载页面。为了本指南的目的,我们假设最新版本是 3.9.2。要下载此版本,请使用以下命令:
wget https://dlcdn.apache.org/maven/maven-3/3.9.2/binaries/apache-maven-3.9.2-bin.tar.gz
注意:以上命令仅作为示例,请确保您获取最新版本的链接,因为复制以上命令将导致您获得过时的版本。
提取 Apache Maven 档案
下载 Apache Maven 存档后,我们需要将其解压。我们将存档解压到 /opt/ 目录,这是用于存储可选或附加软件的标准目录。要解压存档,请使用以下命令:
sudo tar xzf apache-maven-3.9.2-bin.tar.gz -C /opt/
此命令使用 tar 实用程序来提取存档。-xzf 标志指示 tar 提取 (-x) 经过 gzip 压缩 (-z) 的文件,-C 标志指定提取的目标目录。
cd /opt/
创建指向 Apache Maven 目录的符号链接
提取存档后,我们将创建指向 Apache Maven 目录的符号链接。此步骤是可选的,但建议执行,以便您更方便地引用目录。要创建符号链接,请使用以下命令:
sudo ln -s apache-maven-3.9.2 maven
此命令创建一个名为 maven
指向 apache-maven-3.9.2 目录。
设置 Apache Maven 环境
接下来,我们必须通过定义一些环境变量来设置 Apache Maven 环境。我们将在 /etc/profile.d/ 目录中创建一个新的脚本文件,这是一个用于添加设置环境变量的脚本的标准目录。要创建脚本文件,请使用以下命令:
sudo nano /etc/profile.d/maven.sh
此命令在 nano 文本编辑器中打开一个名为 maven.sh 的新文件。在此文件中,添加以下行:
export M2_HOME=/opt/maven
export PATH=${M2_HOME}/bin:${PATH}
这些行定义了两个环境变量:M2_HOME(指向 Apache Maven 目录)和 PATH(包含 Apache Maven 二进制文件的路径)。要保存文件并退出编辑器,请按 CTRL+O,然后按 CTRL+X。
或者,我们可以使用 echo 命令和 sudo tee 命令来实现这一点。echo 命令将生成必要的行,sudo tee 会将这些行写入文件。您可以这样做:
echo -e "export M2_HOME=/opt/maven\nexport PATH=\${M2_HOME}/bin:\${PATH}" | sudo tee /etc/profile.d/maven.sh
此命令执行以下操作:
- echo -e 命令可以解释反斜杠转义符并生成要添加到文件中的行。
- |(管道)获取其左侧命令的输出并将其用作其右侧命令的输入。
- sudo tee /etc/profile.d/maven.sh 命令将其从 echo 命令收到的输入写入文件 /etc/profile.d/maven.sh。tee 命令与 sudo 结合使用,用于写入 root 用户拥有的文件。
此命令有效地创建了具有必要环境变量的 maven.sh 文件,而无需手动打开和编辑该文件。
启用 Apache Maven 环境
定义环境变量后,我们需要启用它们。我们将通过获取刚刚创建的脚本文件来实现这一点。获取脚本文件意味着在当前 shell 中执行该文件,这允许环境变量在当前会话中可用。要获取脚本文件,请使用以下命令:
source /etc/profile.d/maven.sh
此命令在当前 shell 中读取并执行 maven.sh 文件。“source 命令”是 shell 内置命令,它在当前 shell 环境中从指定为其参数的文件中读取并执行命令。
验证 Apache Maven 安装
设置 Apache Maven 环境后,验证设置是否正确是一种很好的做法。与以前一样,检查已安装的 Apache Maven 版本以确认安装。使用以下命令:
mvn -version
该命令将显示有关已安装的 Apache Maven 版本的信息。如果您正确配置了所有内容,则版本号应与您下载的版本相对应。
创建并测试 Maven 项目(可选)
创建新的 Maven 项目
创建 Maven 项目的第一步是生成新结构。Maven 为此提供了一个命令,该命令会创建一个新的目录结构,其中包含默认的 pom.xml 文件(项目对象模型文件),这是 Maven 中的基本工作单元。
要创建新的 Maven 项目,请导航到要创建项目的目录并运行以下命令:
mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
此命令指示 Maven 根据原型生成新项目。原型是项目的模板,在本例中为 maven-archetype-quickstart,这是一个基本的 Java 项目。groupId 和 artifactId 参数用于在所有项目中唯一标识您的项目。
导航到 Maven 项目目录
创建项目后,使用以下命令导航到项目目录:
cd my-app
此命令将当前目录更改为 my-app 目录,这是您刚刚创建的项目的根目录。
构建 Maven 项目
创建项目并设置项目目录后,您现在可以构建项目。构建项目会编译源代码并将其打包为可分发格式,例如 JAR 文件。要构建项目,请使用以下命令:
mvn package
此命令告知 Maven 执行构建生命周期的打包阶段。打包阶段会编译源代码、运行任何测试,并将编译后的代码打包为可分发格式。
运行 Maven 项目
最后,构建项目后,您可以运行它来验证一切是否按预期运行。要运行该项目,请使用以下命令:
java -cp target/my-app-1.0-SNAPSHOT.jar com.mycompany.app.App
此命令运行由 mvn package 命令生成的 JAR 文件中的 Java 应用程序。-cp 标志指定类路径,java 命令的参数是应用程序的主类。
通过正确的设置,此命令将输出“Hello World!”这表明您的 Maven 项目正在按预期运行。
结束语
通过在 Ubuntu 系统上安装 Apache Maven,您可以简化 Java 开发工作流程并高效管理项目。无论您选择 Ubuntu 默认存储库的易用性和稳定性,还是手动下载和安装最新或特定 Maven 版本的灵活性,这两种方法都提供了启动和运行 Maven 的可靠方法。定期更新和版本管理将确保您的 Maven 设置保持最新,让您充分利用其强大的项目管理和在 Ubuntu 上构建自动化功能。