Android12升级targetSdkVersion到31后安装报INSTALL_PARSE_FAILED_MANIFEST_MALFORMED的排查方法(android:exported显式声明与合并清单定位)

把targetSdkVersion从30改到31,编出来的包装到Android 12的测试机上直接失败,Logcat里只有一句Installation did not succeed和INSTALL_PARSE_FAILED_MANIFEST_MALFORMED,重签名、清数据、换数据线都试过,还是装不上。这个坑在适配Android 12的时候踩过不止一次,报错看着像清单文件写坏了,实际是组件少写了一个属性。


Android 12(API 31)开始,只要activity、service、receiver或provider里带了intent-filter,就必须显式写android:exported,系统不再替应用猜默认值。以前带intent-filter默认等价于true,现在留空直接卡在安装阶段。


少一个属性就装不上。


版本这条线要理清楚:Android 12、12L、13、14、15、16,对应的API是31、32、33、34、35、36;compileSdk 31、32、33、34、35,AGP 7.0.0、7.4.0、8.0.0、8.3.0、8.7.0,Gradle 7.0.2、7.5、8.0、8.4、8.7,这条要求从API 31一直延续到后面几代,不是某一个小版本的临时行为。2021年Android 12正式发布,2023年起Google Play要求新应用targetSdk至少到33,躲是躲不掉的。


1、先确认报错到底出在构建期还是安装期。用Android Studio点Run时出现的通常是Manifest merger failed,原文是Apps targeting Android 12 and higher are required to specify an explicit value for android:exported when the corresponding component has an intent filter defined,属于合并清单阶段就拦下来;用adb install装已经打好的包时报的是INSTALL_PARSE_FAILED_MANIFEST_MALFORMED: Failed parse during installPackageLI,后面还带Targeting S+ (version 31 and above) requires that an explicit value for android:exported be defined when intent filters are present。两个报错指向同一件事,排查入口却不一样。


adb install -r app/build/outputs/apk/debug/app-debug.apk
adb logcat | grep -i PackageManager
aapt dump xmltree app-debug.apk AndroidManifest.xml | grep exported


2、打开app/src/main/AndroidManifest.xml,把所有带intent-filter的组件挨个补上android:exported。带LAUNCHER类别的主activity必须写true,其余只给应用内部调用的写false;别图省事全填true,把service和receiver暴露给外部应用能调起,是实打实的安全问题。


<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>


3、自己写的清单改完还报同样的错,八成是依赖库带进来的。Android Studio底部点开Merged Manifest视图,或者翻app/build/intermediates/merged_manifests/debug/AndroidManifest.xml,看哪些activity是库里合并进来的、没带exported。之前接手过一个项目,主工程四个组件全补齐了,结果是一个老版本的支付SDK里藏了个没声明exported的receiver,翻合并清单才找到。


不升级库版本的话,可以在主清单里对同一个组件名再声明一次,用tools:node="merge"加tools:replace="android:exported"把值覆盖掉,根节点记得带xmlns:tools="http://schemas.android.com/tools"。


<activity
    android:name="com.xxx.sdk.PayActivity"
    android:exported="false"
    tools:node="merge"
    tools:replace="android:exported"/>


4、改完别急着发版,先用aapt dump xmltree核一遍打包后的清单,确认每个带intent-filter的组件都出现了exported="true"或exported="false",再跑adb install。这里有个容易混的地方:只有带intent-filter的组件才被强制要求,没有intent-filter的activity不写exported也没事,默认值本来就是false;反过来,targetSdk还停在30的老包不受这条限制,装到Android 12机器上照样能跑,所以同一台设备上新包装不上、老包正常并不矛盾。另外Android 12还要求PendingIntent显式给FLAG_IMMUTABLE或FLAG_MUTABLE,报错串完全不同,别和这条混在一起查。折腾半天发现是两个适配项叠在一起,那种情况也遇到过。


适配期间留着Merged Manifest这个入口,比出一次错翻一遍源码省事得多。数据截至2026年11月,Android 12到16的行为变更文档都还挂着这条要求。