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

235 阅读4分钟
原文链接: www.jianshu.com

今天突然心血来潮,想折腾一下,让自己的库能够被远程依赖。在网上找了很多教程,终于折腾出来了。话不多少。开始教程:


一.注册bintray账号

bintray的官网:bintray.com

个人注册地址: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.错误解决:

code.google.com/p/android/i…

上面这个链接需要翻墙才可查看。但是终究是版本号不匹配,多尝试更换几次版本即可。

如: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中进行如下配置

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"

// 定义两个链接,下面会用到。

// 项目主页。

defsiteUrl ='https://github.com/JackiePenghe/BaseLibrary'

// Git仓库的url。(此处一定要是ssh链接)

defgitUrl ='git@github.com:JackiePenghe/BaseLibrary.git'

// 唯一包名,比如compile 'com.yanzhenjie:andserver:1.0.1'中的com.yanzhenjie就是这里配置的。唯一

group="com.jackiepenghe" 

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'jackiepenghe'// 开发者的id。

name'jackiepenghe'// 开发者名字。

email'p15583101939@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'

authortrue

versiontrue

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 {

archivesjavadocJar

archivessourcesJar

}

// 这里是读取Bintray相关的信息,我们上传项目到github上的时候会把gradle文件传上去,所以不要把帐号密码的信息直接写在这里,写在local.properties中,这里动态读取。

Properties properties =newProperties()

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。而是项目中,module的名字。详细请看下方图示

name ="baselibrary"

userOrg ='jackiepenghe' // 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才可以。

当成功执行完上述命令之后,登陆bintray.com/,你会发现maven中多了一个项目了。


进入maven。可以看到已经成功了。


进入项目(不翻墙进入会很慢,多等等就好)并将项目分享到jcenter。到这里本教程就基本完成了。


最后别忘记提交


提交之后等待审核之后就能依赖使用了


本次教程到此结束。第一次写文章,有不完善的地方请提出您宝贵的意见