如何把开源项目发布到Jcenter

转载自：https://www.jianshu.com/p/f66972f0607a

首先我们应该注册一个JFrog Bintray的账号

Jfrog Bintray官网



这里我们可以注意到那个绿色的按钮，START YOUR FREE TRIAL。注册吗，多简单的一件事啊。点了直接进去注册。注册完之后，直接开整，到最后发布的时候。你发现你会一直报错，我明明按照网上一步一步来的，怎么会报错。真正注册用于开发者的，是下面哪一行小字（我真的不明白为啥要那么不明显），For Open Source Distribution Sign Up Here，大家千万不要搞错了。

接下来输入按照注册的要求进行填写就好了，ps：一些邮箱不支持，例如163和qq。这里我是用gmai注册的，没有的话，大家不妨去注册一个，现在注册gmail需要使用手机了。选择国家地区代码的时候并找不到中国，前面国家随便选一个，然后直接在你手机前面加上86就行了。

注册成功，就可以看到我们的首页了。点击Edit Profile，如果你发现，你和我一样是七个那么注册成功。

Edit Profile界面

这里我们需要注意的信息，一个是你注册的账号，另一个是API Key，为接下来发布做准备。

准备一个需要发布的Android Studio项目

创建一个Android Studio项目，这里我们就是用默认的Module - app。现在项目的Build.gradle文件中添加需要需要使用到的依赖。

buildscript {
repositories {
  jcenter()
}
dependencies {
  classpath'com.android.tools.build:gradle:2.3.0'
  classpath'com.github.dcendents:android-maven-gradle-plugin:1.5'
  classpath'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.5'
  // NOTE: Do not place your application dependencies here; they belong
  // in the individual module build.gradle files
  }
}
allprojects {
  repositories {
    jcenter()
  }
}
task clean(type: Delete) {
  deleterootProject.buildDir
}

有两点点非常重要，第一点就是gradle build tools的版本设置成1.1.2以上，因为以前的版本有严重的bug，我们将使用的是最新的版本2.3.0。第二点是根据你Gradle的版本，使用不同版本的android-maven-gradle-plugin。这里我的Gradle版本是3.3，所以使用的是com.github.dcendents:android-maven-gradle-plugin:1.5，具体版本直接对应的关系请到如下网站去查询，android-maven-gradle-plugin。

版本直接对应关系

接下来我们将修改local.properties。在里面定义api key的用户名以及被创建key的密码，用于bintray的认证。之所以要把这些东西放在这个文件是因为这些信息时比较敏感的，不应该到处分享，包括版本控制里面。幸运的是在创建项目的时候local.properties文件就已经被添加到.gitignore了。因此这些敏感数据不会被误传到git服务器。

bintray.user=YOUR_BINTRAY_USERNAME
bintray.apikey=YOUR_BINTRAY_API_KEY

bintray.user对应的就是你注册bintray时的账号，bintray.apikey对应的就https://bintray.com/profile/edit页面中的API KEY，点击进入还需要输入你注册时的密码。输入完成直接保存下。

接下来，打开我们module下的build.gradle文件，如下：

apply plugin:'com.android.library'     //建议使用library，毕竟你是给别人用的
apply plugin:'com.github.dcendents.android-maven'
apply plugin:'com.jfrog.bintray'

version="1.0.2"           // 对应的版本

android {
    compileSdkVersion 25
    buildToolsVersion "25.0.2"
    defaultConfig {
        // 请注意这里没有Application Id。别人在他的module下的build.gradle文件依赖中，添加你的你开源项目。你的
        //defaultConfig中有Application Id，别人也会有啊，那么有两个Application Id必然会报错
        minSdkVersion15
        targetSdkVersion25
        versionCode
        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'])
    compile'com.android.support:appcompat-v7:25.3.1'
    testCompile'junit:junit:4.12'
}

defsiteUrl='https://github.com/x1ao3eng/GithubPro' // github上项目的地址
defgitUrl='https://github.com/x1ao3eng/GithubPro.git' //github上项目的git地址
group='com.x1aomeng.githubpro'
//一般用你项目的Application Id，这里一般用到哪里呢。
//举一个使用RecyclerView需要添加的依赖，compile'com.android.support:recyclerview-v7:25.3.1'
//com.android.support对应的就是上面的group，recyclerview-v7对应的就是module名字，25.3.1对应的是上面的version
install{
    repositories.mavenInstaller{
        pom {
            project{
                packaging'aar'
                // Add your description here
                name'Android Jcenter Test'
                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'huangxiaomeng'//填写的一些基本信息
                        name'x1ao3eng'
                        email'x1ao3eng@gmail.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 =newProperties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
    // 这里就使用到了，你之前在local.properties中添加的信息
    user = properties.getProperty("bintray.user")
    key = properties.getProperty("bintray.apikey")
    configurations = ['archives']
    pkg {
        repo ="maven"
        name ="GithubPro_for_jcenter_test"//发布到JCenter上的项目名字
        websiteUrl = siteUrl
        vcsUrl = gitUrl
        licenses = ["Apache-2.0"]
        publish =true
    }
}

完成这些之后先Rebuild或者Sync下你的Project，没什么问题的话。就可以把你项目生成到本地的仓库中了，Android Studio中默认即在Android\sdk\extras\android\m2repository这里，可以打开你Android Studio下方的Terminal 或则在Project下打开命令行，输入一下（可能还需要下载一遍Gradle）：

gradlew install

把项目上传到Bintray

把项目上传到Bintray，需要plugin的支持，在project目录下build.gradle文件的dependencies中添加（上面已添加过）：

classpath'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.5'

接下来执行如下命令行，完成上传：

gradlew bintrayUpload

这里我们一般会在进度97%或者98%卡住一会儿，ps：需要翻墙，出去抽根烟或者倒杯咖啡。上传成功后，我们打开bintray上仓库的界面就可以看到我们的项目CithubPro_for_jcenter。

仓库界面

到这一步已经接近尾声了，但是我们的项目还没有发布到Jcenter，只是在你自己的仓库中。别人如果想要使用你的开源项目，需要在project目录下添加如下代码：

allprojects {
    repositories {
        jcenter()
        maven { url'https://dl.bintray.com/huang3eng/maven/'}
    }
}

然后在相应module目录下的build.gradle中添加：

compile 'com.x1aomeng.githubpro:app:1.0.2'

虽然这样已经可以使用，但是还是有诸多不便的，如果有使用十个不同人写的开源项目，那么不是要先添加十个别人maven仓库的地址。Android Studio现在默认已经关联到Jcenter这个远程仓库，所以我们最好还是发布到Jcenter上。打开你的项目，点击Add to Jcenter，什么也不需要填，直接Send就好了。接下来需要通过管理员的审核都行了（我这边审核用了四个多小时），一般你的项目没有什么中文或者全英语注释都可以通过（终于知道为啥那些国内开源项目也很少会有中文注释）。

审核完成后，你会收到一份邮件让你确认，审核成功之后，你会发现项目中Linked to会多了一个Jcenter，这说明你的项目已经成功发不到Jcenter上了。我只能告诉你，你成功了与世界接轨的第一步。

总结

每个人的开发环境是不一样的，使用的版本也可能是不一样的。由于种种的不同，可能照着我的步骤，你会出现报错。网上将开源项目发布到Jcenter的文章也不少，使用的方式也可能不同。我这边文章主要把我自己踩过的一些坑记录下来，希望对你们哪怕只有一点点的帮助。第一次写简书，感觉又把整个过程梳理了一遍。如果有不对的地方或者更好的方法，请告诉我。

作者：奥斯特洛夫斯基c

链接：https://www.jianshu.com/p/f66972f0607a

來源：简书

简书著作权归作者所有，任何形式的转载都请联系作者获得授权并注明出处。