AndroidStudio 发布开源库Library到jcenter(填了N个坑)

- 日理万妓 2022-04-13 13:49 250阅读 0赞

前言:

> 将自己编写的功能库开源出来，方便他人交流，查找问题，同时，gradle 依赖方式也快捷使用。

### **前期准备工作** ###

**1. 注册账户**

点击进入[bintray注册页面][bintray]。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70]

输入相关信息，如下图所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 1]  
创建成功后，出现等待激活页面，如下图所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 2]  
打开谷歌邮箱，点击激活的邮件，如下所示：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 3]

**2. 创建maven仓库**

查看对应的仓库是否存在，输入`https://bintray.com/用户名/仓库名`，这里，个人输入`https://bintray.com/hexingen/maven`,发现该代码仓库不存在，如下所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 4]  
因此，需要手动创建该仓库。登入账号后，进入edit your profile页面，点击打开Repositories，如下所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 5]  
点击new repository，创建相应的代码库，如下图所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 6]  
**3. 获取到api key**：

登录后，点击右上角头像初的edit profile，进入编辑页面，如下图所示：  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 7]

点击API Key，就可以看到你一段key字符串，把这个copy下放一边，一会上传要用。

### **AndroidStudio上的配置上传操作** ###

**1. 在项目的build.gradle中添加**：

buildscript {
        
        repositories {
            google()
            jcenter()
        }
    dependencies {
            classpath 'com.android.tools.build:gradle:3.1.2'
            //修改此处版本号为 0.8.0---修改之前是0.3.4(AS版本3.1.4改为0.8.0)
            classpath 'com.novoda:bintray-release:0.8.0'
            // NOTE: Do not place your application dependencies here; they belong
            // in the individual module build.gradle files
        }
    }
    
    allprojects {
        repositories {
            google()
            jcenter()
        }
        解决编码GBK的不可映射字符，中文注释问题
        tasks.withType(Javadoc) {
            options{
                encoding "UTF-8"
                charSet 'UTF-8'
                links "http://docs.oracle.com/javase/7/docs/api"
            }
        }
    }

**重点**：这里存在一些坑，**不同的studio版本需要选择不同的bintray-release版本**

**2. 在Library Module的builde.gradle中添加**：

添加bintray插件，和配置bintray的相关信息。

apply plugin: 'com.novoda.bintray-release'//添加
    
    
    android {
    
        //取消lint检查
        lintOptions {
            abortOnError false
        }
    }
    
    //添加
    publish {
        userOrg = 'hexingen'//bintray.com用户名
        groupId = 'com.xingen'//jcenter上的路径
        artifactId = 'androidjslib'//项目名称
        publishVersion = '1.0.0'//版本号
        desc = 'Oh hi, this is a nice description for a project, right?'//描述，不重要
        website = 'https://github.com/13767004362/WebViewLib'//网站，github上的地址
    }

**3. terminal窗口中执行命令行**：

执行上传操作，输入相关命令行，运行等待上传结果，如下图所示：

![在这里插入图片描述][20181129173724469.jpg]

gradlew clean build bintrayUpload 
     -PbintrayUser=hexingen 
     -PbintrayKey=xxxxxxxxxxxxxxxxxxxxxx 
     -PdryRun=false

**解释说明**：

*  PbintrayUser：用户名
 *  PbintrayKey :前面拷贝的api key
 *  PdryRun ： 配置参数，当为true的时候，会运行所有的环节，但是不会上传  
    上传成功后，如下图所示：  
    ![在这里插入图片描述][20181129174148564.jpg]

### **Bintray网站上的操作** ###

1.  打开浏览器输入`https://bintray.com/自己的用户名/仓库名`，这里是`https://bintray.com/hexingen/maven`,出现上传成功的库，如下图：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 8]
2.  打开该库，查看相关信息，如下图所示：  
    ![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 9]

3.点击add to Jecenter，跳转提交信息页面，如下所示：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 10]

4.输入简单信息，提交完信息后，等待审核通过。等待几小时后，通过审核，会受到消息，如下图所示：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 11]

最后一步，在gradle中进行依赖，方便快捷使用该库了，如下图所示：

![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 12]

#### **该库的项目链接： [https://github.com/13767004362/WebViewLib][https_github.com_13767004362_WebViewLib]** ####

--------------------

## **遇到的问题** ##

**1. 提交完项目后，没有`Add To jcenter`按钮**

注册或者登入账号，应该选择`For Open Source account`方式登录

**2. 遇到`HTTP/1.1 404 Not Found [message:Repo 'maven' was not found]`**

Execution failed for task ':androidjslib:bintrayUpload'.
    > Could not create package 'hexingen/maven/androidjslib': HTTP/1.1 404 Not Found [message:Repo 'maven' was not found]

查询才知道，原来需要自己去创建maven仓库。

解决方式：[手动创建maven仓库][maven]

**3. androidstudio3.0 遇到`Unable to load class ‘org.gradle.api.internal.component.Usage’`问题。**

解决方式: [来源网上答案][Link 1]

buildscript {
        
        repositories {
            google()
            jcenter()
        }
        dependencies {
            classpath 'com.android.tools.build:gradle:3.1.2'
            //修改此处版本号为 0.5.0---修改之前是0.3.4(AS版本3.1.4改为0.8.0)
            classpath 'com.novoda:bintray-release:0.5'
            // NOTE: Do not place your application dependencies here; they belong
            // in the individual module build.gradle files
        }
    }

**4. 遇到编码GBK的不可映射字符**

解决方式：

//解决编码GBK的不可映射字符
    allprojects {
        tasks.withType(Javadoc) {
            options{
                encoding "UTF-8"
                charSet 'UTF-8'
                links "http://docs.oracle.com/javase/7/docs/api"
            }
        }
    }

**5.遇上`Execution failed for task ':core:lint'.`**

关闭lint检查

解决方式：

lintOptions {
            abortOnError false
        }

**资源参考**：

*  [https://blog.csdn.net/lmj623565791/article/details/51148825][https_blog.csdn.net_lmj623565791_article_details_51148825]
 *  [https://github.com/novoda/bintray-release][https_github.com_novoda_bintray-release]
 *  [https://github.com/13767004362/WebViewLib][https_github.com_13767004362_WebViewLib]

[bintray]: https://bintray.com/signup/oss
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70]: /images/20220413/53531b2cb1cd4b36a444b20a45a5d0aa.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 1]: /images/20220413/74854591134440d7b953742d24d87b7a.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 2]: /images/20220413/f9e7d290dcc54f538385fe12f69e575f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 3]: /images/20220413/16a59a16aca14a2f8085cbca00a7b16e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 4]: /images/20220413/519520bbfc2d444cb382300449181da5.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 5]: /images/20220413/becc975f737348c7a4c09801fb56f201.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 6]: /images/20220413/51ecdfc659b9402eba68fbb284493475.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 7]: /images/20220413/e23cdbfd72764c1880d246a6a2d6eceb.png
[20181129173724469.jpg]: /images/20220413/efcd5eb0ba8c4c2f824a923e0726aa40.png
[20181129174148564.jpg]: /images/20220413/5ffd8b2c0716470daeda167155cf36cf.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 8]: /images/20220413/1221cf023fc2480eb36f4a9c43a70995.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 9]: /images/20220413/7aab94948ec942c5995a31b37cfab1de.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 10]: /images/20220413/c24bf5961e664531ae5bb07123a1ae9f.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 11]: /images/20220413/3675a382ce8b43a4ba09d5faf8676240.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2hleGluZ2Vu_size_16_color_FFFFFF_t_70 12]: /images/20220413/71f829d220124116a103ad538a1e91e3.png
[https_github.com_13767004362_WebViewLib]: https://github.com/13767004362/WebViewLib
[maven]: https://blog.csdn.net/tmac2000/article/details/53261141
[Link 1]: https://blog.csdn.net/u013110200/article/details/78424980
[https_blog.csdn.net_lmj623565791_article_details_51148825]: https://blog.csdn.net/lmj623565791/article/details/51148825
[https_github.com_novoda_bintray-release]: https://github.com/novoda/bintray-release