在 Windows 上安装本地 JAR 到 Maven 仓库

文章目录

一、背景介绍
二、项目结构说明
[三、Windows CMD：一行写法（不要换行）](#三、Windows CMD：一行写法（不要换行）)
[四、PowerShell 可换行写法](#四、PowerShell 可换行写法)
[五、pom.xml 中添加依赖](#五、pom.xml 中添加依赖)
[六、IntelliJ IDEA 刷新依赖 & 打包](#六、IntelliJ IDEA 刷新依赖 & 打包)

最近在做项目时，因为依赖了本地的 JAR 包（比如 jna.jar 和自己写的 examples.jar），这些包没有发布到远程仓库，所以必须手动安装到 Maven 本地仓库。

一、背景介绍

Maven 构建项目依赖的所有 JAR 包必须在本地仓库中。如果你引用的包来自于第三方（没有发布到中央仓库），就需要手动安装。例如：

jna.jar：Java 本地访问库
examples.jar：项目自定义 JNA 示例库

二、项目结构说明

假设项目目录如下：

复制代码

D:\
└─ hikvoice-relay\
     ├─ lib\
     │   ├─ jna.jar
     │   └─ examples.jar
     ├─ src\
     └─ pom.xml

我们要做的就是把 lib\ 目录下的两个 JAR 安装到 Maven 本地仓库。

三、Windows CMD：一行写法（不要换行）

⚠️ 注意：CMD 终端不支持换行，必须全部参数写在一行里。

进入项目主目录：

cmd 复制代码

D:\hikvoice-relay>

✅ 安装 jna.jar

cmd 复制代码

mvn install:install-file -Dfile=lib\jna.jar -DgroupId=net.java.dev.jna -DartifactId=jna -Dversion=3.0.9 -Dpackaging=jar

✅ 安装 examples.jar

cmd 复制代码

mvn install:install-file -Dfile=lib\examples.jar -DgroupId=com.sky.local -DartifactId=jna-examples -Dversion=1.0 -Dpackaging=jar

执行成功后，Maven 会自动把这两个 JAR 安装到本地仓库中（通常是 C:\Users\<用户名>\.m2\repository）。

四、PowerShell 可换行写法

如果你在使用 PowerShell，可以利用 反引号 (`) 分行：

✅ 安装 jna.jar

powershell 复制代码

mvn install:install-file `
  -Dfile=lib\jna.jar `
  -DgroupId=net.java.dev.jna `
  -DartifactId=jna `
  -Dversion=3.0.9 `
  -Dpackaging=jar

✅ 安装 examples.jar

powershell 复制代码

mvn install:install-file `
  -Dfile=lib\examples.jar `
  -DgroupId=com.sky.local `
  -DartifactId=jna-examples `
  -Dversion=1.0 `
  -Dpackaging=jar

五、pom.xml 中添加依赖

安装完成后，还需要在项目的 pom.xml 中声明依赖：

xml 复制代码

<dependencies>
    <!-- JNA 核心库 -->
    <dependency>
        <groupId>net.java.dev.jna</groupId>
        <artifactId>jna</artifactId>
        <version>3.0.9</version>
    </dependency>

    <!-- 自定义 JNA 示例库 -->
    <dependency>
        <groupId>com.sky.local</groupId>
        <artifactId>jna-examples</artifactId>
        <version>1.0</version>
    </dependency>
</dependencies>

六、IntelliJ IDEA 刷新依赖 & 打包

1. 刷新 Maven 项目

打开 右侧 Maven 面板 → 点击 🔄 Reload All Maven Projects

📌 这样 IDEA 才能识别你刚安装的本地依赖。

2. 打包项目

你有两种方式：

✅ IDEA 面板

复制代码

Lifecycle → clean
Lifecycle → package

✅ 命令行

cmd 复制代码

mvn clean package -DskipTests