通过Gradle动态修改Manifest文件
1. Gradle
Gradle是开源的自动化构建工具,基于JVM,有良好的扩展性和性能,对IDE支持,支持编写自己设置任务,在Android领域,用于构建和编译应用的资源和源代码,而后将它们打包成可供您测试、部署、签订和分发的 APK,另外在插件化和热修复的领取中起重要的作用。
gradle构建有三个阶段
- 初始化
分析哪些module将参加构建,settings.gradle文件会被解析。 - 配置
解决module的build脚本,解决属性和task的依赖关系,build.gradle文件会被解析配置 - 执行
按照配置过程解决的任务依赖关系相继执行task
2. 通过Gradle动态修改Manifest文件
例如:在release包manifest中动态增加标签为meta-data的渠道号channel<meta-data android:name=“channel" android:value=“1001" />
思路
- 在项目配置结束的task中,找到生成Release的manifest的task
- 通过该task找到输出的manifest文件并读取文本内容
- 使用Groovy的Xml Api对manifest进行修改
- 修改后重新写,输出至原始目录
完整代码如下,代码解释见3.X
project.afterEvaluate { //3.1 android.applicationVariants.all { ApplicationVariant variant -> //3.2 String variantName = variant.name.capitalize() //3.3 def processManifestTask = project.tasks.getByName("process${variantName}Manifest") //3.4 processManifestTask.doLast { pmt -> //3.5 String manifestPath = "$pmt.manifestOutputDirectory/AndroidManifest.xml" //3.6 def manifest = file(manifestPath).getText() //3.7 if (project.hasProperty("channel")) { def channelNo = project.property("channel") def xml = new XmlParser().parseText(manifest) //3.8 xml.application[0].appendNode("meta-data", ['android:name': 'channel', 'android:value': channelNo]) def serialize = XmlUtil.serialize(xml) file(manifestPath).write(serialize) } } }}终端中运行: gradle clean aR -P channel=101
查看apk中的manifest文件发现渠道号已经动态的增加进去了
image.png
3.1 project
project和build.gralde逐个对应,在构建初始化期间,Gradle Project为每个参加构建的项目组装一个对象。
project.afterEvaluate(Closure closure)
参数是一个闭包,在项目配置后立即调用。project作为参数传递给闭包。
3.2 ApplicationVariant
Android的构建变体,可以了解为一个版本,例如debug,release等等,在项目配置结束后可以通过AppExtension.getApplicationVariants().all方法获取,或者者通过DefaultGroovyMethods.each()方法获取。
官方ApplicationVariant文档说明.png
由api可知,使用all可以解决后面增加进来的构建变体,使用each只能解决当前的,所以建议用all。
3.3 variant.name.capitalize()
通过查看源码发现capitalize()是org.codehaus.groovy.runtime下StringGroovyMethods的一个方法,查看Groovy Api:
image.png
将第一个字母变大写,便于后续字符串拼接获取manifest,variant.name= releasevariant.name.capitalize()= Release
3.4 project.tasks.getByName(String name)
T getByName(String name) throws UnknownTaskException;根据Api可知,通过task的名称获取该task
3.5 task.doLast
task是gradle的执行单元,gradle的构建是通过taks的执行来完成。
定义名为hello的task如下:
task hello { printf "hello\n"}hello.doLast { printf "doLast\n"}执行gradle clean
> Configure project :apphello执行gradle hello
> Configure project :apphello> Task :app:hellodoLast可以看到在执行少量配置任务时候hello任务也会一起执行,但是hello的doLast并没有执行,假如不需要在配置时候执行我们的自己设置的任务,可以使用doLast来完成。
3.6 manifestOutputDirectory
通过该task的manifest输出路径获取manifest文件
processManifestTask.doLast { pmt -> String manifestPath = "$pmt.manifestOutputDirectory/AndroidManifest.xml".......代码是个闭包,pmt是processManifestTask的自己设置简称,可以不定义,那么代码为
processManifestTask.doLast { -> String manifestPath = "$manifestOutputDirectory/AndroidManifest.xml".......3.7 file(manifestPath).getText()
public static String getText(File file) throws IOException { return IOGroovyMethods.getText(newReader(file)); }传入个file对象通过BufferedReader读取从而获取文本
3.8 操作XML
使用Groovy解析XML的最常用方法如下:
- groovy.util.XmlParser
- groovy.util.XmlSlurper
相同点
- 两者都是基于SAX它们都是低内存占用
- 两者都可以升级/转换XML
不同点
- 返回值
- XmlSlurper. parseText返回GPathResult
- XmlParser. parseText返回Node
- 使用场景
- 假如将现有文档转换成另一个文档,那么推荐用XmlSlurper
- 假如只有少许节点,也推荐用XmlSlurper,这样不用在内存中创立完整的结构
- 假如想同时升级和阅读,那么推荐用XmlParser
3.8.1 增加节点
用到的api:appendNode(XmlParser为例)
def xml = new XmlParser().parseText(manifest) xml.application[0].appendNode("meta-data", ['android:name': 'channel', 'android:value': channelNo])此时xml.application[0]是获取第一个application节点,尽管manifest只有一个application,也需要带上[0],例如获取application内的第一个activity节点为:
xml.application.activity[0]3.8.2 序列化并升级
将修改过的xml进行序列化为原生manifest,再通过文件路径写入升级
def serialize = XmlUtil.serialize(xml)file(manifestPath).write(serialize)引用参考
groovy Xml Api解析
groovy Api
迁移到 Android Plugin for Gradle 3.0.0
Android DSL官方文档
全面了解Gradle – 定义Task
1. 本站所有资源来源于用户上传和网络,如有侵权请邮件联系站长!
2. 分享目的仅供大家学习和交流,您必须在下载后24小时内删除!
3. 不得使用于非法商业用途,不得违反国家法律。否则后果自负!
4. 本站提供的源码、模板、插件等等其他资源,都不包含技术服务请大家谅解!
5. 如有链接无法下载、失效或广告,请联系管理员处理!
6. 本站资源售价只是摆设,本站源码仅提供给会员学习使用!
7. 如遇到加密压缩包,请使用360解压,如遇到无法解压的请联系管理员
开心源码网 » 通过Gradle动态修改Manifest文件