清单文件的合并

资料

官网

优先级

清单文件在合并时,会按优先级进行合并。会按 优先级从低向高合并,优先级最低的清单文件会合并到优先级倒数第二低的文件中,然后今次向下合并。

优先级按高到低如下:

  1. 主清单文件

  2. 各库中的文件。如果有多个库,其清单优先级与依赖顺序(库出现在 Gradle dependencies 块中的顺序)匹配。

合并规则

  1. 如果优先级较低的清单中的元素与优先级较高的清单中的任何元素均不匹配,则该元素将被添加至合并清单。

  2. 如果有匹配元素,则合并工具会尝试将其中的所有属性合并到相同元素中。如果工具发现两个清单包含相同属性,但值不相同,则会出现合并冲突。

匹配规则

但如下几个标签不会出现另外:

  1. <manifest> 元素中的属性绝不合并 — 仅使用优先级最高的清单中的属性

  2. <uses-sdk>元素始终使用优先级较高的清单中的值,但以下情况除外:

    • 如果低优先级清单的 minSdkVersion较高,除非您应用 overrideLibrary 合并规则

    • 如果低优先级清单的 targetSdkVersion较低,合并工具将使用高优先级清单中的值,但也会添加任何必要的系统权限,以确保所导入的库继续正常工作(适用于较高的 Android 版本具有更多权限限制的情况)。

  3. <intent-filter> 每个元素都被视为唯一元素,并添加至合并清单中的常用父元素。也就是说,<intent-filter> 不会被合并。

合并规则标记

合并规则标记是一个 XML 属性,可用于表达您对关于如何解决合并冲突或删除不需要的元素和属性的首选项。 您可以对整个元素或只对元素中的特定属性应用标记。

合并两个清单文件时,合并工具会在高优先级清单文件中寻找这些标记

所有的标识分为两种类型,一种作用于节点,一种作用于属性。


节点标记

作用于整个 xml 元素。其对应的属性名为 node。值如下:

属性值 含义
merge 合并此标记中的所有属性以及所有嵌套元素
merge-only-attributes 只合并属性,不合并子元素
remove 删除匹配的元素
removeAll 删除所有匹配的标签
replace 忽略低优先级内容,完全使用高优先级内容
strict 只要两个清单文件不一样,无论是否能合并,都会出现冲突

在比对元素是否相同时,只比例标签名以及其中的 name 属性值。如果都相同,则认为相同;否则不相同。

merge

默认行为。合并此标记中的所有属性以及所有嵌套元素。如

低版本为:

       <activity android:name="com.demo.MainActivity"
            android:hardwareAccelerated="false" >
            <meta-data
                android:name="test"
                android:value="test" />
        </activity>

高版本为

        <activity
            android:name="com.demo.MainActivity"
            android:screenOrientation="portrait"
            tools:node="merge">

        </activity>

则合并后为:

 <activity
    android:name="com.demo.MainActivity"
    android:screenOrientation="portrait"
    android:hardwareAccelerated="false">
            <meta-data
                android:name="test"
                android:value="test" />
</activity>

merge-only-attributes

仅合并元素的属性,不合并子元素。

remove

删除满足条件的元素

如高版本配置如下:

      <meta-data android:name="test"
            android:value="main"
            tools:node="remove" />

则合并后的清单文件中不会含有该 meta-data。

removeAll

删除所有标配的标签。使用该属性值时,标签中不能含有任何其他属性,也就是说该标签中除了 tools:node="removeAll" 外,不能配置任何其他属性。

        <meta-data
            android:name="test"
            tools:node="removeAll" />

上述配置会删除同一父元素内的所有 <meta-data> 标签。

replace

完全替换低优先级元素。 也就是说,如果低优先级清单中有匹配元素,请将其忽略并完全按照其在此清单中显示样子来使用该元素。

标签匹配不单指标签名相同,其 name 元素的值也要相同。

<meta-data
      android:name="test"
      tools:node="replace" />

strict

当此元素在低优先级清单中的情况与在高优先级清单中的情况不完全匹配时生成构建故障。如:

<!---高优先级-->
<activity
    tools:node="strict"
    android:name="com.example.ActivityOne"
    android:windowSoftInputMode="stateUnchanged">
    <intent-filter>
         <action android:name="android.intent.action.SEND" />
         <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

<!--低优先级-->
<activity
    android:name="com.example.ActivityOne"
    android:screenOrientation="portrait" />

上述两个文件在合并时,会产生冲突;但如果将 strict 换成 merge 会合并成功。


属性标记

属性标记只会影响某个 xml 标签中的某个属性,不会影响整个标签。

每个属性接受一个或多个属性名称(包括属性命名空间),并以逗号分隔。

replace

将低优先级清单中的指定属性替换为此清单中的属性。 换言之,始终保持高优先级清单的值

<!--高版本-->
<meta-data
     android:name="test"
     android:resource="@string/test"
     android:value="main"
     tools:replace="android:value,android:resource" />
<!--低版本-->
<meta-data
     android:name="test"
     android:resource="@string/app_name"
     android:value="test" />

首先,replace 的值是 android:value,而不是 value。也就是说:在 配置属性名时,需要带名称空间

其次,replace 可以配置多个属性,属性之间通过逗号分隔。

上述文件合并后,得到的依旧是高版本的配置。

remove

从合并清单中删除指定属性

<!--高版本-->
<meta-data
    android:name="test"
    android:value="main"
    tools:remove="android:resource" />
<!--低版本-->
<meta-data
    android:name="test"
    android:resource="@string/app_name" />
<!--合并结果-->
<meta-data
    android:name="test"
    android:value="main" />

因为在高优先级中使用了 remove,则合并后不会出现 android:resource 属性。

strict

当这些属性在低优先级清单中的情况与在高优先级 清单中的不完全匹配时生成构建故障。 默认行为。


选择器

仅对某个特定的导入库应用合并规则标记,需要使用 tools:selector 属性。

例如,对于下面的清单,仅在低优先级清单文件来自 com.example.lib1 库时应用 remove 合并规则。

<permission android:name="permissionOne"
    tools:node="remove"
    tools:selector="com.example.lib1">

如果低优先级清单来自其他源,系统将会忽略 remove 合并规则。


<uses-sdk>

默认时,如果库的 minSdk 高于主工程的,则会出错,无法导入该库。可以将 overrideLibrary 添加至 <uses-sdk> 标签中。

overrideLibrary 属性值可以是一个或多个库的包名(以逗号分隔),指明可能替换主清单的 minSdkVersion 的库。

如主工程设置 minSdk 为 21, library 设置为 22。则合并时会出现错误。可以在主工程的清单文件中添加如下配置:

    <uses-sdk tools:overrideLibrary="com.library.package" />

其中 com.library.package 替换为库的包名。

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

推荐阅读更多精彩内容