Android Studio工程通常包含多个AndroidManifest文件，最终构建成APK时，会合并成一个AndroidManifest文件。但是可能很多人应该都不知道是怎么合并的，本文将为大家揭开神秘面纱。
1. 合并冲突规则（merge conflict rules）
合并冲突，是指多个Manifest文件中含有同一属性但值不同时，默认合并规则解决不了从而导致的冲突。
当冲突发生时，高优先级的Manifest属性值会覆盖低优先级属性值。这个优先级规则由高到低依次是：
1 | buildType下的Manifest设置->productFlavor下的Manifest设置->主工程src/main->dependency&library |
默认合并冲突规则如下：
当然还存在例外情况：
1. uses-feature android:required和uses-library android:required默认值都是true，根据OR规则合并
2. 如果不指定uses-sdk，默认的minSdkVersion和targetSdkVersion值为1，当发生冲突时将使用高优先级的值。若不指定targetSdkVersion，其值等于targetSdkVersion
3. 当library工程的minSdkVersion比主工程src/main中的minSdkVersion低时会产生冲突，此时需要添加overLibrary标记解决冲突
4. 当library工程的targetSdkVersion比主工程src/main中的大时，合并过程会增加一些权限保证library工程能正常运行
5. 每个Manifest文件只和其子Manifest文件的属性合并
6. <intent-filter>的合并规则是叠加而不是覆盖
2. 合并冲突标记和选择器（merge conflict marker&selector）
合并冲突标记，是android tools namespace中的一个属性，用来解决默认冲突规则解决不了的冲突。
主要包含以下几个：
1. merge
默认合并操作。
2. replace
高优先级替换低优先级Manifest文件中的属性
3. strict
属性相同而值不同时会报错，除非通过冲突规则resolved
4. merge-only
仅合并低优先级的属性
5. remove
移除指定的低优先级的属性
6. remove-All
移除相同节点类型下所有低优先级的属性
注：节点层面默认使用merge，属性层面默认使用strict
下面看几个例子：
（1）使用replace标记解决androidk:icon和android:label属性冲突
[代码]xml代码：
1 2 3 4 | <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.android.tests.flavorlib.app" xmlns:tools="http://schemas.android.com/tools">
<application android:icon="@drawable/icon" android:label="@string/app_name" tools:replace="icon, label"> ...</application></manifest> |
（2）以下代码块中，src/main会覆盖library的<uses-sdk>。(默认情况下是不允许低优先级的minSdkVersion大于高优先级的，否则会报错。)
src/main/ Manifest:
[代码]xml代码：
1 2 3 | <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.android.example.app" xmlns:tools="http://schemas.android.com/tools"> ... <uses-sdk android:targetsdkversion="22" android:minsdkversion="2" tools:overridelibrary="com.example.lib1, com.example.lib2"> ...</uses-sdk></manifest> |
Library manifest:
[代码]xml代码：
1 2 3 | <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example.lib1"> ... <uses-sdk android:minsdkversion="4"> ...</uses-sdk></manifest> |
（3）以下代码块表示，移除library1中的permissionOne权限，而其他模块下该权限不受影响。
[代码]xml代码：
1 2 3 | <manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.android.example.app" xmlns:tools="http://schemas.android.com/tools"> ... <permission android:name="permissionOne" tools:node="remove" tools:selector="com.example.lib1"> ...</permission></manifest> |
3. 向AndroidManifest文件注入build变量值
注入build变量值通常需要使用manifestPlaceholders，applicationId属性除外。另外支持部分注入，如android:authority="com.acme.${localApplicationId}.foo".
直接看例子吧：
（1）注入applicationId
Manifest entry:
[代码]xml代码：
1 2 3 4 | <activity android:name=".Main"> <intent-filter> <action android:name="${applicationId}.foo"></action> </intent-filter></activity> |
Gradle build file:
[代码]xml代码：
1 2 3 4 5 6 7 8 9 | android { compileSdkVersion 22 buildToolsVersion "22.0.1"
productFlavors { flavor1 { applicationId = "com.mycompany.myapplication.productFlavor1" } } |
Merged manifest value:
[代码]xml代码：
1 | <action android:name="com.mycompany.myapplication.productFlavor1.foo" data-filtered="filtered"></action> |
（2）注入其他属性
Gradle build file:
[代码]xml代码：
01 02 03 04 05 06 07 08 09 10 11 | android { defaultConfig { manifestPlaceholders = [ activityLabel:"defaultName"] } productFlavors { free { } pro { manifestPlaceholders = [ activityLabel:"proName" ] } } |
Placeholder in the manifest file:
[代码]xml代码：
1 | <activity android:name=".MainActivity" android:label="${activityLabel}" data-filtered="filtered"></activity> |
4. 基于product favors group的合并（貌似没咋看懂，有知道的朋友可以告诉我～）
AndroidManifest合并顺序为：
prod-paid -> API-22-> density-mdpi -> ABI-x86
5. 关于隐藏的权限
当导入的library工程里隐含一些默认的权限时，合并过程会把这些默认权限加进来，以保证不同版本的sdk能够正常运行。如：
6. 关于merge错误处理
程序构建过程中，合并过程生成日志位于build/outputs/logs的manifest-merger-<productFlavor>-report.txt
Higher priority manifest declaration:
[代码]xml代码：
1 | <activity android:name="com.foo.bar.ActivityOne" android:screenorientation="portrait" android:theme="@theme1" data-filtered="filtered"></activity> |
Lower priority manifest declaration:
[代码]xml代码：
1 | <activity android:name="com.foo.bar.ActivityOne" android:screenorientation="landscape" data-filtered="filtered"></activity> |
Error log:
1 | /project/app/src/main/AndroidManifest.xml:3:9 Error:Attribute activity@screenOrientation value=(portrait) from AndroidManifest.xml:3:9is also present at flavorlib:lib1:unspecified:3:18 value=(landscape)Suggestion: add 'tools:replace="icon"' to element at AndroidManifest.xml:1:5 to override |
共同学习，写下你的评论
评论加载中...
作者其他优质文章
