行为变更 | 了解 Android 12 中的 intent-filter

Android 12 一个重要的变更是提高应用和系统的安全性，这个变更影响了所有目标版本为 Android 12 的应用。

在 AndroidManifest.xml 文件中注册的 Activity、service 和 broadcast receiver 组件如果有 intent-filter 声明都必须显式申明是否需要对外披露服务 (android:exported)。

❗️如果您的应用出现了以下错误信息，很有可能和这个变更有关。

Installation did not succeed.

The application could not be installed: INSTALL_FAILED_VERIFICATION_FAILURE

List of apks:

[0] ‘…/build/outputs/apk/debug/app-debug.apk’

Installation failed due to: ‘null’

或

NSTALL_PARSE_FAILED_MANIFEST_MALFORMED: Failed parse during installPackageLI:

/data/app/vmdl538800143.tmp/base.apk (at Binary XML file line #…):

com.example.package.ActivityName: Targeting S+ (version 10000 and above) requires that an explicit

value for android:exported be defined when intent filters are present”

解决方法

要解决上述问题，您需要在 AndroidManifest.xml 文件中，为使用了 <intent-filter> 的 <activity>、<activity-alias>、<service> 或 <receiver> 组件声明 android:exported 属性。

我们非常期待收到您对这项关于本要求的反馈，如果有任何建议和想法，请填写这份 简短的调查问卷 向我们反馈，告诉我们您的应用中的哪些用例受到此变更的影响。

⚠️ 请不要 "简单粗暴" 地给这些组件直接添加 android:exported="true"，您需要检查并斟酌那些加入了 intent-filter 属性的组件: 用户设备上的任何其他应用都能启动这个组件，这是否是您需要的？

判断组件能否与其他应用的组件或服务相互调用或交互，这取决于应用本身的功能、其他应用如何与本应用交互，以及可能存在的特定应用场景。这里有一些常见例子，例子中包含了 intent-filter 的建议配置以及为什么要这样设置。

为包含 <category android:name="android.intent.category.LAUNCHER" /> 的 Activity 设定 android:exported="true"

这个 Activity 可能是您应用的 MainActivity，由于 Android 上的 Launcher (桌面/启动器) 是一个很常规的应用，这个 Activity 必须设定 exported="true"，否则 Launcher 应用就无法启动它。

为包含 <action android:name="android.intent.action.VIEW" /> 的 Activity 设定 android:exported="true"

这个 Activity 负责处理来自其他应用的 "open with" 操作。

为包含 <action android:name="android.intent.action.SEND" /> 或 <action android:name="android.intent.action.SEND_MULTIPLE"/> 的 Activity 设定 android:exported="true"

这个 Activity 负责处理来自其他应用分享的内容。如需了解更多，请参阅: 从其他应用接收简单的数据。

为包含 <action android:name="android.media.browse.MediaBrowserService" /> 的 Service 设定 android:exported="true"

如果这是一个将应用的媒体库公开给其他应用的 Service，则需要设定为 android:exported="true"，以便于其他应用连接和浏览。这个 Service 一般是通过直接或者间接继承 MediaBrowserServiceCompat 来实现的，如果不是，就没有必要设置这个。

为包含 <action android:name="com.google.firebase.MESSAGING_EVENT" /> Service 设定 android:exported="false"

这个 Service 会被 Firebase Cloud Messaging 调用，Service 需要继承 FirebaseMessagingService。这个 Service 不应该设定 android:exported="true"，因为无论它的属性值是什么，Firebase 都可以启动这个 Service。如需要了解更多，请参阅: 在 Android 上开发一个基于 Firebase Cloud 的消息应用。

为包含 <action android:name="android.intent.action.BOOT_COMPLETED" /> 的 Receiver 设定 android:exported="false"

因为无论是否设定 exported，系统都会向 receiver 发送对应的广播。

背景

在 Android 12 之前，有 intent-filter 属性的组件 (只有 Activity、Service 和 BroadcastReceiver) 自动被默认设定为 exported。

下面的 Activity 默认会 exported:

<activity android:name=".MainActivity">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

下面的 Activity 不会 exported:

<activity android:name=".MainActivity" />

这个默认的设置看起来可能合理，但这个错误可能会让应用容易受到攻击。举个例子，假设我们的应用有一个播放视频的 Activity:

<activity android:name=”.PlayVideoActivity” />

后来我们发现很多地方都需要显式地调用或启动这个 Activity，为了降低应用的耦合，我们给 Activity 添加了 intent-filter 属性，允许系统选择这个 Activity:

<activity android:name=”.PlayVideoActivity”>
    <intent-filter>
        <action android:name=”android.intent.action.VIEW” />
        <data
            android:mimeType=”video/*”
            android:scheme=”content” />
    </intent-filter>
</activity>

到这里问题就出现了，这个 Activity 设计的目的仅仅是在应用内部使用，可现在却被公开了！

如果我们的应用目标版本是 Android 12，系统会阻止这样的设置，并强制要求我们去设置 android:exported 属性。由于我们不想将 Activity 对外公开，我们可以设置 android:export=false，以确保应用的安全性。

<activity
    android:name=”.PlayVideoActivity”
    android:exported=”false”>
    <intent-filter>
        <action android:name=”android.intent.action.VIEW” />
        <data
            android:mimeType=”video/*”
            android:scheme=”content” />
    </intent-filter>
</activity>

简要总结

Android 12 一个重要的变化是提高了安全性。以 Android 12 为目标版本的应用，如果 AndroidManifest.xml 注册的 activity、activity-alias、service 或者 broadcast receiver 组件有 intent-filter 属性，必须显式设置 android:exported 的值，否则应用将无法安装。

需要仔细考虑 android:exported 属性需要设置什么值，如果不确定，建议设置 android:exported="false"。

了解更多关于 intent 和 intent-filter 的信息，请参阅: 接收一个隐式的 intent。

了解更多安全和隐私上的更新，请参阅: 行为变更: 以 Android 12 为目标平台的应用->安全性。

了解 Android 12 所有的更新，请参阅: Android 12 首个开发者预览版到来。