上一节,我们以实例的方式,讲解了android studio依赖库的开发过程,但是,似乎还没有完成。
是的,还缺少插件的生成、发布和使用。
下面我们便接着上一节,继续讲解依赖库的生成、发布和使用
依赖库的发布,是在build.gradle构建脚本中处理的。
在讲解构建脚本之前,我们先说下JCenter库的申请等前期准备工作。
1、注册账号
在https://bintray.com/上注册一个账号。
2、获取API Key
注册后,在https://bintray.com/profile/edit页面的左边菜单的最下面有API Key,
复制明文API key,后面会用到。
3、定义相关网站
有单独的官方网站那是最好的,没用的话就用git网址就可以了。
def siteUrl = ‘https://github.com/xxxxxx‘// project homepage
def gitUrl = ‘https://github.com/xxxxxx.git‘// project git
4、定义Group(上一节已经定义,此处只是了解原因)
举个例子,当我们引用recylerview的时候是这样的:
compile'com.android.support:recyclerview-v7:21.0.2'
引号内字符串以冒号分割为三部分,第一部分就是group,第二部分是name, 第三部分是version。
其中group和version分别对应上一节最后在build.gradle中添加的信息,而name对应我们的模块名,由于上一节中模块名为app,所以name=app。
合起来,上一节开发的依赖库的引用就应该是这样:
compile 'com.myutils:app:0.1'
接着,便是上传依赖库到Jcenter库。需要知道的是上传到Jcenter库至少需要四个文件,除了打包的aar之外,还需要pom和javadoc,source,否则是通不过Jcenter库审核的。不过不用紧张,这些我们都可以用脚本生成。
添加创建javadocjar、sourcejar、pom和aar(也可以是jar)的脚本任务。
5、打包javadocjar和sourcejar
这两个也是上传到jcenter必须要的。
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
}
6、定义pom并打包aar
install {
repositories.mavenInstaller {
// This generates POM.xml with proper parameters
pom {
project {
packaging 'aar'
name 'Utils For Android' //project title
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 'test' //your user id
name 'csky' // your user name
email 'csky@qq.com' // your email
}
}
scm {
connection gitUrl
developerConnection gitUrl
url siteUrl
}
}
}
}
}
7、配置个人信息
上传到jcenter的网站BinTray,需要用户验证,需要2个值。
// 示例值, 仅供参考
bintray.user=openproject // your bintray user name
bintray.apikey=c5434272d5xxxxxxxx225564155753 // your bintray api key
第二个API Key就是你在上面记录的API Key。
因为这个属于个人隐私,一般不能传到网上去,所以需要在记录到工程下的local.properties中(利用gitignore忽略这个文件到git),然后脚本再从local.properties中读取这两个值。
Properties properties = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
user = properties.getProperty("bintray.user")
key = properties.getProperty("bintray.apikey")
configurations = ['archives']
pkg {
repo = "maven"
name = "utils" //project name in jcenter
websiteUrl = siteUrl
vcsUrl = gitUrl
licenses = ["Apache-2.0"]
publish = true
}
}
到目前为止,完整的build.gradle脚本如下:
项目根目录下build.gradle脚本内容为:
buildscript {
repositories {
jcenter()
}
dependencies {
classpath 'com.android.tools.build:gradle:1.3.0'
classpath 'com.jfrog.bintray.gradle:gradle-bintray-plugin:1.0'
classpath 'com.github.dcendents:android-maven-gradle-plugin:1.3'
}
}
allprojects {
repositories {
jcenter()
}
}
app目录下build.gradle脚本内容为:
apply plugin: 'com.android.library'
apply plugin: 'com.github.dcendents.android-maven'
apply plugin: 'com.jfrog.bintray'
group = "com.myutils"
version = "0.1"
android {
compileSdkVersion 23
buildToolsVersion "23.0.3"
defaultConfig {
applicationId "example.com.myutils"
minSdkVersion 8
targetSdkVersion 23
versionCode 1
versionName "1.0"
ndk {
moduleName "hello-jni"
ldLibs "log", "z", "m"
abiFilters "armeabi", "armeabi-v7a", "x86"
}
}
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:23.1.1'
}
def siteUrl = 'https://github.com/xxxxxx' // project homepage
def gitUrl = 'https://github.com/xxxxxx.git'
install {
repositories.mavenInstaller {
// This generates POM.xml with proper parameters
pom {
project {
packaging 'aar'
name 'Utils For Android' // project title
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 'test' // your user id
name 'csky' // your user name
email 'csky@qq.com' // your email
}
}
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 = new Properties()
properties.load(project.rootProject.file('local.properties').newDataInputStream())
bintray {
user = properties.getProperty("bintray.user")
key = properties.getProperty("bintray.apikey")
configurations = ['archives']
pkg {
repo = "maven"
name = "utils" //project name in jcenter
websiteUrl = siteUrl
vcsUrl = gitUrl
licenses = ["Apache-2.0"]
publish = true
}
}
8、上传到Jcenter仓库
根据上面的build.gradle,会产生几个特别的gradle任务:
javadocJar
sourcesJar
install
bintrayUpload
通过gradew执行这些任务即可。
gradew javadocJar
gradew sourcesJar
gradew install
gradew bintrayUpload
或者通过Android Studio的最右边栏的Gradle窗口分别可视化操作,点击执行。
9、请求审核
当bintrayUpload成功之后,
在我的主页https://bintray.com/openproject/右下部分Latest Activity块,会看到你提交了一个项目,
从这个Latest Activity列表中点击你的项目,
进入详情页https://bintray.com/openproject/maven/lesscode-core/view,
找到Maven Central标签,
鼠标放上去它会提示你去提交审核,点击进入后,随便写什么都可以了。
只要上面没问题,一般审核很快,几个小时就差不多了。
库的默认地址:http://dl.bintray.com/申请的名字/maven
这次审核通过了,后面升级就不用再审核了。
10、依赖库的引用(使用)
在需要引用依赖库的android studio工程中的build.gradle中添加引用:
compile 'com.myutils:app:latest.release' //最新版,自动更新
或者
compile 'com.myutils:app:0.2' //指定版本
剩下的便是在自己代码中尽情的享受依赖库带来的好处吧!
android studio 依赖库的开发到目前已经讲解完成类,下一篇,咱们就聊聊android studio 插件的开发。