# 使用 Java + Maven 构建方式创建父模块

> 创建方式：File -> New -> Project -> Java -> 构建工具选择 Maven

该方式允许创建更“干净”的 Maven 项目，可选是否使用 Archetype 模板，创建完成后删除 `src` 目录。





## 特点

- 可跳过模板选择（自由构建项目）
- 默认生成 src 目录，但不生成类文件
- 可手动定制 POM 配置

## 优点

- 更贴合实际开发习惯
- 项目结构更灵活、轻量
- 避免模板带来的冗余内容

## 缺点

- 创建父模块仍需手动删除 src


# 开始

1. 创建父模块

![image.png](/static/img/5917dc7fea5ce1cd9ab48e6c05c9942e.image.webp)

2. 删掉无需的文件（项目的`pom`文件只是作为依赖管理使用）

![image.png](/static/img/0f64152c7fbbb9afb92b5a513698271c.image.webp)

3. `pom` 添加一些标签


![image.png](/static/img/22df2ac36b156c8907b8a2ac7c32e0d9.image.webp)

```xml
<?xml version="1.0" encoding="UTF-8"?>
<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>cn.reminis</groupId>
    <artifactId>AtlasAdmin</artifactId>
    <version>1.0.0</version>

    <packaging>pom</packaging>

    
    <name>AtlasAdmin</name>
    <url>https://reminis.cn</url>
    <description>Springboot多模块系统</description>

    <properties>
        <maven.compiler.source>21</maven.compiler.source>
        <maven.compiler.target>21</maven.compiler.target>
        <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    </properties>

    <dependencyManagement>

    </dependencyManagement>

</project>
```

**标签解释：**

**packaging:** 默认情况下，Maven 项目会打包成 .jar 或 .war 文件，
`packaging = pom` 的作用是：
> 告诉 Maven：这是一个 聚合/父项目（Parent/Aggregator），本身不打包可执行代码，而是 用于管理子模块 和 统一依赖配置

**dependencyManagement**: 
> 在父 pom 中 统一指定依赖版本号，子模块使用时只需写 groupId + artifactId，不需要再写版本。

示例：
```xml
父模块
<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
            <version>3.2.0</version>
        </dependency>
    </dependencies>
</dependencyManagement>
```

```xml
子模块
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
    
</dependency>

```

# 创建子模块
1. 在父模块上右键新建模块

![image.png](/static/img/1af1fc51b21dd3be66cfc0720dcd1ff2.image.webp)

2. 创建 `common` 模块

![image.png](/static/img/437316e4a2799cf4f552a5c48bbee597.image.webp)

> common 为公共模块，存放通用的工具类、常量、基础实体、异常处理等，供其他模块依赖使用。

![image.png](/static/img/4c857242a45c08d340cf5d925839c92c.image.webp)

IntelliJ IDEA 构建 Spring Boot 多模块 Maven 项目

# 一、下载并安装Maven
## 1.下载
> 下载地址：https://maven.apache.org/download.cgi ，浏览器打开链接下载最新的3.9.11版本



![image.png](/static/img/dda32bb0e88b2d0a0fce4b3e2a7450af.image.webp)

## 2.安装
解压 `apache-maven-3.9.11-bin.zip` 到**没有中文和特殊字符**的路径下既为安装完成
解压缩后的目录结构如下：

![image.png](/static/img/c4b28a5ce5c0f232f156cfd691ae2b3a.image.webp)

- **bin目录：** 存放的是可执行命令， mvn 命令重点关注。
- **conf目录：** 存放Maven的配置文件， settings.xml 配置文件后期需要修改。
- **lib目录：** 存放Maven依赖的jar包， Maven也是使用java开发的，所以它也依赖其他的jar包。

# 配置Maven
## 配置环境变量
1. 此电脑 右键 -> 属性 -> 高级系统设置 -> 高级 -> 环境变量

![image.png](/static/img/dabe13d88379e328b191d98d544d730b.image.webp)

![image.png](/static/img/147ac040cb1750f6e040b10950d61d25.image.webp)

2. 在系统变量新建一个变量名为 `MAVEN_HOME` ，变量值为Maven安装目录的系统变量

![image.png](/static/img/8337d311af989d3263e5e8eb34f15cbc.image.webp)

3. 在 `Path` 中点击新建，添加 `%MAVEN_HOME%\bin` 后点击三次确定按钮

![image.png](/static/img/f0210bc4595e9ee13df66a6bc90729ad.image.webp)

4. 打开命令提示符,输入 `mvn -version` ，进行验证，出现如图所示表示安装成功

![image.png](/static/img/2c560cdeb1a680252fc7fb814e0ced2f.image.webp)

## 配置本地仓库
1. 打开 `conf/settings.xml` 文件，修改文件中的 `localRepository` 标签，指定一个目录为本地仓库，用来存储拉取的jar包

![image.png](/static/img/27effc6f716c4ca0f684a80a80636f9d.image.webp)

2. 配置国内镜像
国内下载jar包可能下载不下来或者速度比较慢，可以配置阿里镜像。

    打开 `conf/settings.xml` 文件，在 `mirrors` 标签中添加如下子标签：
    ```xml
     <mirror>
      <id>aliyunmaven</id>
      <mirrorOf>*</mirrorOf>
      <name>阿里云公共仓库</name>
      <url>https://maven.aliyun.com/repository/public</url>
    </mirror>
    ```
    
# 二、IDEA配置Maven环境
IDEA中打开 File -> Settings -> Maven
> `Maven home path` 设置为本地安装的Maven，并修改 `User setting file` 配置文件路径为本地安装的Maven的 `conf/settings.xml` 文件

> 在 `User setting file` 后的 `Override` 处打勾， `Local repository` 会自动配置为 `conf/settings.xml` 中指定的本地仓库路径，如果不是可以手动配置为本地仓库路径并在之后的 `Override` 处打勾

![image.png](/static/img/a6703dac9acd0dc4eb5ce3793223e7ca.image.webp)

在windows11下安装配置Maven以及IDEA配置Maven环境

```bash
flutter pub cache clean
```

Flutter：删除 .pub-cache 中的所有依赖项

flutter doctor 出现：

```bash
[!] Network resources
    X A network error occurred while checking "https://github.com/": 信号灯超时时间已到
```





## 解决办法
1. 先清理代理，以防代理出错

```bash
git config --global --unset http.proxy
git config --global --unset https.proxy
```
2. 配置代理，指向端口号与所开代理软件监听端口号保持一致，例如下图代理软件监听端口号为10808，则配置代理也指向10808

![image.png](/static/img/43ca4131c8e43a26dc77856896154c29.image.webp)

```bash
git config --global http.proxy http://127.0.0.1:10808
git config --global https.proxy http://127.0.0.1:10808
```

flutter github信号灯超时问题处理

flutter打包时报错：

```bash
Execution failed for task ':xxx:verifyReleaseResources'.
> A failure occurred while executing com.android.build.gradle.tasks.VerifyLibraryResourcesTask$Action
   > Android resource linking failed
     ERROR: D:\Project\apprheofit-china\app_rheofit\build\cloudbase_ce\intermediates\merged_res\release\mergeReleaseResources\values\values.xml:194: AAPT: error: resource android:attr/lStar not found.
```





## 报错原因
> compileSdkVersion版本不一致，查找报错的那个库修改为一样就可以了。


## 解决办法
找到报错库Android目录下的build.gradle文件，修改compileSdkVersion为项目的版本即可

![image.png](/static/img/3355b40a9b7c17e530a57f7bda1505db.image.webp)

flutter 打包 Execution failed for task ':xxx:verifyReleaseResources'. > A failure occurred while executing com.android.build.gradle.tasks.VerifyLibraryResourcesTask$Action