Android Studio 发布开源项目到JCenter 教程

背景

开源一直是Android 的优势,代码共享,不仅可以造福其他程序员,也可以发现自身不足,从而提升自己。Github上有太多优秀的开源库,这使得我们在项目开发中非常方便,不用重复造轮子。只需要在build.gradle 中 添加添加一行代码compile ‘ xxxx ‘(如:compile ‘com.android.support:appcompat-v7:24.2.1’) 就可以使用了,非常方便。最近在学习如何将自己写的代码开源,也就是将项目发布到JCenter, 这个过程中也遇到了一些问题,通过Google 和参考了一些博客,折腾了大半天才搞定,本篇本章对学习过程中的知识点和遇到的问题做一个记录和总结。

正文

本篇文章以自己的一个小项目CustomPopwindow为例,讲一下通过Android Studio 发布开源项目到JCenter的步骤:

1,要将我们的项目发布到JCenter,首先我们需要到Bintray官网注册一个帐号,一般都有Github,所以选择直接用Github 登陆,如图:

《Android Studio 发布开源项目到JCenter 教程》 step1.png

2,登陆之后,来到 Bintray 的主页:

《Android Studio 发布开源项目到JCenter 教程》 step2.png

上图两个红色尖头标记的很重要,user 和 userOrg,后面会用到这2个,在第一步点击登陆后会让你填公司名字(随便填一个就好)Company,然后会根据Company 生成一个默认的组织 Organization, 根据上图的菜单可以看出,我们还可以创建新的Organization。

3,点击 edit profile ,获取 apikey ,这个key 后面会用。点击show 就可显示出来。

《Android Studio 发布开源项目到JCenter 教程》 step3.png
《Android Studio 发布开源项目到JCenter 教程》 step4.png

4,通过右上角的菜单,进入我们创建的Organization,然后在这个Organization里面创建一个仓库repo( 也就是我们发布的项目在JCenter 上存放的仓库)

《Android Studio 发布开源项目到JCenter 教程》 step6.png

5,创建好仓库后,在仓库里面创建一个Package, 也就是我们发布的项目在JCenter 上的名字,如图

《Android Studio 发布开源项目到JCenter 教程》 step7.png

6,创建好了之后,在我们的仓库里就会有这个项目了,如下图:

《Android Studio 发布开源项目到JCenter 教程》 step7.1.png

** 通过以上6步,我们的准备工作就做完了,接下来就是在 Android Studio 中,添加代码,执行命令上传 **

7,在项目中local.properties 中添加 user和apikey

bintray.user=xxxxx
bintray.apikey=xxxx

也就是上面步骤2和步骤3标出来的 user 和apikey.

8,在项目最外层的build.gradle 中添加如下两行代码

 dependencies {
        classpath 'com.android.tools.build:gradle:2.2.2'
       //添加以下两行
        classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'
        classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'

        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }

9,接下来在你要上传的Libray的build.gradle 中添加代码:

apply plugin: 'com.android.library'
//添加两个插件
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
// This is the library version used when deploying the artifact
// 你项目的版本号
version = "1.0.0"
android {
    compileSdkVersion 24
    buildToolsVersion "24.0.2"
    resourcePrefix "customPop__"    //这个随便填
    defaultConfig {
        minSdkVersion 16
        targetSdkVersion 24
        versionCode 1
        versionName "1.0"

        testInstrumentationRunner "android.support.test.runner.AndroidJUnitRunner"

    }
    buildTypes {
        release {
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
        }
    }
}

dependencies {
    compile fileTree(dir: 'libs', include: ['*.jar'])
    androidTestCompile('com.android.support.test.espresso:espresso-core:2.2.2', {
        exclude group: 'com.android.support', module: 'support-annotations'
    })
    compile 'com.android.support:appcompat-v7:24.2.1'
    testCompile 'junit:junit:4.12'
}


def siteUrl = 'https://github.com/pinguo-zhouwei/CustomPopwindow'      // 项目的主页
def gitUrl = 'https://github.com/pinguo-zhouwei/CustomPopwindow.git'   // Git仓库的url
group = "com.example.zhouwei.library"                                        // Maven Group ID for the artifact,一般填你唯一的包名
install {
    repositories.mavenInstaller {
        // This generates POM.xml with proper parameters
        pom {
            project {
                packaging 'aar'
                // Add your description here
                name 'Android PopupWindow widget'   //项目描述
                url siteUrl
                // Set your license
                licenses {
                    license {
                        name 'The Apache Software License, Version 2.0'
                        url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
                    }
                }
                developers {
                    developer {
                        id 'zhouwei'        //填写的一些基本信息
                        name 'JayZhou'
                        email 'zhouweigmail@163.com'
                    }
                }
                scm {
                    connection gitUrl
                    developerConnection gitUrl
                    url siteUrl
                }
            }
        }
    }
}
task sourcesJar(type: Jar) {
    from android.sourceSets.main.java.srcDirs
    classifier = 'sources'
}
task javadoc(type: Javadoc) {
    source = android.sourceSets.main.java.srcDirs
    classpath += project.files(android.getBootClasspath().join(File.pathSeparator))
}
task javadocJar(type: Jar, dependsOn: javadoc) {
    classifier = 'javadoc'
    from javadoc.destinationDir
}
artifacts {
    archives javadocJar
    archives sourcesJar
}
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
    user = properties.getProperty("bintray.user")
    key = properties.getProperty("bintray.apikey")
    configurations = ['archives']
    pkg {
        userOrg = "weiyinshidai"//JCenter上创建的的Organization 
        repo = "maven"//你要上传的库的名字
        name = "CustomPopwindow"    //发布到JCenter上的项目名字
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish = true
    }
}

以上代码** 添加注释的地方换成你自己的**,千万别把userOrg 这个弄掉了,我当时没有加这个,一直上传不成功。

10,接下来在Android Studio 的 Terminal 中 执行以下命令命令上传了

1, ./gradlew install

2,  ./gradlew bintrayUpload

11,等到上传完全之后,进入Bintray找到你上传的项目,点击右下角的 Add to JCenter发送Request,然后就是等了,通过了之后会给你发消息到Bintray帐号上的。

《Android Studio 发布开源项目到JCenter 教程》 step11.png

12,通过之后,就可以直接在项目中通过compile 来引用了:

dependencies {
    compile 'com.example.zhouwei.library:library:1.0.0'
}

通过以上我们就能将我们的项目发布都JCenter了。

遇到的问题总结:

这个过程中遇到了两个问题,折腾了好久:

1,404 Not Found, 这个错误是你在grade 中写的repo和 userOrg 和你在Bintray上的不一致,导致找不到,下面这三个:

《Android Studio 发布开源项目到JCenter 教程》 last.png

2,401 need authorized ,这个错误是因为你的user 和 apikey 不正确,我当时是把user 这个字段的值写成 Organization 名了,一直报401,如果报这个错,请仔细检查 user 和 api key.

以上就是通过Android Studio 发布开源项目到JCenter的一些知识点及遇到的坑

参考:
1,新版Bintray,如何使用Gradle发布项目到Jcenter仓库

    原文作者:依然范特稀西
    原文地址: https://www.jianshu.com/p/3d32ad7e8841
    本文转自网络文章,转载此文章仅为分享知识,如有侵权,请联系博主进行删除。
点赞