AS发布依赖库到Jcenter

AS发布依赖库到Jcenter

参考1 Android Studio 发布项目到 JCenter 以及常见错误

参考2 如何通过Android Studio发布library到jCenter和Maven Central

插件 bintray-release

项目发布到JCenter好处多多，最明显的就是只需在gradle里添加一行依赖就可以轻松引入。随着Android Studio的普及，越来越多的项目已经传到了JCenter。参考链接1是不用插件的方式，完全自己配置，比较麻烦，参考链接2是用了bintray-release插件的方式，简单稳定，因此我就采用了参考链接2的方式，本文纯属总结，内容来着上面链接的整合。

相关知识介绍

1. 三种常用的资源仓库：Jcenter , Maven Central 和 特殊的资源仓库
   Jcenter
   jcenter是一个托管在bintray.com的资源库。你可以在这里找到需要的资源。

    allprojects {
        repositories {
            jcenter()
        }
    }
   

   JMaven Central
   Maven Central是一个托管在sonatype.org的资源库。你可以在这里找到需要的资源。

    allprojects {
        repositories {
         mavenCentral()
        }
    }
   

   请注意，虽然jcenter和Maven Central都是标准android library资源仓库，但他们的托管地址完全不同，它们的内容是由不同提供者提供的，而且之间并没有任何关联。所以也就可能，在jcenter中能够找到的library，在Maven Central中并不能找到,maven central是jcenter的子集，上传到jcenter上的库，可以一键发布到maven central上，十分简单，jcenter界面更友好，jcenter通过CDN发送library，下载更快。
   
   特殊的资源仓库
   除了这两个标准的资源库外，我们也可以定义特殊的资源库，引入一些开发者托管在自己服务器上的library。比如：上传一个依赖库到bintray的个人账户上，不想同步到Jcenter（同步到jcenter就不能再删除了），需要在项目的build.gradle文件下面，定义资源库的url.

   allprojects {
   repositories {
       google()
       jcenter()
       //ui-kit的远程地址
       maven { url "https://dl.bintray.com/kelly-bit/maven/" } //这是你需要加入的
       }
   }
   

   然后你可以通过和标准资源库相似的方法获取该资源库里面的任何library，在app的build.gradle文件下面，加上依赖。

   allprojects {
   //ui-kit
   implementation "com.example.textlibrary:ui-kit:1.0.2"
   }
   

2. 认识一下Maven仓库的链接
   以gson为例，我们指定了jcenter，然后在dependencies中加入compile 'com.google.code.gson:gson:2.3.1'就可以了。其中com.google.code.gson:gson:2.3.1称为library的库链接，也成为库地址。由三部分组成：GROUP_ID:ARTIFACT_ID:VERSION

• GROUP_ID：通常以开发者包名紧跟着library的group名称来命名。如上面的就是com.google.code+gson来命名。
• ARTIFACT_ID：你的library的真实名称。
  artifact ['ɑrtə,fækt] n. 人工制品；手工艺品
• VERSION：就是你library的版本号。
  三者之间以半角冒号分隔。

3. 上传的过程
   

   jcenter1.jpg

4. 上传的内容
   

   jcenter5.jpg

开始上传

1. 注册Bintray账号
   要想传到JCenter,必须经过他爸爸Bintray才可以,到https://bintray.com/注册，要用Google邮箱才行哦.(个人试用就不要注册组织哦，组织是30天试用的功能，要花钱的。)

   删除账号
   如果误注册成企业版占用了用户名邮箱，想注销怎么办？
   其实也简单，1.先取消Premium Organizations（高级组织）的标识，再删除组织 2. 鼠标放在右上角头像出，在弹出浮层上点击Edit Profile，拉到最下面有个Delete Account，点击验证后就可以注销账号。

2. 在项目build.gradle的dependencies下添加
   classpath 'com.novoda:bintray-release:0.9.1'
   注意是项目的不是module的bulid文件。用希望的版本号替换0.9.1，建议使用最新版本，最新版本号可以在 https://github.com/novoda/bintray-release 查看。如图

buildscript {
    ext.kotlin_version = '1.3.50'
    ext.kotlin_version = '1.3.31'
    ext.anko_version = '0.10.1'

    repositories {
        google()
        jcenter()
    }
    dependencies {
        XXX
        classpath 'com.novoda:bintray-release:0.9.1'
    }
}

jcenter2.png

3. 配置要上传的moudle

下面操作均在要上传的moudle的build.gradle文件进行。

//添加引用
apply plugin: 'com.novoda.bintray-release'

publish {
    userOrg = 'kelly-bit' //bintray注册的用户名（不是邮箱）
    groupId = 'com.example.textlibrary'
    artifactId = 'ui-kit' //项目名称
    publishVersion = '1.0.2' //版本号
    desc = '测试上传jcenter项目' //项目描述。可空。
    website = 'https://github.com/novoda/bintray-release' //项目地址，一般填github地址。
    repoName = 'maven'//Repository的名字，和在bintray上面添加的Repository的名字保持一致，不配置此項，默認叫maven
    bintrayUser = 'kelly-bit'
    bintrayKey = 'bd8f1ac1094cff6f882eaa6ee7d08f17a89aa3fb'
    dryRun = false
}

1.repoName Repository的名字，和在bintray上面添加的Repository的名字保持一致，不配置此項，默認叫maven 2.website 项目地址,一般填github地址,不可空
API Key
在bintray.com网站上登陆后，鼠标移动到右上角头像，点Edit Profile，在左侧找到API Key点击去就可以看到了。如图。

jcenter3.png

假如按照以上设置，那么最终项目的引用格式就是：
implementation "com.example.textlibrary:ui-kit:1.0.2"
可以对照着修改。

4.新建仓库
在bintray.com网站上，新建一个仓库，和上传的moudle的build.gradle文件保持一致，默认叫maven

jcenter6.jpg

5.上传
一切准备就绪，可以开始上传了。很简单，直接在Android Studio Terminal面板执行：gradlew clean build bintrayUpload
就ok。经过漫长等待，如果显示BUILD SUCCESSFUL ，那么恭喜，上传完成了。
或者如下图双击也行。

jcenter7.jpg

6.提交到JCenter
到此为止项目仅仅是传到了Bintray，并没有同步到JCenter。
先点进去刚传的项目，可以看到右下方Linked to模块有个Add to JCenter按钮，点击后打开一个网页，在此输入这个项目的描述（最好英文），不用多长，一句话就可以。然后点击Send可以提交审核。通过后会有站内消息提示，一般几小时就可以通过，很容易的。

jcenter4.jpg

7.升級版本
修改內容,升級版本号，再重新执行第5条的命令就可以了，依赖的項目也相应的改一下版本号重新build就可以了。

8.maven仓库的url

jcenter8.jpg