如何手动将JAR发布到maven central？

时间：2015-03-04 04:44:43

标签： java maven

我创建了一个open source project，我想将其发布到maven central，以便用户可以通过简单地在其pom中引用它来使用该库。像这样：

<dependency>
    <groupId>in.ksharma</groupId>
    <artifactId>log4j-weblayout</artifactId>
    <version>0.0.1-BETA</version>
</dependency>

我发现了几个在线教程，但其中一些已经过时，有些人建议自动完成整个过程，从而使其过于复杂。

例如one tutorial建议为您的github帐户创建SSH密钥，并且只要推送到maven central，maven就会自动创建一个git标记。虽然这很有用，但没有必要开始。

另一个例子，试图通过maven直接释放它也会产生某种错误：

mvn release:clean release:prepare release:perform -B -e | tee maven-central-deploy.log

给出：

  

svn：E155007：   '/home/kshitiz/Documents/workspaces/ggts/log4j-weblayout/pom.xml'是   不是工作副本

当你第一次做某事时，通常先手动完成，然后自动完成。

将JAR置于maven中心的最基本，最简单的方法是什么？

2 个答案:

答案 0 :(得分：22)

1）创建您的Jira帐户：Signup Sonatype

2）创建新的项目故障单（声明工作区）：Create new project ticket

3）生成PGP签名

gpg2 --gen-key
....
gpg: key YOUR_KEY_ID marked as ultimately trusted
...

4）分发您的公钥

gpg2 --keyserver hkp://pool.sks-keyservers.net --send-keys YOUR_KEY_ID

将您的密钥分发给多台服务器以加快同步过程（pgp.mit.edu，keyserver.ubuntu.com ......）

5）更新〜.m2 / settings.xml 

<settings>
  <servers>
    <server>
      <id>ossrh</id>
      <username>jira_username</username>
      <password>jira_password</password>
    </server>
  </servers>
  <profiles>
    <profile>
      <id>ossrh</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      <properties>
        <gpg.executable>gpg2</gpg.executable>
        <gpg.passphrase>your_key_passphrase</gpg.passphrase>
      </properties>
    </profile>
  </profiles>
</settings>

6）更新您的项目pom.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>

    <parent>
        <groupId>org.sonatype.oss</groupId>
        <artifactId>oss-parent</artifactId>
        <version>9</version>
    </parent>

    <groupId>xxx.xxx</groupId>
    <artifactId>xxx</artifactId>
    <version>0.1</version>

    <distributionManagement>
        <snapshotRepository>
            <id>ossrh</id>
          <url>https://oss.sonatype.org/content/repositories/snapshots</url>
        </snapshotRepository>
        <repository>
            <id>ossrh</id>
            <url>https://oss.sonatype.org/service/local/staging/deploy/maven2/</url>
        </repository>
    </distributionManagement>
    <build>
        <plugins>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-source-plugin</artifactId>
                <version>2.2.1</version>
                <executions>
                    <execution>
                        <id>attach-sources</id>
                        <goals>
                            <goal>jar-no-fork</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-javadoc-plugin</artifactId>
                <version>2.9.1</version>
                <executions>
                    <execution>
                        <id>attach-javadocs</id>
                        <goals>
                            <goal>jar</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.apache.maven.plugins</groupId>
                <artifactId>maven-gpg-plugin</artifactId>
                <version>1.5</version>
                <executions>
                    <execution>
                        <id>sign-artifacts</id>
                        <phase>verify</phase>
                        <goals>
                            <goal>sign</goal>
                        </goals>
                    </execution>
                </executions>
            </plugin>
            <plugin>
                <groupId>org.sonatype.plugins</groupId>
                <artifactId>nexus-staging-maven-plugin</artifactId>
                <version>1.6.7</version>
                <extensions>true</extensions>
                <configuration>
                    <serverId>ossrh</serverId>
                    <nexusUrl>https://oss.sonatype.org/</nexusUrl>
                    <autoReleaseAfterClose>true</autoReleaseAfterClose>
                </configuration>
            </plugin>
        </plugins>
    </build>
</project>

7）运行Maven

Maven会询问您的密码 

mvn clean deploy

8）评论您的Jira票证

这将触发与您的组ID的中心同步。

  

我推广了我的第一个版本。感谢。

资源：

OSSRH Guide

Deploy with Maven

PGP Signatures

答案 1 :(得分：15)

这个答案假设您有一个基于maven的项目，并且它处于可打包状态。 mvn package应该没有任何错误地运行。

发布到maven central时，您需要使用可识别您上传的所有工件的组ID。像in.ksharma这样的东西。您还需要签署您的工件，以便用户能够验证他们实际上是否来自您。

首先转到sonatype jira和create an account，然后创建一个jira问题以使您的组ID被批准。类似于this。

现在生成一个gpg keypair用于签署您的工件：

$ gpg --gen-key

在~/.m2/settings.xml中定义此键：

<profiles>
  <profile>
    <id>sonatype-oss-release</id>
    <properties>
      <gpg.keyname>B63EFB4D</gpg.keyname>
      <gpg.passphrase>****</gpg.passphrase>
      <gpg.defaultKeyring>true</gpg.defaultKeyring>
      <gpg.useagent>true</gpg.useagent>
      <gpg.lockMode>never</gpg.lockMode>
      <gpg.homedir>/home/kshitiz/.gnupg</gpg.homedir>
    </properties>
  </profile>
</profiles>

修改项目的pom文件并将-SNAPSHOT附加到您的版本。 因此0.0.1-BETA变为0.0.1-BETA-SNAPSHOT。否则maven would complain：

  

[错误]无法执行目标   org.apache.maven.plugins：行家释放小插件：2.4.2：准备   项目log4j-weblayout上的（default-cli）：你没有SNAPSHOT   项目在反应堆项目清单中。 - ＆GT; [帮助1]

另外添加：

<parent>
        <groupId>org.sonatype.oss</groupId>
        <artifactId>oss-parent</artifactId>
        <version>9</version>
</parent>

此父pom为您提供了一些现成的功能，例如配置maven-gpg-plugin以签署您的JAR。

现在运行mvn release:clean release:prepare来生成工件和gpg签名。它会给你一些类似的东西：

log4j-weblayout-0.0.1-BETA-javadoc.jar.asc
log4j-weblayout-0.0.1-BETA-sources.jar.asc
log4j-weblayout-0.0.1-BETA.pom.asc
log4j-weblayout-0.0.1-BETA.pom
log4j-weblayout-0.0.1-BETA.jar.asc
log4j-weblayout-0.0.1-BETA-javadoc.jar
log4j-weblayout-0.0.1-BETA-sources.jar
log4j-weblayout-0.0.1-BETA.jar

现在将这些打包成一个JAR：

jar -cvf bundle.jar log4j-weblayout-0.0.1-BETA*

转到Sonatype Nexus并使用您的凭据登录。转到暂存上传并上传您的捆绑包。

enter image description here

然后转到staging repositories部分，选择您的存储库并点击发布（更多帮助here）。评论你发布工件并等待一段时间的jira问题。

现在，您的用户可以搜索并使用central repository中的工件： enter image description here

相关问题
最新问题