From 8db977c3d97e0c56b16a4582970ea46a9c11debb Mon Sep 17 00:00:00 2001
From: Max <maxleexyz@gmail.com>
Date: Fri, 20 Mar 2026 04:43:14 +0800
Subject: [PATCH] =?UTF-8?q?fix:=20=E6=B3=A8=E5=85=A5=20Android=2013=20?=
 =?UTF-8?q?=E9=A2=84=E6=B5=8B=E6=89=8B=E5=8A=BF=E5=B9=B6=E5=9C=A8=E5=BA=95?=
 =?UTF-8?q?=E5=B1=82=E5=BC=BA=E5=88=B6=E7=A6=81=E7=94=A8=20Impeller=20?=
 =?UTF-8?q?=E5=BC=95=E6=93=8E=E4=BF=9D=E9=9A=9C=20WebView=20=E6=B8=B2?=
 =?UTF-8?q?=E6=9F=93=E7=A8=B3=E5=AE=9A?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../android/src/main/AndroidManifest.xml            | 13 +++++++++++--
 1 file changed, 11 insertions(+), 2 deletions(-)

diff --git a/packages/web_shell_core/android/src/main/AndroidManifest.xml b/packages/web_shell_core/android/src/main/AndroidManifest.xml
index a00fa62..e9c4757 100644
--- a/packages/web_shell_core/android/src/main/AndroidManifest.xml
+++ b/packages/web_shell_core/android/src/main/AndroidManifest.xml
@@ -45,8 +45,17 @@
     <uses-feature android:name="android.hardware.bluetooth" android:required="false"/>
     <uses-feature android:name="android.hardware.bluetooth_le" android:required="false"/>
 
-    <!-- 通过 Manifest Merger 将 cleartextTraffic 自动注入宿主 application，解决前序核查发现的 HTTP default_url 问题 -->
-    <application android:usesCleartextTraffic="true">
+    <!-- 通过 Manifest Merger 将底层应用属性自动注入宿主 application -->
+    <application
+        android:usesCleartextTraffic="true"
+        android:enableOnBackInvokedCallback="true">
+        
+        <!-- 防御性降级：鉴于本项目属于纯 WebView 壳，Impeller (Flutter 的新一代渲染引擎) 
+             在 Android 端对 Platform View (WebView底层依赖) 的硬件兼容性目前仍有偶发性黑屏、花屏或内存泄漏 Bug。
+             强制此参数为 false (退回使用极度成熟的 Skia 引擎) 是保证数千款低端教育平板不崩溃的最优解。-->
+        <meta-data
+            android:name="io.flutter.embedding.android.EnableImpeller"
+            android:value="false" />
     </application>
 
     <!-- url_launcher 在 Android 11+ 检测应用需要白名单 -->