Flutter嵌入安卓应用Release模式白屏问题求助

问题现象 #

• Debug模式运行正常，Release模式下启动继承io.flutter.embedding.android.FlutterFragmentActivity的MainFlutterActivity后出现白屏
• 安卓日志反复输出：[DP] cancelDraw null isViewVisible: true
• 使用flutter logs无法捕获日志，即使在Flutter的main方法中添加print语句也无输出
• 已在安卓Release构建配置中设置minifyEnabled false、shrinkResources false，问题仍未解决，当前使用Flutter 2.10.5
• AndroidManifest中Flutter Activity配置如下：

<activity
    android:name=".MainFlutterActivity"
    android:exported="true"
    android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
    >
    <intent-filter>
        <action android:name="android.intent.action.MAIN" />
        <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
</activity>

排查与解决步骤 #

1. 确保Flutter引擎初始化正确

   • 手动初始化Flutter引擎并加入缓存，避免Release模式下引擎加载异常：

     class MainFlutterActivity : FlutterFragmentActivity() {
         private lateinit var flutterEngine: FlutterEngine
     
         override fun onCreate(savedInstanceState: Bundle?) {
             flutterEngine = FlutterEngine(this)
             flutterEngine.dartExecutor.executeDartEntrypoint(
                 DartExecutor.DartEntrypoint.createDefault()
             )
             FlutterEngineCache.getInstance().put("fixed_engine", flutterEngine)
             super.onCreate(savedInstanceState)
         }
     }
     

   • 启动Activity时指定使用缓存的引擎ID，避免重复初始化冲突。

2. 修复Release模式日志捕获问题

   • 替换print为debugPrint并强制开启Release日志输出，在main.dart中添加：

     void main() {
       debugPrint = (String? msg, {int? wrapWidth}) => print(msg);
       runApp(const MyApp());
     }
     

   • 检查安卓项目build.gradle的Release日志配置，确保未过滤Flutter相关日志。

3. 补充Activity硬件加速配置

   • Flutter依赖硬件加速渲染，在Manifest的Activity配置中添加android:hardwareAccelerated="true"：

     <activity
         android:name=".MainFlutterActivity"
         android:exported="true"
         android:hardwareAccelerated="true"
         android:configChanges="orientation|keyboardHidden|keyboard|screenSize|smallestScreenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
         >
         <!-- 原有intent-filter -->
     </activity>
     

4. 重新构建Flutter Release产物

   • 执行flutter build aar --release重新生成Release版AAR，确保产物无损坏后重新引入安卓项目。
   • 确认安卓项目依赖的是Flutter Release AAR而非Debug版本。

5. 针对Flutter 2.10.5的特定修复

   • 该版本存在Release模式渲染线程阻塞问题，可在MainFlutterActivity中添加代码触发重绘：

     override fun onPostResume() {
         super.onPostResume()
         flutterEngine?.renderer?.scheduleFrame()
     }
     

   • 也可考虑升级至同分支的稳定热修复版本（如2.10.5+hotfix.4）。

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