阅读更多
本篇博文介绍如何将自己的项目发布到Maven中央仓库
大致步骤如下:
注册Sonatype Jira帐户
为新项目托管创建Jira issue
安装gpg加密工具
使用gpg生成密钥对
上传密钥
编写项目的pom.xml文件
修改maven的settings.xml文件
发布项目
Sonatype Jira帐户点击注册 Sonatype Jira
分别填写
Email: 邮箱Full name: 不知道什么用Username: 这是用于登陆的账号Password: 登陆密码
记录一下账号
Full Name: Chenfeng He
username: liuyehcf
mail: 1559500551@qq.com
password: !H+routine
Jira issue点击创建 Jira issue
分别填写
概要: 描述一下你的项目Group Id: 非常重要，如果你已经有一个公司或者个人的域名了，可以将这个域名作为Group Id，如果随便填写了一个，那么后续工作人员会要求你修改成一个合法域名，或者可以免费使用com.github.xxxProject URL: 项目url，例如https://github.com/liuyehcf/compile-engineSCM url: 例如https://github.com/liuyehcf/compile-engine.git
博主创建的issue
gpg加密工具装个工具，这里就不啰嗦了
gpg生成密钥对gpg --full-gen-key创建秘钥对
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 gpg (GnuPG) 2.2.11; Copyright (C) 2018 Free Software Foundation, Inc. This is free software: you are free to change and redistribute it. There is NO WARRANTY, to the extent permitted by law. 请选择您要使用的密钥种类： (1) RSA and RSA (default) (2) DSA and Elgamal (3) DSA (仅用于签名) (4) RSA (仅用于签名) 您的选择？ 1 RSA 密钥长度应在 1024 位与 4096 位之间。 您想要用多大的密钥尺寸？(2048) 您所要求的密钥尺寸是 2048 位 请设定这把密钥的有效期限。 0 = 密钥永不过期 <n> = 密钥在 n 天后过期 <n>w = 密钥在 n 周后过期 <n>m = 密钥在 n 月后过期 <n>y = 密钥在 n 年后过期 密钥的有效期限是？(0) 密钥永远不会过期 以上正确吗？(y/n)y You need a user ID to identify your key; the software constructs the user ID from the Real Name, Comment and Email Address in this form: "Heinrich Heine (Der Dichter) <heinrichh@duesseldorf.de>" 真实姓名：Chenfeng He 电子邮件地址：1559500551@qq.com 注释：xxx 您选定了这个用户标识： “Chenfeng He (xxx) <1559500551@qq.com>” 更改姓名(N)、注释(C)、电子邮件地址(E)或确定(O)/退出(Q)？O 我们需要生成大量的随机字节。这个时候您可以多做些琐事(像是敲打键盘、移动 鼠标、读写硬盘之类的)，这会让随机数字发生器有更好的机会获得足够的熵数。 我们需要生成大量的随机字节。这个时候您可以多做些琐事(像是敲打键盘、移动 鼠标、读写硬盘之类的)，这会让随机数字发生器有更好的机会获得足够的熵数。 gpg: 密钥 80251AB9CBDE37E2 被标记为绝对信任 gpg: revocation certificate stored as '/Users/hechenfeng/.gnupg/openpgp-revocs.d/6592F29ED898696AD57C3F9180251AB9CBDE37E2.rev' 公钥和私钥已经生成并经签名。 pub rsa2048 2019-06-01 [SC] 6592F29ED898696AD57C3F9180251AB9CBDE37E2 uid Chenfeng He (xxx) <1559500551@qq.com> sub rsa2048 2019-06-01 [E]
在交互过程中，会让你输入一个密码，记住这个密码，待会配置settings.xml需要用到
设置好加密密钥后，需要发布到OSSRH服务器上，因为，你会使用这个密钥加密你的jar包，当你上传你的jar包到OSSRH服务器时，它就会用它来解密
可以用gpg --list-key查看刚才创建的密钥
使用命令gpg --keyserver hkp://pool.sks-keyservers.net --send-keys 6592F29ED898696AD57C3F9180251AB9CBDE37E2上传秘钥
上传公钥时，提示no route to host，可以用ip替换域名（ping一下这个域名得到ip）
gpg --keyserver 216.66.15.2 --send-keys 6592F29ED898696AD57C3F9180251AB9CBDE37E2
pom.xml文件OSSRH接受的项目的POM文件需要包含如下内容
<modelVersion/><groupId/><artifactId/><version/><packaging/><name/><description/><url/><licenses/><developers/><scm/>
此外，发布过程还会依赖一些插件，包括
maven-release-pluginmaven-source-pluginmaven-surefire-pluginmaven-scm-pluginnexus-staging-maven-pluginmaven-gpg-pluginmaven-javadoc-pluginmaven-deploy-plugin
下面是博主编译引擎项目的pom文件示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 <?xml version="1.0" encoding="UTF-8" ?> <project xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance" xmlns ="http://maven.apache.org/POM/4.0.0" 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.github.liuyehcf</groupId > <artifactId > compile-engine</artifactId > <version > 1.0.0</version > <packaging > jar</packaging > <name > compile-engine</name > <description > compile engine</description > <url > https://github.com/liuyehcf/liuyehcf-framework</url > <licenses > <license > <name > The Apache Software License, Version 2.0</name > <url > http://www.apache.org/licenses/LICENSE-2.0.txt</url > <distribution > repo</distribution > </license > </licenses > <scm > <connection > scm:git:git@github.com:liuyehcf/liuyehcf-framework.git</connection > <developerConnection > scm:git:git@github.com:liuyehcf/liuyehcf-framework.git</developerConnection > <url > git@github.com:liuyehcf/liuyehcf-framework.git</url > <tag > 1.0.0</tag > </scm > <developers > <developer > <id > liuye</id > <name > Chenfeng He</name > <email > 1559500551@qq.com</email > </developer > </developers > <distributionManagement > <snapshotRepository > <id > ossrh</id > <url > https://oss.sonatype.org/content/repositories/snapshots</url > </snapshotRepository > </distributionManagement > <dependencies > <dependency > <groupId > junit</groupId > <artifactId > junit</artifactId > <version > 4.12</version > <scope > test</scope > </dependency > </dependencies > <build > <finalName > compile-engine</finalName > <plugins > <plugin > <groupId > org.apache.maven.plugins</groupId > <artifactId > maven-compiler-plugin</artifactId > <version > 3.6.0</version > <configuration > <source > 1.8</source > <target > 1.8</target > <encoding > UTF-8</encoding > </configuration > </plugin > <plugin > <groupId > org.apache.maven.plugins</groupId > <artifactId > maven-release-plugin</artifactId > <version > 2.5.3</version > <configuration > <mavenExecutorId > forked-path</mavenExecutorId > <useReleaseProfile > false</useReleaseProfile > <arguments > -Psonatype-oss-release</arguments > <pushChanges > false</pushChanges > <localCheckout > false</localCheckout > <autoVersionSubmodules > true</autoVersionSubmodules > <checkModificationExcludes > <checkModificationExclude > .idea/</checkModificationExclude > <checkModificationExclude > .idea/*</checkModificationExclude > <checkModificationExclude > .idea/libraries/*</checkModificationExclude > <checkModificationExclude > pom.xml</checkModificationExclude > </checkModificationExcludes > </configuration > <dependencies > <dependency > <groupId > org.apache.maven.plugins</groupId > <artifactId > maven-scm-plugin</artifactId > <version > 1.8.1</version > </dependency > </dependencies > </plugin > <plugin > <groupId > org.apache.maven.plugins</groupId > <artifactId > maven-source-plugin</artifactId > </plugin > <plugin > <groupId > org.apache.maven.plugins</groupId > <artifactId > maven-surefire-plugin</artifactId > </plugin > <plugin > <groupId > org.apache.maven.plugins</groupId > <artifactId > maven-scm-plugin</artifactId > <version > 1.8.1</version > </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 > <plugin > <groupId > org.apache.maven.plugins</groupId > <artifactId > maven-gpg-plugin</artifactId > <executions > <execution > <id > sign-artifacts</id > <phase > verify</phase > <goals > <goal > sign</goal > </goals > </execution > </executions > </plugin > <plugin > <groupId > org.apache.maven.plugins</groupId > <artifactId > maven-source-plugin</artifactId > <version > 2.1.2</version > <executions > <execution > <id > attach-sources</id > <phase > verify</phase > <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 > <configuration > <aggregate > true</aggregate > <charset > UTF-8</charset > <encoding > UTF-8</encoding > <docencoding > UTF-8</docencoding > <additionalparam > -Xdoclint:none</additionalparam > </configuration > <executions > <execution > <id > attach-javadocs</id > <goals > <goal > jar</goal > </goals > </execution > </executions > </plugin > <plugin > <artifactId > maven-deploy-plugin</artifactId > <version > 2.8.2</version > <executions > <execution > <id > default-deploy</id > <phase > deploy</phase > <goals > <goal > deploy</goal > </goals > </execution > </executions > </plugin > </plugins > </build > <profiles > <profile > <id > sonatype-oss-release</id > <build > <plugins > <plugin > <groupId > org.apache.maven.plugins</groupId > <artifactId > maven-source-plugin</artifactId > <version > 2.1.2</version > <executions > <execution > <id > attach-sources</id > <goals > <goal > jar-no-fork</goal > </goals > </execution > </executions > </plugin > </plugins > </build > </profile > </profiles > </project >
settings.xml文件settings.xml需要配置如下内容
配置Sonatype Jira账户信息
gpg密码配置
下面是博主的settings.xml文件示例
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 <?xml version="1.0" encoding="UTF-8" ?> <settings xmlns ="http://maven.apache.org/SETTINGS/1.0.0" xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation ="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd" > <pluginGroups > </pluginGroups > <proxies > </proxies > <servers > <server > <id > ossrh</id > <username > liuyehcf</username > <password > Sonatype Jira账号密码</password > </server > </servers > <mirrors > </mirrors > <profiles > <profile > <id > ossrh</id > <activation > <activeByDefault > true</activeByDefault > </activation > <properties > <gpg.executable > gpg</gpg.executable > <gpg.passphrase > 创建gpg秘钥的时候配置的密码</gpg.passphrase > </properties > </profile > </profiles > </settings >
执行mvn clean deploy，大概1-2天，在maven中央仓库就可以看到你的项目了
注意，在执行过程中，可能会遇到如下问题
gpg: signing failed: Inappropriate ioctl for device
原因是 gpg 在当前终端无法弹出密码输入页面。
解决办法很简单：export GPG_TTY=$(tty)，然后再执行mvn clean deploy，就能弹出一个密码输入界面了
sonatype-查看进度