组件化：合并清单文件

最近做项目，在集成第三方aar以后，本来请求读写权限允许以后应该是权限授予成功了，但是结果却是读权限授予成功了，但是写权限未授权。

主项目清单文件权限声明如下：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

然后通过Android Studio的Merged Manifest看板发现合并后变成了：

<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission
    android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    android:maxSdkVersion="18" />

解决方法如下：

<uses-permission
    android:name="android.permission.WRITE_EXTERNAL_STORAGE"
    tools:node="replace" />

提示：使用Merged Manifest视图可预览清单合并结果并找出冲突错误

合并优先级

合并工具会根据每个清单文件的优先级按顺序合并，将所有清单文件组合到一个文件中。

合并冲突启发法

如果较低优先级的清单文件与较高优先级清单文件的元素都不相同，则直接将低优先级清单文件合并到高优先级清单文件中即可。如果低优先级中有与高优先级清单文件中相同的元素，则会尝试将同元素的所有属性都合并到一起。如果低优先级中与高优先级中存在相同元素，并且相同元素下又存在相同属性，但是属性的值不同，则会发生合并冲突。

属性值的默认合并行为如下表：

高优先级属性	低优先级属性	属性的合并结果
没有值	没有值	没有值（使用默认值）
没有值	值 B	值 B
值 A	没有值	值 A
值 A	值 A	值 A
值 A	值 B	冲突错误 - 必须添加合并规则标记

合并规则标记

所有标记都属于Android tools命名空间，因此必须先在元素中声明此命名空间。

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.myapp"
    xmlns:tools="http://schemas.android.com/tools">

注意：对于应用模块，tools合并标记会在合并后移除；不过，对于库模块，tools合并标记在合并后不会移除，并可能会影响下游模块中的合并

• tools:node=“merge”
  在没有冲突的情况下，使用合并冲突启发法合并此标记中的所有属性以及所有嵌套元素。这是元素的默认行为

• tools:node=“merge-only-attributes”
  仅合并此标记中的属性，不合并嵌套元素

• tools:node=“remove”
  从合并后的清单中移除此元素。虽然似乎只需要删除此元素即可，但如果发现合并后的清单中有不需要的元素，而且该元素是由不受控制的优先级较低的清单文件（如导入的库）提供的，则必须使用此属性

• tools:node=“removeAll”
  与 tools:node=“remove” 类似，但它会移除与此元素类型匹配的所有元素（同一父元素内）

• tools:node=“replace”
  完全替换优先级较低的元素。也就是说，如果优先级较低的清单中有匹配的元素，会将其忽略并完全按照此元素在此清单中显示的样子使用它

• tools:node=“strict”
  每当此元素在优先级较低的清单中与在优先级较高的清单中不完全匹配时，都会导致构建失败（除非已通过其他合并规则标记解决）。这会替换合并冲突启发式算法

参考：https://developer.android.com/studio/build/manage-manifests#merge-manifests

感谢大家的支持，如有错误请指正，如需转载请标明原文出处！