发布鸿蒙开源库

一、前言

一般在鸿蒙开发中都会使用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
点击新建按钮

23.png

2.4 填写工单

24.png

工单内容填写:

项目: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编号。


25.png

如图所示,我的编号是OSSRH-72200这时我需要创建一个仓库名为OSSRH-72200的仓库,仓库一定要公开的。


26.png

管理员一般会叫你创建的,你只要点击能进入你的仓库,就算创建成功了。

2.6管理员审核

管理员审核通过后会在解决情况显示已修复。


28.png

三、配置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位。


41.png

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 = "[email protected]"
                            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上传。


43.png

4.4释放临时库

终于到了最后一步了,首先进入https://s01.oss.sonatype.org/ ,然后登录你的账号。

44.png

点击close就能释放临时库。


44(2).png

再点击Release释放临时库,过一段时间就能依赖你的项目了。


44(3).png

释放完可通过搜索,找到你的开源库了。

你可能感兴趣的:(发布鸿蒙开源库)