添加flutter_native_splash依赖后Android模拟器无法运行Flutter应用
解决flutter_native_splash导致Android模拟器无法启动的问题
检查依赖版本兼容性
打开pubspec.yaml,确认flutter_native_splash的版本和当前Flutter版本匹配。建议使用最新稳定版,比如指定flutter_native_splash: ^2.3.1,执行flutter pub get更新依赖。强制生成原生启动页资源
依赖安装后可能未正确生成原生端资源,执行命令:flutter pub run flutter_native_splash:create该命令会根据你在
pubspec.yaml中的配置,自动生成Android所需的drawable资源和启动页布局文件。检查Android项目配置
- 打开
android/app/src/main/AndroidManifest.xml,确认启动Activity配置正确:- 确保
<activity>标签的android:name为io.flutter.embedding.android.FlutterActivity或flutter_native_splash生成的SplashActivity,同时存在正确的主启动入口<intent-filter>。
- 确保
- 打开
android/app/build.gradle,检查minSdkVersion是否不低于16(flutter_native_splash的最低要求),若版本过低需调整。
- 打开
深度清理项目构建缓存
仅执行flutter clean可能不够,需清理Android端缓存:- 进入项目的
android目录,执行:# Windows系统 gradlew clean # macOS/Linux系统 ./gradlew clean - 返回项目根目录,执行
flutter pub get,再尝试启动模拟器。
- 进入项目的
排查模拟器状态
- 重启当前模拟器,或创建一个新的模拟器设备(比如选择API 33及以上版本)后重试。
- 确认模拟器已开启硬件加速,硬件加速未开启可能导致启动失败或异常缓慢。
内容的提问来源于stack exchange,提问作者Flying Chicken
相关产品推荐
相关产品推荐

