前言
因为各种各样的原因,有时需要将项目中指定的文件或者文件夹打包成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
- 可以看到我们之前声明的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)