Android自动化构建之使用Gradle下载与处理文件
一般情况下,我们的项目构建并不需要再去导入其他文件。但如果自己项目正在维护一个自己的library module,而这个library内又维护着大量会经常更新的SO库,SO库文件很小倒无所谓,但是SO库又多又大时,直接将SO库放入Git中,一个版本更新下来,Git库估计就要炸掉了。而此时,我们利用Gradle的task来执行下载与导入即可解决这一尴尬。
Gradle下载插件
Gradle原生并不支持文件下载,使用Gradle命令执行文件下载则需要安装Gradle插件:Gradle Download Task。
插件的安装必须在项目根目录下的build.gradle文件中配置(版本最好参考官方说明):
插件的安装必须在项目根目录下的build.gradle文件中配置(版本最好参考官方说明):
plugins {
id "de.undercouch.download" version "3.2.0"
}
配置文件删除task
既然涉及到文件更新,那么针对项目情况,显然需要删除旧的文件,示例:
task cleanFile(type: Delete) {
// 清除SO库文件
delete 'library/src/main/jniLibs'
// 清除文件
delete new File('library/src/main/jniLibs/my.so')
}
拆分Gradle文件
在根项目或者Module的build.gradle中做配置,会导致Gradle又臭又长又不便于阅读,一修改还需要不停刷新,因此个人推荐,将比较集中的功能,提取到另一个gradle文件,apply到build.gradle中;再将需要经常修改,而跟处理逻辑毫无关联的字段提取到另一个properties文件之中,便于修改与配置。
示例:
build.gradle文件:
示例:
build.gradle文件:
apply from: "update.gradle"
update.gradle文件:
// 读取update.properties文件
Properties psUpdate = new Properties()
psUpdate.load(project.file("update.properties").newDataInputStream())
def filename = psCore.getProperty("filename")
def filepath = psCore.getProperty("filepath")
task cleanFile(type: Delete) {
delete new File(filepath, filename)
}
update.properties文件
# 文件名
filename=my.so
# 文件路径
filepath=library\\src\\main\\jniLibs
注意: update.properties文件中的路径是双反斜杠
配置下载
参照官方指出的方案即可,并无难处。比较复杂的下载方案参考官方文档,以下是取自官方的简单示例:
import de.undercouch.gradle.tasks.download.Download
task downloadFile(type: Download) {
src 'http://www.example.com/index.html'
dest buildDir
}
在Android Studio上使用此方案时,存在一个大坑。如果使用该方案,那么必须写在build.gradle文件之中,而不能写在拆分出来用于apply的gradle文件之中,如果写在其中,会在import处报错,可能是第三方文件导入的不能再次导包吧。于是在我们的方案中就只能选择第二方案:
task downloadFile << {
download {
src 'http://www.example.com/index.html'
dest buildDir
}
}
注意: 在使用插件以前,必须先apply:apply plugin: 'de.undercouch.download'
处理下载文件
我们下载的文件,多半是压缩包,如果文件供给者可以支持zip文件,则我们可以直接使用该插件进行下载解压:
task downloadZipFile(type: Download) {
src 'https://github.com/michel-kraemer/gradle-download-task/archive/1.0.zip'
dest new File(buildDir, '1.0.zip')
}
task downloadAndUnzipFile(dependsOn: downloadZipFile, type: Copy) {
from zipTree(downloadZipFile.dest)
into buildDir
}
注意: 使用dependsOn,即便你的主task写在build.gradle文件中,而依赖的task写在apply的gradle文 件之中也是可行的。但是依赖的task必须在主task之前,也就是你得在你的主task之前先apply含有依赖task的gradle文件。
Gradle原生对压缩包的支持较少,因此很多情况下我们的下载文件是其他格式的文件,比如开源的7z。为了满足这一情况,我们需要使用7z command来处理这些文件。
执行CMD来解压更多格式的压缩包
// 解压下载文件
task unzipDownloadFile(dependsOn: downloadFile, type: Exec) {
commandLine 'cmd', '/c', '7za x "%cd%\\download.7z" -y -aoa -o"%cd%\\temp"'
}
提示: 更多详细的7z命令可参照此链接https://sevenzip.osdn.jp/chm/cmdline/commands/index.htm。需要注意的是,解压文件的task需要依赖下载文件的task。
当你需要解压多个文件的时候,或者执行多条语句的时候:
task unzipDownloadFile(dependsOn: downloadFile, type: Exec) {
commandLine 'cmd', '/c', '7za x "%cd%\\download.7z" -y -aoa -o"%cd%\\temp"'
doLast {
exec {
commandLine 'cmd', '/c', 'echo do more things.'
}
exec {
commandLine 'cmd', '/c', 'echo do more things.'
}
exec {
commandLine 'cmd', '/c', 'echo do more things.'
}
...
}
}
有时我们需要考虑先判断文件是否存在,再去解压文件,你可以考虑使用Gradle来new一个File来判断其是否存在,但这存在一个大问题,在task中判断文件是否存在,这是编译时进行的,而不是运行时进行的。所以这么判断是错误的。因为你文件是从网络或者其他途径临时获取的。因此我们可以通过执行CMD命令来判断文件是否存在:
task unzipDownloadFile(dependsOn: downloadFile, type: Exec) {
commandLine 'cmd', '/c', 'if exist "%cd%\\download.7z" (7za x "%cd%\\temp\\download.7z" -y -aoa -o"-o"%cd%\\temp") else echo There is no interface file here.'
}
完整的示例
build.gradle文件
plugins {
id "de.undercouch.download" version "3.2.0"
}
task clean(type: Delete) {
delete rootProject.buildDir
}
task cleanSOFile(type: Delete) {
delete 'library/src/main/jniLibs'
}
apply from: "update.gradle"
// 更新SO库
task updateSOFile(dependsOn: [cleanSOFile, update]) {
}
update.gradle文件
apply plugin: 'de.undercouch.download'
def soPath = 'library\\src\\main\\jniLibs'
// 读取SO库配置
Properties psCore = new Properties()
psCore.load(project.file("update.properties").newDataInputStream())
def filename = psCore.getProperty("filename")
def soFile = new File(filename)
// 下载SO库压缩文件
task downloadFile << {
download {
src psCore.getProperty("url")
dest soFile
}
}
// 解压下载文件
task unzipDownloadFile(dependsOn: downloadFile, type: Exec) {
commandLine 'cmd', '/c', '7za x "%cd%\\' + filename + '" -y -aoa -o"%cd%\\temp"'
def zipFile
doLast {
// 解压arm64-v8a
exec {
zipFile = psCore.getProperty("arm64-v8a")
if (zipFile != null && zipFile.length() > 0) {
commandLine 'cmd', '/c', 'if exist "%cd%\\temp' + zipFile + '" (7za e "%cd%\\temp' +
zipFile + '" -y -aoa -o"%cd%\\' + soPath +
'\\arm64-v8a") else echo There is no arm64-v8a file here.'
} else {
commandLine 'cmd', '/c', 'echo There is no arm64-v8a path here.'
}
}
// 解压armeabi
exec {
zipFile = psCore.getProperty("armeabi")
if (zipFile != null && zipFile.length() > 0) {
commandLine 'cmd', '/c', 'if exist "%cd%\\temp' + zipFile + '" (7za e "%cd%\\temp' +
zipFile + '" -y -aoa -o"%cd%\\' + soPath +
'\\armeabi") else echo There is no armeabi file here.'
} else {
commandLine 'cmd', '/c', 'echo There is no armeabi path here.'
}
}
// 解压armeabi-v7a
exec {
zipFile = psCore.getProperty("armeabi-v7a")
if (zipFile != null && zipFile.length() > 0) {
commandLine 'cmd', '/c', 'if exist "%cd%\\temp' + zipFile + '" (7za e "%cd%\\temp' +
zipFile + '" -y -aoa -o"%cd%\\' + soPath +
'\\armeabi-v7a") else echo There is no armeabi-v7a file here.'
} else {
commandLine 'cmd', '/c', 'echo There is no armeabi-v7a path here.'
}
}
// 解压mips
exec {
zipFile = psCore.getProperty("mips")
if (zipFile != null && zipFile.length() > 0) {
commandLine 'cmd', '/c', 'if exist "%cd%\\temp' + zipFile + '" (7za e "%cd%\\temp' +
zipFile + '" -y -aoa -o"%cd%\\' + soPath +
'\\mips") else echo There is no mips file here.'
} else {
commandLine 'cmd', '/c', 'echo There is no mips path here.'
}
}
// 解压mips64
exec {
zipFile = psCore.getProperty("mips64")
if (zipFile != null && zipFile.length() > 0) {
commandLine 'cmd', '/c', 'if exist "%cd%\\temp' + zipFile + '" (7za e "%cd%\\temp' +
zipFile + '" -y -aoa -o"%cd%\\' + soPath +
'\\mips64") else echo There is no mips64 file here.'
} else {
commandLine 'cmd', '/c', 'echo There is no mips64 path here.'
}
}
// 解压x86
exec {
zipFile = psCore.getProperty("x86")
if (zipFile != null && zipFile.length() > 0) {
commandLine 'cmd', '/c', 'if exist "%cd%\\temp' + zipFile + '" (7za e "%cd%\\temp' +
zipFile + '" -y -aoa -o"%cd%\\' + soPath +
'\\x86") else echo There is no x86 file here.'
} else {
commandLine 'cmd', '/c', 'echo There is no x86 path here.'
}
}
// 解压x86_64
exec {
zipFile = psCore.getProperty("x86_64")
if (zipFile != null && zipFile.length() > 0) {
commandLine 'cmd', '/c', 'if exist "%cd%\\temp' + zipFile + '" (7za e "%cd%\\temp' +
zipFile + '" -y -aoa -o"%cd%\\' + soPath +
'\\x86_64") else echo There is no x86_64 file here.'
} else {
commandLine 'cmd', '/c', 'echo There is no x86_64 path here.'
}
}
}
}
// 完成并删除临时文件及文件夹
task update(dependsOn: unzipDownloadFile, type: Delete) {
delete soFile
delete 'temp'
}
update.properties文件
## 此文件用于配置SO库下载版本
#Mon Mar 30 01:35:23 CST 2017
# 固定地址
url=http://www.example.com/so.7z
# 文件名
filename=so.7z
# 不同类型CPU对应的SO文件压缩包文件名称及路径(在解压目录中的路径,不包含则为空)
# arm64-v8a
arm64-v8a=\\ARM_V8A\\so.7z
# armeabi
armeabi=\\ARM\\so.7z
# armeabi-v7a
armeabi-v7a=\\ARM_V7A\\so.7z
# mips
mips=\\MIPS\\so.7z
# mips64
mips64=\\MIPS64\\so.7z
# x86
x86=\\X86\\so.7z
# x86_64
x86_64=\\X86_64\\so.7z
评论
发表评论