今天突然心血来潮,想折腾一下,让自己的库能够被远程依赖。在网上找了很多教程,以及很多朋友的帮忙(尤其是 小别墅),终于折腾出来了。话不多说。开始教程:
一.注册bintray账号
bintray的官网:https://bintray.com
个人注册地址:https://bintray.com/signup/oss
也可以直接用github账户登录。我就是这样的。但是这样有一个要求:你的github绑定了邮箱,而且是在国外可用的(Gmail,outlook等)。
二.新建maven仓库
不多说。看图说话
创建完成之后就会多一个maven
三.项目配置。
1.根目录配置
把上传好的,在GitHub上公开的项目导入下来(本地已有就不用再次导入了)
在项目的根目录下的build.gradle如下配置
dependencies{
//注意:此处版本如果不是2.3.3,下方的版本有可能无效或者报错。更换此处版本或者下方的版本即可。报错及解决方案在下方
classpath'com.android.tools.build:gradle:2.3.3'
// 添加下面两行代码即可。
classpath'com.github.dcendents:android-maven-gradle-plugin:1.5'
classpath'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.7.3'
// NOTE: Do not place your application dependencies here; they belong
// in the individual module build.gradle files
}
报错:
No service of type Factory available in ProjectScopeServices.错误解决:
https://code.google.com/p/android/issues/detail?id=219692
上面这个链接需要翻墙才可查看。但是终究是版本号不匹配,多尝试更换几次版本即可。
如:classpath 'com.android.tools.build:gradle:2.1.3' ,这时就要使用
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.4.1',而不是
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.5'
修改完成之后如图:
2.依赖配置
在library的module下(你想要让别人远程依赖的module)build.gradle中进行如下配置
// 添加下面两行代码即可。
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
defaultConfig {
// applicationId "xxx.xxxx.xxx" // 如果有这一行要删除,library没有applicationId
minSdkVersion 8
targetSdkVersion 23
versionCode 1
versionName '1.0.1'
}
然后在最下方
dependencies {
compile fileTree(include: ['*.jar'],dir:'libs')
compile 'com.android.support:appcompat-v7:26.0.0-alpha1'
compile 'com.android.support:appcompat-v7:26.0.0-alpha1'
compile 'com.android.support:design:26.0.0-alpha1'
}
没错,就是在上面这些代码的更下方添加如下代码:
// 项目引用的版本号,比如compile 'com.yanzhenjie:andserver:1.0.1'中的1.0.1就是这里配置的。
version="0.1"
// 定义两个链接,下面会用到。
// 项目主页。
def siteUrl ='https://github.com/xxxxx/项目地址'
// Git仓库的url。(此处可以是ssh链接,也可以是http链接)
def gitUrl ='git@github.com:xxxx/项目地址.git'
// 唯一包名,比如compile 'com.yanzhenjie:andserver:1.0.1'中的com.yanzhenjie就是这里配置的。唯一
group="com.xxxx"
install {
repositories.mavenInstaller{
// 生成pom.xml和参数
pom {
project{
packaging'aar'
// 项目描述,这里需要修改。
name 'BaseLibrary For Android'// 可选,项目名称。
description 'The Android build the framework of the base library.'// 可选,项目描述。
url siteUrl// 项目主页,这里是引用上面定义好。
// 软件开源协议,现在一般都是Apache License2.0吧,复制我的,这里不需要修改。
licenses {
license {
name 'The Apache Software License, Version 2.0'
url 'http://www.apache.org/licenses/LICENSE-2.0.txt'
}
}
//填写开发者基本信息,这里需要修改。
developers {
developer {
id 'xxxx'// 开发者的id。
name 'xxxx'// 开发者名字。
email 'xxxxx@gmail.com'// 开发者邮箱。
}
}
// SCM,复制我的,这里不需要修改。
scm {
connection gitUrl// Git仓库地址。
developerConnection gitUrl// Git仓库地址。
url siteUrl// 项目主页。
}
}
}
}
}
// 生成jar包的task,不需要修改。
task sourcesJar(type: Jar) {
from android.sourceSets.main.java.srcDirs
classifier='sources'
}
// 生成jarDoc的task,不需要修改。
task javadoc(type: Javadoc) {
options { //如果项目包含中文,最好配置上options,如果没有中文,options这一整项可不要
encoding "UTF-8"
charSet 'UTF-8'
author true
version true
links "http://docs.oracle.com/javase/7/docs/api"
}
source= android.sourceSets.main.java.srcDirs
classpath+=project.files(android.getBootClasspath().join(File.pathSeparator))
// destinationDir = file("../javadoc/")
// 忽略注释语法错误,如果用jdk1.8你的注释写的不规范就编译不过。(如果电脑上有JDK1.9,配置之后还报错,一定要卸载JDK1.9,切记)
failOnError false
}
// 生成javaDoc的jar,不需要修改。
task javadocJar(type: Jar,dependsOn: javadoc) {
classifier='javadoc'
from javadoc.destinationDir
}
artifacts {
archives javadocJar
archives sourcesJar
}
// 这里是读取Bintray相关的信息,我们上传项目到github上的时候会把gradle文件传上去,所以不要把帐号密码的信息直接写在这里,写在local.properties中,这里动态读取。
Properties properties =new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
user = properties.getProperty("bintray.user")// Bintray的用户名。
key = properties.getProperty("bintray.apikey")// Bintray刚才保存的ApiKey。
configurations = ['archives']
pkg {
repo ="maven"// 上传到maven库。
// 发布到Bintray上的项目名字,这里的名字不是compile 'com.yanzhenjie:andserver:1.0.1'中的andserver。而是你在bintray网站上,你这个项目的名字。
name ="项目名字"
userOrg ='xxxx' // Bintray的用户名。
websiteUrl = siteUrl
vcsUrl = gitUrl
licenses = ["Apache-2.0"]
publish =true// 是否是公开项目。
}
}
下面是修改之后的图:
可以明确看到,配置中引用了一个文件(local.properties)。最后还有还有一步:打开local.properties文件(项目根目录下)
复制这两行进去:
bintray.user=YOUR_BINTRAY_USERNAME
bintray.apikey=YOUR_BINTRAY_API_KEY
把上方的YOUR_BINTRAY_USERNAME和YOUR_BINTRAY_API_KEY替换成你自己的。
获取方式如下图:
三.上传项目,用以共享(远程依赖)
打开android studio的命令行:
如图:
输入命令:gradlew install
等待编译完成。BUILD SUCCESSFUL
再输入命令:gradlew bintrayUpload
等待编译完成。BUILD SUCCESSFUL
或者不执行上面这两个命令,直接合成执行下面这个命令就可以了:
gradlew clean build bintrayUpload -PbintrayUser=BINTRAY_USERNAME -PbintrayKey=BINTRAY_KEY -PdryRun=false
记住要把user和key换成自己的,同样要显示BUILD SUCCESSFUL才可以。
当成功执行完上述命令之后,登陆https://bintray.com/,你会发现maven中多了一个项目了。
进入maven。可以看到已经成功了。
进入项目(不翻墙进入会很慢,多等等就好)并将项目分享到jcenter。到这里本教程就基本完成了。
最后别忘记提交
提交之后等待审核之后就能依赖使用了。我等了一天才能用。
本次教程到此结束。第一次写文章,有不完善的地方请提出您宝贵的意见
追加:
我以后想增加、迭代怎么办?
这个非常简单,当你的Library代码更改后,先上传同步,提交到github之后,只需要更改一下上面的配置里面的version
输入命令:gradlew install
等待编译完成。BUILD SUCCESSFUL
再运行
gradlew clean build bintrayUpload -PdryRun=false,就可以更新版本号了。
如果代码运行失败,就像之前上传一样,将代码分成两次执行。
输入命令:gradlew install
等待编译完成。BUILD SUCCESSFUL
再输入命令:gradlew bintrayUpload
等待编译完成。BUILD SUCCESSFUL
这样,整个过程就结束了。更新的代码可以立即使用(已经通过本人测试)
附:上方的baselibrary中包含的库及其常见使用 http://www.jianshu.com/p/a97d8c564d19