用于快速适配 Android12-Manifest-exported 的插件。

📚 背景

从 Android12 开始，如果我们的 tagSdk >=31, 即以 Android 12 或更高版本为目标平台时，且包含使用 intent 过滤器的 activity、服务或广播接收器，则必须为这些应用组件显式声明 android:exported 属性。

对于我们的主 model，我们可以手动处理，但是对于第三方的 aar,此时就只有在业务 manifest 中进行重写，比较麻烦。而且查找起来也并不容易。

manifest-exported-plugin 就是对上述任务进行自动适配的一款插件。

👨‍💻‍ 依赖方式

添加 jitpack 仓库

build.gradle

Gradle7.0 以下

buildscript {
    repositories {
            // ...
            maven { url 'https://jitpack.io' }
    }
}

Gradle7.0+,并且已经对依赖方式进行过调整，则可能需要添加到如下位置：

settings.gradle

pluginManagement {
    repositories {
        //...
           maven { url 'https://jitpack.io' }
       }
 }

Gradle

dependencies {
      classpath 'com.github.xiachufang:manifest-exported-plugin:1.1.1'
}

👨‍🔧‍ 使用方式

添加插件

在主 app Model 中添加：

apply plugin: 'com.xiachufang.manifest.exported'

或

plugins {
 id 'com.xiachufang.manifest.exported'
}

build.gradle

apply plugin: 'com.xiachufang.manifest.exported'
...

exported {
    // 是否写入主 Model
    enableMainManifest false
    // 规则
    ruleFile new File("$projectDir/xxx.json")
    // 输出文件,默认-app/build/exported/outManifestLog.md
    outPutFile null
}

配置参数说明

enableMainManifest

是否对主 model-AndroidManifest 进行修改

对于主 model,属于业务可控的，建议开发者自行调整。

插件默认不会对主 model-AndroidManifest 进行修改,如果发现可用匹配上述规则的，即会进行修正。

开发者可根据日志中的提示，进行修改。

注意：这个操作会对 Manifest 的展示样式造成一定影响，建议一般不要打开。

outPutFile

日志输出目录，默认 app/build/exported/outManifest.md

ruleFile

具体的规则 json 文件, 格式如下：

{
  "actionRules": [
    "android.intent.action.MAIN"
  ],
  "whiteNames": [],
  "blackPackages": [],
  "blackNames": [],
  "blackIgnores": []
}

actionRules

默认判断规则，用于当前没有配置 exported 的修改逻辑,如果当前存在 exported,则跳过。

具体判断逻辑:

如果 intent-filter - action 对应的 android:name 与 actionRules 中任意一条匹配,则将 exported 修改为 true ,否则为false 。

whiteNames

白名单类名,如果遇到此类,并且使用了 intent-filter ,则会将 exported 修改为 true

blackPackages

黑名单 包名合集,对于此包名下的类,如果使用了 intent-filter ,则会将 exported 直接修改为 false

blackNames

黑名单 类名合集，如果遇到此合集中的类,并且使用了 intent-filter ,则会将 exported 直接修改为 true 。判断逻辑会与上面 blackPackages 一起判断,两者满足其一即可。

blackIgnores

黑名单 下要忽视的类,在黑名单判断时,如果遇到此类，则使用默认规则 actionRules 判断。

📰 相关截图说明

默认情况下插件的输出目录如下所示，主 model/build/exportred/outManifest.md,默认日志如下：

💭 注意事项

对于主 model 下的 manifest ，默认不进行适配(可开关 enableManifest )，会通过日志进行输出，建议大家自行对比调整。

为什么默认不对主 model 进行适配？

• 对于业务 model ,我们建议开发者自行适配,这属于我们可控范围，适配来说主要就是为了不可控的，即第三方 aar
• 修改之后，会影响原有的 manifest 代码风格，需要重新格式化一下，相比默认的，增加了不少空格，暂时不知道怎么解决。

原理简述

在 ProgressXXXMainManifest 任务之前进行插入,通过对 manifest 进行修改，从而实现 exported 的适配。