前言
因为各种各样的原因,有时需要将项目中指定的文件或者文件夹打包成jar,而我们一般将这种需求放在Gradle中实现。
对于Gradle我们并不陌生,我们知道他是Android Stuido的一个自动化构建工具,它是使用Groovy作为主要脚本语言实现的,当你对一些语句不理解时,可以查阅Groovy的相关资料。在下面的实现中,一共分为三步。
正文
第一步:定义一个Task,用于删除指定位置的jar包
task clearJar() {
delete 'build/_exports/hpauth-exports-1.0.0.jar'
}
这里是在Gradle中声明一个task用于删除指定位置的文件,其中build/_exports/hpauth-exports.jar即为你要删除的文件的路径,clearJar为自定义,可随意取名。
第二步:定义一个Task,用于生成一个jar包(同时兼顾java与kotlin)
task makeJar(type: Jar) {
baseName = "hpauth-exports"
// appendix = "v"
version = "1.0.0"
// classifier = "release"
// 后缀名
extension = "jar"
// 最终的 jar 包名,如果没设置,默认为 [baseName]-[appendix]-[version]-[classifier].[extension]
// archiveName = "hpauth-exports.jar"
// java 编译后的 class文件
from('build/intermediates/classes/debug/')
// kotlin 编译后的 class文件
from('build/tmp/kotlin-classes/debug/')
// 指定需要被打包成 jar 的文件夹
include('com/homeprint/module/auth/_exports/**')
// jar 的输出路径,默认输出在 build/libs 目录下
destinationDir = file('build/_exports')
}
jar包存放的为class文件,所以想要生成jar包,我们需要找到class文件的所在位置,
- 其中
build/intermediates/classes/debug/为java文件编译后所在的位置,(注意:在新版的Android Studio版本中,intermediates中没有classes文件夹,多出了个javac文件夹,在javac/debug/compileDebugJavaWithJavac/classes可以找到java编译成的class文件 ) -
build/tmp/kotlin-classes/debug/是kotlin文件编译成class文件的所存放的位置
如果只用了java或者kotlin一种语言,可以任意去掉没有使用的from(xxxx)
第三步:设置Task依赖,优化makeJar
为了保证每次的生成的jar包是最新的,我们最好先删除旧版的jar包,并且重新build一下项目,获取最新的编译文件,在生成新的jar包(当然,删除和build我们也可以手动进行,但是能偷懒,为啥还要硬干呢)
/**
* 设置 task 依赖
* 执行 makeJar 时,会先执行 clearJar,再执行build,最后执行 makeJar,保证获取最新的编译文件
*/
makeJar.dependsOn(clearJar, build)
使用方法
- 以上代码写完后,点击
Gradle右上角的Syc now同步一下 - 点开右边的
Gradle扩展,点开项目Gradle中的Tasks中的other
项目的gradle - 可以看到我们之前声明的task出现在了
other中
图一:
图二:
- 双击
makeJar生成jar包
完整代码
以下是完整代码,代码的层级与Gradle中的android{}同级
/**
* 删除旧版本的 jar 包
*/
task clearJar() {
delete 'build/_exports/hpauth-exports-1.0.0.jar'
}
/**
* 创建 jar 包
*/
task makeJar(type: Jar) {
baseName = "hpauth-exports"
// appendix = "v"
version = "1.0.0"
// classifier = "release"
// 后缀名
extension = "jar"
// 最终的 jar 包名,如果没设置,默认为 [baseName]-[appendix]-[version]-[classifier].[extension]
// archiveName = "hpauth-exports.jar"
// java 编译后的 class 文件
from('build/intermediates/classes/debug/')
// kotlin 编译后的 class 文件
from('build/tmp/kotlin-classes/debug/')
// 指定需要被打包成 jar 的文件夹
include('com/homeprint/module/auth/_exports/**')
// jar 的输出路径,默认输出在 build/libs 目录下
destinationDir = file('build/_exports')
}
/**
* 设置 task 依赖
* 执行 makeJar 时,会先执行 clearJar,再执行build,最后执行 makeJar,保证获取最新的编译文件
*/
makeJar.dependsOn(clearJar, build)
