Xamarin.Forms集成GoogleMaps后安卓运行闪退如何解决

以下按故障出现概率从高到低排序排查，可逐点核对：

• 补全安卓端SDK初始化代码
  这是最常见的漏配项：你需要在安卓项目的MainActivity.cs文件中添加地图初始化逻辑，代码位置需放在Xamarin.Forms.Forms.Init(...)执行完成后、LoadApplication(new App())执行前，代码如下：

  protected override void OnCreate(Bundle savedInstanceState)
  {
      TabLayoutResource = Resource.Layout.Tabbar;
      ToolbarResource = Resource.Layout.Toolbar;
  
      base.OnCreate(savedInstanceState);
      global::Xamarin.Forms.Forms.Init(this, savedInstanceState);
      // 必须添加这行初始化代码，漏写会在加载地图控件时直接闪退
      Xamarin.FormsGoogleMaps.Init(this, savedInstanceState);
      LoadApplication(new App());
  }
  

• 核对API Key配置正确性
  1. 你添加的地图API Key的<meta-data>标签必须放在AndroidManifest.xml的<application>节点内部，放在节点外层会导致系统无法读取Key直接触发崩溃
  2. 确认申请的Key类型为Google Maps Android SDK专用Key，Web端、iOS端的Key无法在安卓端正常鉴权；调试阶段可暂时取消Key的包名、SHA1签名绑定，排除鉴权失败问题
  3. 若使用安卓模拟器调试，必须选择带Google Play服务标识的官方模拟器镜像，纯AOSP无Google服务框架的镜像无法运行Google Maps SDK，启动即闪退
• 检查NuGet包安装一致性
  确认共享代码项目、安卓平台项目都安装了完全相同版本的Xamarin.Forms.GoogleMaps包，仅在共享项目安装、或两端版本不一致，会导致原生绑定库加载失败引发崩溃
• 适配安卓运行时权限规则
  安卓6.0（API 23）及以上版本中，位置权限属于运行时敏感权限，仅在Manifest中静态声明不会自动授权。如果不需要地图展示用户当前位置，可以先给地图控件添加IsShowingUser="False"属性，跳过定位权限触发逻辑；如果需要定位能力，必须在应用运行时动态申请位置权限后再加载地图
• 核对安卓项目目标框架版本
  Xamarin.Forms.GoogleMaps对安卓平台最低要求为Android 10.0（API 29），若安卓项目目标框架版本低于该值，会因缺少原生依赖出现加载崩溃
• 抓取精确崩溃日志定位根因
  如果以上配置全部核对完成仍存在闪退，可通过日志拿到具体异常信息：
  1. 在Visual Studio调试状态下打开输出窗口，将输出来源切换为Android，复现闪退时过滤AndroidRuntime或Mono标签的日志，可直接看到崩溃的具体异常栈（如类找不到、鉴权失败、权限拒绝等）
  2. 也可通过命令行执行adb logcat *:E抓取设备全量错误日志，定位崩溃触发点

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