添加Google Maps后Flutter应用无法启动的问题求助

真机排查与修复步骤 #

• 检查手机权限：进入设置→安全与隐私，开启「允许安装未知来源应用」，同时确认USB调试模式下的「允许通过USB安装应用」选项已启用。
• 重置ADB连接：在命令行执行以下命令：

  adb kill-server
  adb start-server
  adb uninstall com.your.app.package  # 替换为你的应用包名
  

• 重新构建APK：清理旧构建文件后重新生成调试包

  flutter clean
  flutter build apk --debug
  

虚拟设备解决方案 #

• 重置模拟器数据：打开Android Studio的AVD Manager，选中目标模拟器，点击「Wipe Data」清除数据后重启。
• 适配模拟器环境：使用API 29及以上的系统镜像，确保模拟器已预装Google Play服务。
• 强制安装APK：通过命令行绕过权限限制安装

  adb install -r -d build/app/outputs/flutter-apk/app-debug.apk
  

  其中-r表示覆盖现有安装，-d允许降级安装（若存在旧版本应用）。

Google Maps配置校验 #

• 确认AndroidManifest.xml中的API密钥正确，且密钥绑定的包名、SHA-1指纹与当前项目完全匹配。
• 检查必要权限是否添加：

  <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
  <uses-permission android:name="android.permission.INTERNET" />
  

• 确保Module级build.gradle中引入了正确的Maps依赖：

  implementation 'com.google.android.gms:play-services-maps:18.2.0'
  

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