如何将Jar包发布到Maven中央仓库

原创已于 2025-11-10 22:09:25 修改 · 738 阅读

15 ·

CC 4.0 BY-SA版权

文章标签：

#jar #maven #java #mac #macos

于 2025-11-10 22:03:51 首次发布

1.Maven仓库准备

1.1 注册账号

官网地址 https://central.sonatype.com/

1.2 创建namespace

1.创建

以gitee仓库为例：io.gitee.gitee用户名

2.验证

复制Verification Key，去上一步用的gitee用户下创建一个仓库，名为Verification Key，可以为空，但一定要是可以公开访问的，不要设成私有。验证通过后可删除，只是为了验证仓库是你的

创建完后点击Verify Namespace进行验证，正常是很快的，如果一直在验证中，可以取消验证再重新验证一下

1.3 生成用户访问令牌

复制这部分内容，粘贴到maven的配置文件settings.xml中,${server}自己定义。

至此，第一步完成

2.GPG账号准备

2.1 下载GPG

官网地址 https://gnupg.org/download/

打开后下滑，找到自己的系统版本下载，本文以mac为例

首次进入会弹出对话框，要求创建用户。根据提示输入姓名、邮箱及密码。密码后续会用到。

2.2 生成密钥

gpg --gen-key

按照提示输入即可

2.3 上传密钥到maven中央仓库

gpg --keyserver keyserver.ubuntu.com --send-keys xxx

xxx替换为刚才生成密钥的pub部分，即图中3C6432F178。。。部分

2.4 查询是否上传成功

https://keyserver.ubuntu.com/

进入上面这个地址，输入刚才的pub部分，点击查询

如果能查到即为成功

打开maven的配置文件settings.xml，加入圈出的部分，<gpg.passphrase>xxx</gpg.passphrase>部分为刚才创建密钥时的密码

3.发布

3.1 pom配置

此处只需将pom文件设置正确，我给出的为最简洁版本，任一部分都不可以缺少，如果项目有其他pom配置正常加上即可

<?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>io.gitee.test</groupId> // 第一步时的namespace
    <artifactId>core</artifactId> // 自定义
    <version>1.1.1</version>
    <packaging>jar</packaging>

    <name>core</name>
    <description>yimiyisu core</description>
    <url>https</url> // url和下面的scm如果没有，可以像我这样填。不可以没有这部分也不可以空着

    <licenses>
        <license>
            <name>Apache License, Version 2.0</name>
            <url>https://www.apache.org/licenses/LICENSE-2.0.txt</url>
        </license>
    </licenses>

    <scm>
        <url>https</url>
        <connection></connection>
        <developerConnection></developerConnection>
    </scm>

    <developers>
        <developer>
            <name>lll</name>
            <email>254@qq.com</email>
        </developer>
    </developers>

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

    <build>
        <plugins>
            <!-- Compiler -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.13.0</version>
                <configuration>
                    <source>${maven.compiler.source}</source>
                    <target>${maven.compiler.target}</target>
                    <encoding>${project.build.sourceEncoding}</encoding>
                </configuration>
            </plugin>
            <!-- Source -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>3.3.1</version>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar-no-fork</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <!-- Javadoc -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>3.10.0</version>
                <executions>
                    <execution>
                        <id>attach-javadocs</id>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <!-- GPG -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-gpg-plugin</artifactId>
                <version>3.2.7</version>
                <configuration>
                    <gpgArguments>
                        <arg>--pinentry-mode</arg>
                        <arg>loopback</arg>
                    </gpgArguments>
                </configuration>
                <executions>
                    <execution>
                        <id>sign-artifacts</id>
                        <phase>verify</phase>
                        <goals>
                            <goal>sign</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.sonatype.central</groupId>
                <artifactId>central-publishing-maven-plugin</artifactId>
                <version>0.5.0</version>
                <extensions>true</extensions>
                <configuration>
                    <publishingServerId>test</publishingServerId>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

这部分填下面这部分的id

3.2 发布

依次执行以上三步即可。完成后回到maven仓库，进入设置namespace的页面，点击发布，等待状态修改完即可。完成后在仓库搜索到自己上传的jar包即完成。

3.3 上传自己的jar包，不希望使用maven编译的jar包

由于我的项目不是标准的maven结构，所以上传上去的jar包并没有我的项目代码。

在根目录建个文件夹，将自己的jar包放进去，在刚刚pom的基础上修改

<!-- Compiler -->

<!-- Source -->两部分插件

<!-- Compiler -->
            <!-- 跳过编译 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-compiler-plugin</artifactId>
                <version>3.13.0</version>
                <configuration>
                    <skipMain>true</skipMain>
                    <skip>true</skip>
                </configuration>
            </plugin>

            <!-- 禁用默认的jar打包 -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-jar-plugin</artifactId>
                <version>3.3.0</version>
                <configuration>
                    <skip>true</skip> <!-- 完全跳过jar打包 -->
                </configuration>
            </plugin>

            <!-- 复制预构建的JAR -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-antrun-plugin</artifactId>
                <version>3.1.0</version>
                <executions>
                    <execution>
                        <id>copy-prebuilt-jar</id>
                        <phase>package</phase>
                        <goals>
                            <goal>run</goal>
                        </goals>
                        <configuration>
                            <target>
                                <echo message="Copying prebuilt JAR to target directory"/>
                                <copy file="${basedir}/jar/core-1.1.1.jar"
                                      tofile="${project.build.directory}/${project.build.finalName}.jar"
                                      overwrite="true"/>
                                <echo message="JAR copied successfully"/>
                            </target>
                        </configuration>
                    </execution>
                </executions>
            </plugin>
            <!-- Source -->
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>3.3.1</version>
                <configuration>
                    <forceCreation>true</forceCreation> <!-- 强制创建空的JAR -->
                </configuration>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar-no-fork</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>

这样即可将自己的jar包上传上去，而不是maven编译的jar包

3.4 通过分类器解决3.3问题

只修改部分

 <!-- Compiler -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.13.0</version>
<configuration>
    <skipMain>true</skipMain>
    <skip>true</skip>
</configuration>
</plugin>

        <!-- 使用预构建的jar包 -->
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>build-helper-maven-plugin</artifactId>
<version>3.6.0</version>
<executions>
    <execution>
        <id>attach-artifacts</id>
        <phase>package</phase>
        <goals>
            <goal>attach-artifact</goal>
        </goals>
        <configuration>
            <artifacts>
                <artifact>
                    <file>${basedir}/jar/core-1.1.1.jar</file>
                    <type>jar</type>
                    <classifier>custom</classifier>  <!-- 添加分类器 -->
                </artifact>
            </artifacts>
        </configuration>
    </execution>
    <execution>
        <id>attach-sources</id>
        <phase>package</phase>
        <goals>
            <goal>attach-artifact</goal>
        </goals>
        <configuration>
            <artifacts>
                <artifact>
                    <file>${basedir}/jar/core-1.1.1.jar</file>
                    <type>jar</type>
                    <classifier>sources</classifier>
                </artifact>
            </artifacts>
        </configuration>
    </execution>
</executions>
</plugin>

这种方式也可以，不过在引用的时候必须明确指定<classifier>custom</classifier>，否则还是maven编译的jar包