Flutter调试模式安装APK黑屏卡顿（Vivo Android13）求非降级方案

问题背景 #

调试模式下安装Flutter应用APK时，Vivo Android 13设备出现黑屏卡顿，原生应用运行正常。该问题曾在Android 11出现，Android 12时修复，Android 13复现，且降级系统之外的常规方法均无效。

可行解决方案 #

1. 修正AndroidManifest组件导出配置 #

Android 13对组件导出权限要求更严格，需确保Flutter主Activity及相关组件的android:exported属性正确设置：
打开android/app/src/main/AndroidManifest.xml，在MainActivity的<activity>标签中添加：

android:exported="true"

若存在Launcher相关的Activity或Receiver，也需同步设置该属性。

2. 关闭调试模式下的代码优化 #

在android/app/build.gradle的buildTypes模块中，调整debug配置，禁用可能与Vivo系统冲突的优化：

buildTypes {
    debug {
        debuggable true
        minifyEnabled false
        shrinkResources false
        proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
    }
}

3. 清理缓存并重建项目 #

执行以下命令清理Flutter缓存，重新构建调试APK：

flutter clean
flutter pub get
flutter build apk --debug

同时清理Android Studio缓存：依次点击File > Invalidate Caches... > Invalidate and Restart。

4. 调整Vivo开发者选项设置 #

• 关闭OriginOS中的「系统优化」类选项（如「极致性能优化」）
• 确保开启「USB调试」「允许调试应用」，并授予Android Studio/ADB「安装未知应用」权限
• 将「后台进程限制」设置为「标准限制」或「无限制」

5. 切换Flutter版本适配 #

• 升级至最新稳定版：flutter upgrade
• 若最新版仍有问题，降级至适配Android 13的稳定版本（如3.7.12）：flutter downgrade 3.7.12

内容的提问来源于stack exchange，提问作者Sagar Kafle