AndroidManifest合并原理

cbty0746 8年前發布 | 51K 次閱讀安卓開發 Android Studio開發工具

原文出處： http://wangxinghe.me/blog/2016-02-05/androidmanifest-merge/

Android Studio工程通常包含多個AndroidManifest文件，最終構建成APK時，會合并成一個AndroidManifest文件。但是可能很多人應該都不知道是怎么合并的，本文將為大家揭開神秘面紗。

1. 合并沖突規則（merge conflict rules）

合并沖突，是指多個Manifest文件中含有同一屬性但值不同時，默認合并規則解決不了從而導致的沖突。

當沖突發生時，高優先級的Manifest屬性值會覆蓋低優先級屬性值。這個優先級規則由高到低依次是：

buildType下的Manifest設置->productFlavor下的Manifest設置->主工程src/main->dependency&library

默認合并沖突規則如下：

當然還存在例外情況：

uses-feature android:required和uses-library android:required默認值都是true，根據OR規則合并
如果不指定uses-sdk，默認的minSdkVersion和targetSdkVersion值為1，當發生沖突時將使用高優先級的值。若不指定targetSdkVersion，其值等于targetSdkVersion
當library工程的minSdkVersion比主工程src/main中的minSdkVersion低時會產生沖突，此時需要添加overLibrary標記解決沖突
當library工程的targetSdkVersion比主工程src/main中的大時，合并過程會增加一些權限保證library工程能正常運行
每個Manifest文件只和其子Manifest文件的屬性合并
<intent-filter>的合并規則是疊加而不是覆蓋

2. 合并沖突標記和選擇器（merge conflict marker&selector）

合并沖突標記，是android tools namespace中的一個屬性，用來解決默認沖突規則解決不了的沖突。

主要包含以下幾個：

merge

默認合并操作。
replace

高優先級替換低優先級Manifest文件中的屬性
strict

屬性相同而值不同時會報錯，除非通過沖突規則resolved
merge-only

僅合并低優先級的屬性
remove

移除指定的低優先級的屬性
remove-All

移除相同節點類型下所有低優先級的屬性

注：節點層面默認使用merge，屬性層面默認使用strict

下面看幾個例子：

（1）使用replace標記解決androidk:icon和android:label屬性沖突

<manifest xmlns:android="（2）以下代碼塊中，src/main會覆蓋library的<uses-sdk>。(默認情況下是不允許低優先級的minSdkVersion大于高優先級的，否則會報錯。)

src/main/ Manifest:
<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"/>
   ... 
 Library manifest:

<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.lib1">
    ...    <uses-sdk android:minSdkVersion="4" />
    ...</manifest> 
 （3）以下代碼塊表示，移除library1中的permissionOne權限，而其他模塊下該權限不受影響。

<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">
       ... 
 3. 向AndroidManifest文件注入build變量值

注入build變量值通常需要使用manifestPlaceholders，applicationId屬性除外。另外支持部分注入，如android:authority="com.acme.${localApplicationId}.foo".
直接看例子吧：
（1）注入applicationId
Manifest entry:
<activity android:name=".Main">
    <intent-filter>
        <action android:name="${applicationId}.foo"></action>
    </intent-filter></activity> 
 Gradle build file:

android {
    compileSdkVersion 22
    buildToolsVersion "22.0.1"

productFlavors {
    flavor1 {
        applicationId = "com.mycompany.myapplication.productFlavor1"
    }
}</pre> 

Merged manifest value:
<action android:name="com.mycompany.myapplication.productFlavor1.foo"> 
 （2）注入其他屬性

Gradle build file:
android {
    defaultConfig {
        manifestPlaceholders = [ activityLabel:"defaultName"]
    }
    productFlavors {
        free {
        }
        pro {
            manifestPlaceholders = [ activityLabel:"proName" ]
        }
    } 
 Placeholder in the manifest file:

<activity android:name=".MainActivity" android:label="${activityLabel}" > 
 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:
<activity
    android:name="com.foo.bar.ActivityOne"
    android:screenOrientation="portrait"
    android:theme="@theme1"/> 
 Lower priority manifest declaration:

<activity
    android:name="com.foo.bar.ActivityOne"
    android:screenOrientation="landscape"/> 
 Error log:

/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 
  本文原文發自 某學姐 。 
 </div>