Android清单文件合并的那些事

APK文件只能包含一个AndroidManifest.xml文件,但Android Studio项目可以包含多个文件(通过buildSrc、导入的库引入)。因此,在构建应用时,Gradle构建会将所有清单文件合并到一个封装的APK的清单文件中。

清单文件合并优先级

清单合并工具

可以互相合并的基本清单文件,合并优先级如下(优先级由高到低):

  1. 清单文件构建变体
    如果变体有多个源集,其清单优先级由高到低如下:
    a、构建变体清单文件(如 src/demoDebug)
    b、构建类型清单(如 src/debug/)
    c、产品定制清单(如 src/demo/)
    如果使用的是定制纬度,清单优先级与每个维度在 flavorDimensions属性中的列示顺序(优先级高到低)对应。
  2. 应用模块的主清单文件
  3. 所包括库中的清单文件:如果有多个库,清单优先级与依赖顺序(库出现在 Gradle dependencies 块中的顺序)匹配。

重要说明:build.gradle文件中的构建配置将替换合并清单文件中的任何对应属性。如build.gradle文件中的minSdkVersion将替换清单元素中的匹配属性。

合并冲突启发式算法

合并工具行为:

重点:清单合并不依赖默认属性值。因此,应该按照期望明确定义每个属性。(每个属性的默认值都会记录在Manifest reference:https://developer.android.com/guide/topics/manifest/manifest-intro)

合并规则标记

可以针对整个元素或者只对元素中的特定属性应用标记。
所以标记都属于Android tools命名空间,因此必须现在元素中声明此命名空间:

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

节点标记:

属性标记:

标记选择器:

隐式系统权限

隐式权限:允许应用在无权限的情况下继续访问特定API,前提是应用的targetSdkVersion设置为低于添加限制的SDK版本的值。

原则:

合并工具可以添加至合并清单的权限列表:

低优先级清单声明 添加至合并清单的权限
targetSdkVersion是3或者更低 WRITE_EXTERNAL_STORAGE, READ_PHONE_STATE
targetSdkVersion是15或者更低,并且使用READ_CONTACTS READ_CALL_LOG
targetSdkVersion是15或者更低,并且使用WRITER_CONTACTS WRITE_CALL_LOG

具体合并策略:

总结

检查清单合并冲突:在Android Studio中打开AndroidManifest.xml文件,单机编辑器底部的 Merged Manifest选项卡。
合并策略:通过合并规则标记设置。

Android清单文件合并的那些事

全文结束