Android 12 导出属性错误解决方案

问题描述

当您上传 APK 或 Android App Bundle 到 Google Play 时，可能会遇到以下错误：

"您上传的 APK 或 Android App Bundle 包含带有 intent filter 的 activity、activity alias、service 或 broadcast receiver，但没有设置 'android:exported' 属性。此文件无法在 Android 12 或更高版本上安装。"

这是由于 Android 12 引入的新安全要求导致的。从 Android 12 开始，任何包含 intent filter 的组件都必须显式声明 android:exported 属性。

解决方案概览

解决此问题的主要方法是确保所有包含 <intent-filter> 的组件都明确设置 android:exported 属性：

• android:exported="true": 当组件需要被其他应用访问时
• android:exported="false": 当组件仅供内部使用时

详细解决方案

1. 检查主清单文件

首先检查您的主 AndroidManifest.xml 文件，确保所有相关组件都设置了 android:exported 属性：

<!-- 对于主启动 Activity -->
<activity
    android:name=".MainActivity"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

<!-- 对于服务 -->
<service
    android:name=".MyService"
    android:exported="false" />

<!-- 对于广播接收器 -->
<receiver
    android:name=".MyReceiver"
    android:exported="false">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
    </intent-filter>
</receiver>

2. 使用合并清单视图查找问题

在 Android Studio 中，您可以使用合并清单功能查看最终合并后的 Manifest 文件：

1. 打开 AndroidManifest.xml 文件
2. 点击底部的 Merged Manifest 标签页
3. 查找所有包含 <intent-filter> 但没有 android:exported 属性的组件

TIP

如果看不到合并清单视图，请确保您的 build.gradle 中设置了正确的 compileSdkVersion 和 targetSdkVersion（至少 30）

3. 处理第三方库的问题

很多时候，问题来自您项目中使用的第三方库。您需要在主清单文件中覆盖这些库的组件声明：

<!-- 示例：覆盖 Razorpay 组件 -->
<activity
    android:name="com.razorpay.CheckoutActivity"
    android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
    android:theme="@style/CheckoutTheme"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <data
            android:host="rzp.io"
            android:scheme="io.rzp" />
    </intent-filter>
</activity>

<receiver 
    android:name="com.razorpay.RzpTokenReceiver"
    android:exported="true"
    android:permission="android.permission.INTERNET">
    <intent-filter>
        <action android:name="rzp.device_token.share" />
    </intent-filter>
</receiver>

4. 特定框架的解决方案

Flutter 项目

对于 Flutter 项目，常见的解决方案包括：

1. 更新所有插件到最新版本
2. 在主 AndroidManifest.xml 中添加缺失的 android:exported 属性
3. 检查并处理 flutter_local_notifications 等常见插件的接收器

<!-- 处理 flutter_local_notifications 的启动接收器 -->
<receiver android:name="com.dexterous.flutterlocalnotifications.ScheduledNotificationBootReceiver"
    android:exported="true">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED"/>
        <action android:name="android.intent.action.MY_PACKAGE_REPLACED"/>
    </intent-filter>
</receiver>

React Native 项目

对于 React Native，您可以：

1. 检查 android/app/build/intermediates/merged_manifests/release/AndroidManifest.xml
2. 将所有包含 <intent-filter> 但缺少 android:exported 的组件复制到主清单文件
3. 添加适当的 android:exported 属性

Unity 项目

Unity 开发者可以：

1. 导出 Android 项目
2. 在 Android Studio 中打开并构建
3. 检查合并后的清单文件：YourExportedProjectFolder/launcher/build/intermediates/merged_manifests/release
4. 将缺失 android:exported 的组件添加到 Assets/Plugin/Android/AndroidManifest.xml

<receiver android:name="universal.tools.notifications.ScheduledNotificationsRestorer" 
    android:exported="true" 
    tools:replace="android:exported">
    <intent-filter>
        <action android:name="android.intent.action.BOOT_COMPLETED" />
    </intent-filter>
</receiver>

5. 使用 Android 12 模拟器调试

如果无法确定问题来源，可以在 Android 12 模拟器上运行应用，编译器会明确指出哪个组件导致了问题。

常见问题与解决方案

注意事项

• 不要将 targetSdkVersion 降级到 30 或以下，这只是临时解决方案
• 确保所有第三方库都是最新版本
• 仔细检查每个组件的导出需求，不要盲目设置为 true

Q: 如何决定使用 android:exported="true" 还是 android:exported="false"？

A: 遵循以下原则：

• 如果组件包含 LAUNCHER category，设置为 true
• 如果组件需要被其他应用访问，设置为 true
• 如果组件仅供内部使用，设置为 false

Q: 合并清单视图看不到怎么办？

A: 尝试以下方法：

1. 确保 compileSdkVersion 和 targetSdkVersion 至少为 30
2. 同步 Gradle 项目
3. 清理并重新构建项目

总结

Android 12 的导出属性要求增强了应用安全性，但也给开发者带来了额外的配置工作。通过系统性地检查主清单文件、使用合并清单功能识别第三方库问题，并正确设置每个组件的导出属性，您可以顺利解决此问题并确保应用符合最新的安全标准。

记住，安全性是 Android 生态系统的核心，正确配置导出属性不仅是为了满足商店要求，更是保护用户数据的重要措施。