安卓 将自己的库让别人远程依赖

今天突然心血来潮,想折腾一下,让自己的库能够被远程依赖。在网上找了很多教程,以及很多朋友的帮忙(尤其是 小别墅),终于折腾出来了。话不多说。开始教程:


一.注册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


最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,098评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,213评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,960评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,519评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,512评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,533评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,914评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,574评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,804评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,563评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,644评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,350评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,933评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,908评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,146评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,847评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,361评论 2 342

推荐阅读更多精彩内容