Flutter 3.27.2在Android 13设备启动页后黑屏问题求助

问题场景 #

使用Flutter 3.27.2开发应用，在Android 14设备上调试一切正常，未做任何特殊UI渲染配置，但在Android 13物理设备调试时，启动页结束后出现黑屏。尝试用命令flutter run --no-enable-impeller启动可解决问题，但通过VS Code点击绿色部署箭头时，黑屏问题依旧存在。

原因分析 #

VS Code的绿色部署按钮默认使用launch.json中的配置启动应用，不会自动带上--no-enable-impeller参数，所以单独命令行有效，但IDE部署时还是启用了Impeller，导致Android 13设备出现兼容性黑屏。

解决方案 #

方案1：修改VS Code的launch.json配置 #

• 打开VS Code的launch.json文件：可以通过左侧「运行和调试」面板点击「创建launch.json文件」（已有则直接打开），或者按下Ctrl+Shift+P输入Open launch.json快速打开。
• 在配置的args数组中添加--no-enable-impeller参数，示例配置如下：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Flutter",
            "request": "launch",
            "type": "dart",
            "args": ["--no-enable-impeller"]
        }
    ]
}

• 保存配置后，再次点击VS Code的绿色部署箭头，应用会以禁用Impeller的方式启动，Android 13设备的黑屏问题即可解决。

方案2：全局禁用Impeller（无需每次配置参数） #

如果不想每次启动都配置参数，可以直接在Android项目中全局禁用Impeller：

• 打开Android项目的android/app/src/main/AndroidManifest.xml文件
• 在<application>标签内添加以下meta-data配置：

<meta-data
    android:name="io.flutter.embedding.android.EnableImpeller"
    android:value="false" />

• 保存后，无论使用命令行还是VS Code部署应用，都会默认禁用Impeller，彻底解决Android 13设备的黑屏问题。

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