本篇文章隶属于 《使用 Gradle 发布 AAR 到 Maven 仓库》
========================================================
作者:qiujuer
开源库:github.com/qiujuer/Genius-Android
转载请注明出处:http://blog.csdn.net/qiujuer/article/details/44195199
——学之开源,用于开源;初学者的心态,与君共勉!
========================================================
在这篇文章中将会简单讲解如何注册 https://issues.sonatype.org 账户。该账户有何作用?你注册该账户后相当于你拥有了一个远程开源仓库,请注意一点;在这里你上传到该仓库的东西将不是私有,所以私有的东西别往上传。同时你可以通过该账户管理你的唯一 项目ID ,通过该 ID 你可以发布维护版本;同样别人可以通过适当的配置获取你发布的版本。
注册
- 第一步你需要完成的是进入网站:https://issues.sonatype.org/
- 点击右上角的 Login ,如果没有在登陆页面可以点击 Sign Up 进入到注册页面。
- 在注册页面中,你需要添加的有如下信息。分别是 全名、邮箱(这个邮箱一定要真实,后续会进行验证,以及接收你的仓库一些操作信息)、用户名 、密码、确认密码、验证码。
- 注册成功后登陆。随后点击导航栏中的 “Create”别跟我说你没有看见?风格完全不同的一个按钮。随后你会看见如下界面。
- 在创建页面中,Project 项目就按照我选择的进行选择,该类型是专门用于发布开源库的类型;Issue Type 这个点击一下选择 New Project。至于下面的 Summary 就在于你取个名字了,最好取和你的 GitHub 项目相同的名字,下面的 Description 描述信息虽然是可选项,但是我建议你填写上一些简单的介绍,也可以直接把你的开源项目的介绍搬过来。
在这里或许你看见了一个地方:最下面还有一个 Attachment (附件),这个虽然也是可选择,但是如果你下面申请的 Group Id 是你的域名那么你需要的是传入你的域名所有证书,可以是图片也可以是Pdf。如果没有上传那么后面会叫你补上的,不过你注册的不是你的域名 ID 那么无需上传任何东西。
- 我们往下滚动一下,继续填写。
- Group Id : 这个中你需要的是填写你要申请的个人项目 Id ,这个 Id 是什么?在这里我给大家看一个代码:
-
// Adding to your project "build.gradle" file dependencies { compile ‘com.github.qiujuer:genius:2.4.0‘ }
可以看见其中的:“com.github.qiujuer”就是Id部分;Id 要求唯一,一般来说使用你的 GitHub 地址生成的 Id 基本就是唯一的 Id 号。或者你的个人域名也是。
如何生成呢?一般来说你的 GitHub 地址或者你的域名都可以生成,但是需要调整一下位置,总的来说有如下几种情况:
- www.springframework.org -> org.springframework
- oness.sf.net -> net.sf.oness
- qiujuer.net -> net.qiujuer
- www.qiujuer.net -> net.qiujuer
- genius.qiujuer.net -> net.qiujuer.genius
- github.com/qiujuer -> com.github.qiujuer
- git.oschina.net/qiujuer -> net.oschina.git.qiujuer
-
一般来说就是如果你的Url中有 www 是需要去掉得到域名地址,如果是 github 或者 gitosc 那么需要精确到你的个人目录,但是不必精确到你的项目,也就是说:
- github.com/qiujuer/Genius-Android -> com.github.qiujuer
-
为什么不必精确到项目呢?因为在 Group Id 中有一定的继承关系,如果你申请了 com.github.youname 那么你将自动拥有 com.github.youname.youproject 的管理权限。
在这里,如果你申请的ID 是你的域名转换得到的,那么请上传你的域名注册证书,如果是开源如 gitosc 以及 github 那么无需如此。
- 下面我们接着走,后面的部分基本都是可以直接填写出来了,无非就是填写上你的开源项目地址那些,后面的选择也和我的一样就OK。
其中有一个 Username(s) 的地方,在这里一般来说填写上你注册时的 username 就OK,如果你喜欢你的这个 Id 能多个人同时管理,都拥有上传权限那么你可以把别人的 Id 也加上,用英文逗号分隔就OK。
- 最后点击 Create 按钮,你将进入申请。
在这里你千万别说就完成了,这个只是申请而已,后面还需要经历审核-纠错(这一部一般正规填写将没有纠错的出现,如果有错误你将会收到管理人员给你的消息)- 进入到准备状态- 发布你的库或者其他开源东西-审核通过-关闭该Issue。
- 一般来说被管理员编辑到纠错的时间一般是1~2天,要看你的运气了,也有可能你刚刚申请 结果一小时后就进入到了准备状态。如果你的出现了一些错误那么你可以在该文章中评论我将会给你说说解决办法,毕竟我第一次的时候遇到了很多很多的问题。
- 如果审核通过,纠错完成那么你将会收到如下信息。
- 你的配置已经完成了,可以进入工作了。
- 上传快照版本的地址为….
- 上传发布版本的地址为…
- 暂存库中是用来为发布做准备的。
- 下载快照以及发布版本的地址为…
- 下载快照、发布以及暂存库的地址为…
- 另外当你第一次上传到库中的时候请在这里说一下你已经上传了(只有第一次的时候,后面不需要,第一次他那边会进行一些配置)
注意事项
- Group Id 的部分,一定要按照规则去申请免得后面纠错慢慢改动那些。
- 如果你没有域名或者你有域名没有域名的管理证书那么你就使用 GitHub 或者 GitOSC 的地址去申请,那样无需其他的附件,也很好申请;大部分都是这样的。
- 一定要牢记你的用户名以及密码,后面还用得上。
- 快照版本是用来发布你的测试的地方,你可以多次发布同一个版本到该目录。
- 发布版本一个版本只能发布一次文件,除非你本次发布失败了需要重新提交。
- 无论是快照版本还是发布版本都是可以通过 gradle 的方式进行访问的,只不过快照版本的访问需要多加上一个仓库地址,这个在主文章中将会讲解。
- 对于同一个版本如 1.0.0 ,你的快照发布了10个,那么你将会看见十个快照版本文件,但是只要你一发布“Release”版本,通过后你的快照文件将会清空,如果你没有发布“Release”版本那么将不会出现清空的情况。
这里是我的地址,你们可以看看,看看能有啥收获:
https://oss.sonatype.org/content/groups/public/com/github/qiujuer/
其他
本次文章完成了,后面其是还有很多,但是一次的精力有限,我会慢慢阐述,争取说清楚。比如说还有快照版本的查看等等,发布流程等待,其是发布并不是这么简单,当你上传到仓库中后还需要确认,发布,关闭等等操作。
至于更加精彩的地方请回到主文章吧。
========================================================
作者:qiujuer
开源库:github.com/qiujuer/Genius-Android
转载请注明出处:http://blog.csdn.net/qiujuer/article/details/44195199
——学之开源,用于开源;初学者的心态,与君共勉!
========================================================