Android构建--资源文件合并

什么文件是资源文件？

• /res目录下的所有文件，
• /assets目录
• Manifest文件

需要合并的资源文件来源是哪？

通常apk中的资源来源有3个，具体可以参考官网：

• 主资源(main source set)：比如src/main/res
• 编译变量(Build variant source set): 比如src/demoDebug/res
• 库文件依赖(libraries): 也就是我们引进的aar。

为什么要合并？

因为文件冲突了所以要合并。

那么随之而来的问题是系统如何唯一表示一个资源文件？相同resource type(anim/drawable/string等)和相同resource qualifier(比如hdpi, value中的语言等)下相同文件名的资源，系统会认为他是相同的，会导致冲突，需要合并。

如何合并？

合并/assets目录

asset冲突只会是文件冲突，规则也简单，优先使用本地文件。

合并/res目录

单一module中的资源文件发生冲突时如何合并？

单一module下可能就会有相同的资源存在，比如有多个主资源集。那么当出现这种冲突的情况的时候，系统会怎么处理呢？规则是低优先级的资源会被覆盖掉。

覆盖的优先级从高到低如下：

build variant > build type > product flavor > main source set > library dependences

举个栗子，如果我们主资源集下有两个资源： res/layout/a.xml, res/layout/b.xml, build type文件夹下面有res/layout/a.xml。那么最后打包生成的apk中的res/layout/a.xml来自于build type, res/layout/b.xml来自于main source set。

不同module中的资源文件发生冲突时如何合并？

当第三方依赖中的res文件与本地文件有冲突时，会优先选用本地文件。但res/values略有不同，此目录下的strings.xml、color.xml、styles.xml等文件会被整合到一个叫values.xml的文件中去，后与各第三方依赖中的values.xml进行内容上的合并，不会像res其它子目录文件一样直接舍弃第三方冲突文件。

Manifest合并

低优先级的manifest被合并到高优先级manifest中。

image

不同来源的manifest优先级由高到低：

• 构建变体（build variant）中的manifest
  • 构建变体（build variant）manifest: 例如src/demoDebug
  • 构建类型(build type) manifest: 例如src/debug
  • 产品风味(product flavor) manifest: 例如src/demo
• 本地 app module 中的manifest
• 依赖的库中的manifest

合并 manifest 中的属性值的默认规则如下：

High priority attribute	Low priority attribute	Attribute's merged result
No value	No value	No value (use default value)
No value	Value B	Value B
Value A	No value	Value A
Value A	Value A	Value A
Value A	Value B	Conflict error—you must add a merge rule marker

但是也有如下例外：

• <manifest>中的属性不会进行合并，直接使用高优先级manifest中的属性
• <uses-feature>和<uses-library>中的android:required属性使用or规则进行合并
• <uses-sdk>中的属性总是使用高优先级manifest中的，但以下情况例外：
  • 当低优先级中定义的minSdkVersion较高时会报错。但是可以使用overrideLibrary合并规则解决此错误。
  • 当低优先级中定义的targetSdkVersion较低时，合并工具会使用高优先级manifest中的较高值。但是，它还添加了确保导入的库继续正常工作所需的任何系统权限（以防更高版本的Android增加了权限限制的情况）。可以点击这里查看合并工具可能会添加的权限
• <intent-filter>元素在合并中不会被改变，只会被添加到其父节点中去