manifest-exported-plugin

用于快速适配 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.0.6'
}

👨‍🔧‍ 使用方式

添加插件

在主app Model中添加：

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

或

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

参数说明

app-build.gradle

apply plugin: 'com.xiachufang.manifest.exported'
...
  
exported {
    actionRules = ["android.intent.action.MAIN"]
    enableMainManifest false
    logOutPath ""
}

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

actionRules action的匹配项(数组), 如：

<activity android:name=".simple.MainActivity" >
      <intent-filter>
          // action 对应的 android:name 可与actionRules 数组任意一项匹配 ,并且当前没有配置exported
            // -> yes: android:exported="true"
            // -> no: android:exported="false"
        <action android:name="android.intent.action.MAIN"/>
        <category android:name="android.intent.category.LAUNCHER"/>
      </intent-filter>
</activity>

enableMainManifest 是否对主 model-AndroidManifest 进行修改

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

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

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

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

📰 相关截图说明

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

💭 注意事项

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

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

对于业务 model ,我们建议开发者自行适配,这属于我们可控范围，适配来说主要就是为了不可控的，即第三方 aar

修改之后，会影响原有的 manifest 代码风格，需要重新格式化一下，相比默认的，增加了不少空格，暂时不知道怎么解决。

原理简述

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

zjw-swun / manifest-exported-plugin