Flutter 1.22.4升级Android V2嵌入后Release模式启动页崩溃求助
崩溃根因
升级V2嵌入架构后,Release构建下出现该崩溃的核心触发逻辑是:应用冷启动阶段,系统会优先唤起独立的后台Service(这里就是FlutterFirebaseMessagingService),此时进程还没走到常规的Activity/Application层Flutter初始化流程,Service的onCreate方法直接调用Flutter初始化校验接口,因为前置的startInitialization流程没有执行,直接触发状态校验异常。
Debug构建下不会复现该问题,是因为Debug模式下Flutter初始化时序更宽松,且后台Service不会在冷启动最早期被系统优先调度。
具体修复方案
- 重构Flutter初始化时序,将初始化逻辑从Activity层上移到Application层,匹配Flutter 1.22.4的V2嵌入要求:
- 在自定义Application的
attachBaseContext方法中提前触发Flutter初始化,覆盖Service先于Application核心逻辑执行的时序差:import io.flutter.embedding.engine.loader.FlutterLoader; @Override protected void attachBaseContext(Context base) { super.attachBaseContext(base); // 提前启动Flutter初始化 FlutterLoader.getInstance().startInitialization(base); } - 在Application的
onCreate方法中补全初始化完成的状态通知,打通初始化校验闭环:@Override public void onCreate() { super.onCreate(); // 标记Flutter初始化完成 FlutterLoader.getInstance().ensureInitializationComplete(this, null); }
- 在自定义Application的
- 调整Manifest中Firebase消息服务的配置,避免冷启动阶段被系统过早唤起:
在AndroidManifest.xml中覆写插件自动注册的FlutterFirebaseMessagingService配置,新增进程绑定属性,切断系统在应用未完全启动时唤起服务的路径:<service android:name="io.flutter.plugins.firebasemessaging.FlutterFirebaseMessagingService" android:stopWithTask="true" android:exported="false"> <intent-filter> <action android:name="com.google.firebase.MESSAGING_EVENT" /> </intent-filter> </service> - 补全Release构建的混淆保留规则:
因为Release构建会开启R8/Proguard裁剪,容易误删Flutter初始化相关的类导致状态异常,需要在proguard-rules.pro中增加保留规则:-keep class io.flutter.embedding.engine.loader.** { *; } -keep class io.flutter.plugins.firebasemessaging.** { *; }
注意:不要强行升级高于1.22.4兼容范围的firebase_messaging插件版本,否则会引入新的V2嵌入兼容问题,上述方案完全适配你当前使用的Flutter 1.22.4版本。
内容的提问来源于stack exchange,提问作者user4246398
相关产品推荐
相关产品推荐

