Apache Maven 是一个强大的构建自动化工具，主要用于 Java 项目。它简化了构建和管理任何基于 Java 的项目的流程。

本指南将涵盖 Maven 的安装、设置一个简单的 Java 项目以及使用 Maven 运行该项目。

1. 安装

安装 Java

在安装 Maven 之前，需要确保您的系统上已安装了 Java。请按照以下步骤操作：

1. 下载 JDK：从官方 Oracle 网站或 OpenJDK 网站下载最新版本的 JDK（Java 开发工具包）。

2. 安装 JDK：按照下载页面提供的安装说明进行操作。务必设置 JAVA_HOME 环境变量指向 JDK 安装目录。

3. 验证安装：打开终端或命令提示符，输入以下命令以验证安装：

   java -version
   

   您应该能看到安装在系统上的 Java 版本信息。

安装 Maven

接下来，按照以下步骤安装 Maven：

1. 下载 Maven：从官方 Apache Maven 网站下载最新版本的 Maven。

2. 安装 Maven：解压下载的归档文件到您选择的目录。设置 M2_HOME 和 MAVEN_HOME 环境变量指向 Maven 安装目录，并将 bin 目录添加到您的 PATH 中。

3. 验证安装：打开终端或命令提示符，输入以下命令以验证安装：

   mvn -version
   

   您应该能看到安装在系统上的 Maven 版本信息。

2. 创建一个简单的 Java 项目

现在让我们使用 Maven 设置一个简单的 Java 项目，我们将创建一个基本的“Hello World”应用程序。

步骤 1：创建项目目录

1. 打开终端或命令提示符，创建一个新的项目目录：

   mkdir my-maven-project
   cd my-maven-project
   

步骤 2：生成 Maven 项目

1. 使用 Maven Archetype 插件来生成新项目：

   mvn archetype:generate -DgroupId=com.example -DartifactId=my-maven-project -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
   

   此命令会生成一个基本的 Maven 项目结构。重要的文件和目录包括：

   • src/main/java：包含 Java 源代码文件。
   • src/test/java：包含测试 Java 源代码文件。
   • pom.xml：项目对象模型文件，其中包含项目配置。

步骤 3：添加“Hello World”代码

1. 导航至 src/main/java/com/example 目录并打开 App.java 文件。用以下代码替换其内容：

   package com.example;
   
   public class App {
       public static void main(String[] args) {
           System.out.println("Hello World!");
       }
   }
   

步骤 4：更新 pom.xml

1. 确保您的 pom.xml 包含正确的配置。这里是一个示例配置，其中包含了最新的依赖项：

   <project xmlns="http://maven.apache.org/POM/4.0.0"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
       <modelVersion>4.0.0</modelVersion>
       <groupId>com.example</groupId>
       <artifactId>my-maven-project</artifactId>
       <version>1.0-SNAPSHOT</version>
       <packaging>jar</packaging>
       <name>my-maven-project</name>
       <url>http://maven.apache.org</url>
       <properties>
           <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
           <maven.compiler.source>11</maven.compiler.source>
           <maven.compiler.target>11</maven.compiler.target>
       </properties>
       <dependencies>
           <dependency>
               <groupId>org.junit.jupiter</groupId>
               <artifactId>junit-jupiter</artifactId>
               <version>5.10.0</version>
               <scope>test</scope>
           </dependency>
       </dependencies>
       <build>
           <plugins>
               <plugin>
                   <groupId>org.apache.maven.plugins</groupId>
                   <artifactId>maven-jar-plugin</artifactId>
                   <version>3.3.0</version>
                   <configuration>
                       <archive>
                           <manifest>
                               <mainClass>com.example.App</mainClass>
                           </manifest>
                       </archive>
                   </configuration>
               </plugin>
           </plugins>
       </build>
   </project>
   

   注意：根据您的 JDK 版本，可能需要调整 <maven.compiler.source> 和 <maven.compiler.target> 的值。

步骤 5：构建项目

1. 运行以下命令来构建项目：

   mvn clean install
   

   该命令会编译 Java 代码、运行测试并将应用程序打包成一个 JAR 文件。

3. 运行项目

步骤 6：运行应用程序

1. 构建项目后，可以使用以下命令运行应用程序：

   java -cp target/my-maven-project-1.0-SNAPSHOT.jar com.example.App
   

   您应该能看到输出：

   Hello World!
   

步骤 7：运行打包的 JAR 文件

1. 或者，您可以直接运行打包的 JAR 文件：

   java -jar target/my-maven-project-1.0-SNAPSHOT.jar
   

   确保 pom.xml 文件中的 build 部分正确指定了 App 类，以便创建可执行的 JAR 文件。

总结

通过本指南，我们学习了 Maven 和 Java 的安装、如何使用 Maven 设置一个简单的 Java 项目以及如何运行该项目。

Maven 简化了项目的设置和管理，使得处理依赖关系、构建过程和项目结构变得更加容易。

遵循上述步骤，您可以快速开始使用 Maven 构建和运行 Java 应用程序。