本文在CSDN同步更新:https://blog.csdn.net/weixin_42516118/article/details/81297490
发布项目到jcenter可以通过两个插件,一种是gradle-bintray-plugin,另外一种是bintray-release,各有优劣,大家按照个人喜好使用, 本文主要介绍gradle-bintray-plugin。
一、注册个人账户
1、首先登陆https://bintray.com/,请注意,还没有开始,第一个大坑就已经来袭,请不要选择首页的绿色按钮,这是面向企业版,试用30后要收费的,而且也会有一些未知的问题,我们选择红色椭圆圈里面的source account进入。
2、可以使用github google等网站账号授权登录,本文使用的直接注册,注意不要使用国内的一些邮箱(qq,新浪,163等都不好使),以免到时候验证邮箱或者密码比较麻烦。
3、注册登录后的界面如下,点击右上角的Edit Profile进入个人页面。
4、获取APIKey,保存,到时候上传要用到。
二、用Android Studio建立一个简单的插件
1、新建一个项目TestPlugin(名字随意),再新建一个module(library),类型选择Android Library
2、将src/main下的目录全部删除,创建一个新的目录groovy,接着根据module的包名创建目录,比如我的module包名是com.plugin.gradle.library,那么就按照这个目录创建。之后在该目录下创建一个以groovy后缀名的文件TestPlugin.groovy,作用是打印出一行字,目的是检验插件是否能运行。大家直接copy就好,因为代码没有自动提示,需要手写,项目结构和代码如下
3、在main目录下创建resources目录,在这个目录下创建META-INF/gradle-plugins, 在目录里面我们再创建名为library.properties的文件,文件名library就是以后给别人引用的插件名。在该文件添加代码:
implementation-class = com.plugin.gradle.library.TestPlugin
三、配置gradle(重要)
1、先配置好主项目的build.gradle,这里需要引入两个依赖
为了让gradle更明显的区分,这里将项目的结构切换成Android的结构,可以在build.gradle后面灰色字体明显看到该项目有三个gradle,分别是Project:TestPlugin、module:app、module:library。我们现在用的是Project级别的gradle,配置好gradle顺便同步一下项目,AS自动帮我们下载依赖。
2、配置module:library里面的gradle,因为我们最终上传的是这个插件,所以重要的信息都包含在里面。
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
apply plugin: 'com.android.library'
android {
compileSdkVersion 23
buildToolsVersion "23.0.3"
defaultConfig {
minSdkVersion 19
targetSdkVersion 23
versionCode 1
versionName "1.0"
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
}
version = "0.0.1" //版本
def siteUrl = 'https://github.com/' // 项目主页
def gitUrl = 'https://github.com/' // git
group = "com.plugin.gradle"
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
}
install {
repositories.mavenInstaller {
// This generates POM.xml with proper parameters
pom {
project {
packaging 'aar'
name 'Android Library'
url siteUrl
//用apache2.0
licenses {
license {
name 'The Apache Software License, Version 2.0'
url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
}
}
//开发者基本信息
developers {
developer {
id 'pao fan'
name 'pao fan'
email '[email protected]'
}
}
scm {
connection gitUrl
developerConnection gitUrl
url siteUrl
}
}
}
}
}
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
/**
* 用户名和key,这两个信息一般会保存在local.properties里面,只保留在本地,不上传到仓库。
*/
user = properties.getProperty("bintrayUser")
key = properties.getProperty("bintrayApiKey")
println user
println key
configurations = ['archives']
pkg {
repo = "Maven" //跟上面创建的Maven仓库名字保持一致
name = "library" //发布到JCenter上的项目名字
websiteUrl = siteUrl
vcsUrl = gitUrl
licenses = ["Apache-2.0"]
publish = true
}
}
用户名和key存放如下,只是示例,大家请使用自己的账号信息 - -,这个文件记得.gitignore忽略不要上传。
四、上传插件
我们到底怎么上传这个插件呢,其实有两种方法,但本质上是一样的,可以使用工具,或者使用命令行。
1、使用gradle快捷工具
第一步,在右上角侧边栏找到Gradle,点击打开,在目录中展开library-other,双击install运行
第二步如图展开publishing,双击bintrayUpload运行。
打开Messages,当你看到BUILD SUCCESSFUL,就代表已经上传成功啦。
Information:Gradle tasks [bintrayUpload]
Information:BUILD SUCCESSFUL
Information:Total time: 20.01 secs
Information:0 errors
Information:0 warnings
Information:See complete output in console
2、使用命令行
也可以在AS自带的Terminal使用命令行,先要配置gradle的环境变量才能使用,像JDK一样。
gradew javadocJar
gradew sourcesJar
gradew install
gradew bintrayUpload
五、Add to JCenter
1、上传成功后,在个人首页可以看到如下信息,Maven就是已经上传的仓库。
2、点击Maven进入,这里有两个包,library就是刚刚上传的插件。
3、但现在还不能使用,需要点击library进入,选择红框Add to JCenter,等待后台审核便能使用。
简单粗暴,直接send就可以,接下来等待半天或者一天就可以审核通过。
4、使用方式
compile 'com.plugin.gradle:library:0.0.1'
六、总结
主要的步骤就是:
1.创建账号
2.编写插件(或者随意写一个module)
3.编写module的build.gradle
4.上传,等待审核
总的来说不难,需要大家去实践,那么,本文到此结束。