一、前言
一般在鸿蒙开发中都会使用maven从中央仓库、阿里镜像仓库中获得类库,这些类库都是由世界各地开发者或组织上传,那么如何将自己的开源作品上传至maven中央仓库呢?下面我来实现这个操作。
二、创建工单
2.1 注册maven
注册地址:https://issues.sonatype.org/secure/Signup!default.jspa
2.2 登录maven工单系统
地址:https://issues.sonatype.org/login.jsp
2.3 跳转到工单管理页,点击新建
地址:https://issues.sonatype.org/secure/Dashboard.jspa
点击新建按钮
2.4 填写工单
工单内容填写:
项目:Community Support - Open Source Project Repository Hosting (OSSRH)
问题类型:New Project
概要:随便写
Group Id:项目group,例如com.v2hoping。该Group Id为域名,该域名必须归你所有,若没有请使用github或gitee的地址,例如com.github.ming123aaa、io.gitee.a3077932030。使用github或gitee新建完需要你创建一个空仓库,已确保账号是你的。
Project URL:项目的github或gitee地址,例如https://gitee.com/a3077932030/base-app_harmony
SCM url:项目的git地址,例如https://gitee.com/a3077932030/base-app_harmony.git
其他不用填写
然后新建。
2.5创建仓库
创建完成后要马上创建一个git仓库(根据你填的Group Id决定你是在github还是gitee创建)。
点击问题,查看问题的OSSRH编号。
如图所示,我的编号是OSSRH-72200这时我需要创建一个仓库名为OSSRH-72200的仓库,仓库一定要公开的。
管理员一般会叫你创建的,你只要点击能进入你的仓库,就算创建成功了。
2.6管理员审核
管理员审核通过后会在解决情况显示已修复。
三、配置gpg-key
3.1 安装gpg
Mac环境:brew install gpg
Windows环境:下载https://www.gpg4win.org
分为以下几个步骤,windows是界面操作比较简单,以mac为例:
(1)gpg产生秘钥key
gpg --gen-key
输入真实姓名、电子邮件地址、注释
(2)输入passphrase
输入passphrase私钥保护密码(这个一定要记住)
(3)检查生成秘钥
gpg --list-keys
(4)发布秘钥
gpg --keyserver hkp://keyserver.ubuntu.com:11371 —send-keys 刚刚查询到的秘钥
若不成功尝试一下几个域名:
keyserver.ubuntu.com
pgp.mit.edu
subkeys.pgp.net
www.gpg-keyserver.de
(5)验证发布是否成功
gpg --keyserver hkp://keyserver.ubuntu.com:11371 --recv-keys 秘钥
输出:
gpg: 密钥 *****:“你的真实姓名 <你的邮箱>”未改变
gpg: 合计被处理的数量:1
gpg: 未改变:1
输出以上信息说明发布秘钥成功
(6)密钥导出
导出公钥命令
gpg -a --export 公私钥生成的用户 > 导出的公钥文件路径和文件名
示例:gpg -a --export weblogic >weblogic_pub.asc
导出私钥命令
gpg -a --export-secret-keys 公私钥生成的用户 >导出的私钥文件路径和文件名
示例:gpg -a --export-secret-keys weblogic >weblogic_pri.asc
四、项目配置
4.1签名配置
在gradle.properties添加以下代码
signing.keyId=7E1C391B //keyID
signing.password=****** //创建密钥的时候 设置的密码
signing.secretKeyRingFile=E:/Key/secring.gpg //私钥到路径
其中KeyId为这串字符后8位。
4.2gradle配置
在项目根目录创建一个upload.gradle的文件。
然后根据以下模板,修改成自己的内容。
apply plugin: 'maven-publish'
apply plugin: 'signing'
def DEFAULT_POM_NAME = 'baseHm'
def DEFAULT_POM_VERSION = '1.0.0' //har包版本信息
def DEFAULT_POM_ARTIFACT_ID = "BaseHm" //har包ID
def DEFAULT_POM_GROUP_ID = 'io.gitee.a3077932030' //项目组ID
def DEFAULT_POM_PACKAGING = 'har' //包类型,固定为har
def DEFAULT_POM_DESCRIPTION = 'base on harmonyos'
def MAVEN_USERNAME = '' //远程Maven仓的用户名
def MAVEN_PASSWORD = '' //远程Maven仓的密码
def LOCAL_MAVEN_REPOSITORY_URL = 'E:/0.maven' //本地Maven仓地址
def REMOTE_MAVEN_REPOSITORY_URL = 'https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/'//远程Maven仓地址
def ProjectUrl="https://gitee.com/a3077932030/hmwidget_hmos"//项目地址
afterEvaluate { project ->
DEFAULT_POM_ARTIFACT_ID = project.name
publishing {
publications {
maven(MavenPublication) {
from components.debug
group = DEFAULT_POM_GROUP_ID
artifactId = DEFAULT_POM_ARTIFACT_ID
version = DEFAULT_POM_VERSION
pom {
name = DEFAULT_POM_NAME
description = DEFAULT_POM_DESCRIPTION
packaging = DEFAULT_POM_PACKAGING
url =ProjectUrl
licenses {
license {
name = "The Apache License, Version 2.0"
url = "http://www.apache.org/licenses/LICENSE-2.0.txt"
}
}
developers {
developer {//开发者信息
id = "3077932030"
name = "gejunming"
email = "3077932030@qq.com"
organization ="gitee"
organizationUrl="https://gitee.com/a3077932030"
}
}
scm {
connection = "scm:git:"+ProjectUrl
developerConnection = "scm:git:"+ProjectUrl
url = ProjectUrl
}
}
}
}
repositories {
maven {
// url = LOCAL_MAVEN_REPOSITORY_URL //发布到本地Maven仓
//发布到远程Maven仓的地址以及Maven仓的帐号和密码
url = REMOTE_MAVEN_REPOSITORY_URL
credentials {
username MAVEN_USERNAME
password MAVEN_PASSWORD
}
}
}
}
signing {
sign publishing.publications.maven
}
}
远程仓库地址目前可选择以下两个:
以下存储库允许您直接访问 OSSRH 中的组件。用户只需通过中央存储库直接获取您的组件,但对于项目中的提交者和其他合作者,此列表可能很有用。
用于快照部署和下载访问的存储库 URL
https://s01.oss.sonatype.org/content/repositories/snapshots/
用于发布部署的存储库 URL,无下载权限!
https://s01.oss.sonatype.org/service/local/staging/deploy/maven2/
注意:自 2021 年 2 月起,所有新项目都开始在https://s01.oss.sonatype.org/上进行配置 。如果您的项目未在https://s01.oss.sonatype.org/ 上配置,您将需要使用旧主机https://oss.sonatype.org/。
如有疑问请查看官方指南:https://central.sonatype.org/publish/
4.3上传到远程仓库
首先需要在你要上传的Module中的build.gradle中添加
apply plugin: 'com.huawei.ohos.library'
apply from:'../upload.gradle'
然后在gradle相应的Module的pubulishing中点击publish上传。
4.4释放临时库
终于到了最后一步了,首先进入https://s01.oss.sonatype.org/ ,然后登录你的账号。
点击close就能释放临时库。
再点击Release释放临时库,过一段时间就能依赖你的项目了。
释放完可通过搜索,找到你的开源库了。