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.xmlcolor.xmlstyles.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>元素在合并中不会被改变,只会被添加到其父节点中去
最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,919评论 6 502
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,567评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 163,316评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,294评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,318评论 6 390
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,245评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,120评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,964评论 0 275
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,376评论 1 313
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,592评论 2 333
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,764评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,460评论 5 344
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,070评论 3 327
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,697评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,846评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,819评论 2 370
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,665评论 2 354