Android Studio中Fragment集成Google Maps API崩溃问题排查

看起来你遇到了两个典型的Google Maps集成问题，咱们一步步来解决：

1. 处理Channel未正确关闭的RuntimeException #

这个问题几乎都是因为MapView的生命周期没有和Fragment的生命周期正确绑定导致的。在Fragment中使用MapView时，必须严格在对应的生命周期方法里调用MapView的同名方法，否则会出现资源泄漏或通道未关闭的异常。

请检查你的LocationFragment.java，确保包含以下完整的生命周期实现：

public class LocationFragment extends Fragment implements OnMapReadyCallback {
    private MapView mapView;
    private GoogleMap googleMap;

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        View view = inflater.inflate(R.layout.fragment_location, container, false);
        mapView = view.findViewById(R.id.map_view);
        mapView.onCreate(savedInstanceState);
        mapView.getMapAsync(this);
        return view;
    }

    @Override
    public void onMapReady(GoogleMap map) {
        googleMap = map;
        // 在这里配置地图，比如设置初始定位、添加标记等
    }

    @Override
    public void onStart() {
        super.onStart();
        mapView.onStart();
    }

    @Override
    public void onResume() {
        super.onResume();
        mapView.onResume();
    }

    @Override
    public void onPause() {
        super.onPause();
        mapView.onPause();
    }

    @Override
    public void onStop() {
        super.onStop();
        mapView.onStop();
    }

    @Override
    public void onDestroyView() {
        super.onDestroyView();
        mapView.onDestroy();
    }

    @Override
    public void onSaveInstanceState(Bundle outState) {
        super.onSaveInstanceState(outState);
        mapView.onSaveInstanceState(outState);
    }

    @Override
    public void onLowMemory() {
        super.onLowMemory();
        mapView.onLowMemory();
    }
}

同时确认fragment_location.xml中的MapView配置正确：

<com.google.android.gms.maps.MapView
    android:id="@+id/map_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent" />

2. 解决org.apache.http.ProtocolVersion的NoClassDefFoundError #

从Android 9（API级别28）开始，系统默认移除了Apache HTTP客户端库，但Google Maps SDK的部分版本仍依赖它。要解决这个问题，需要在AndroidManifest.xml的<application>标签内添加以下配置：

<application ...>
    <!-- 其他已有配置 -->
    <uses-library
        android:name="org.apache.http.legacy"
        android:required="false" />
</application>

另外，建议检查你的Google Maps依赖版本，使用最新稳定版可以避免更多兼容性问题，在模块级build.gradle中更新依赖：

dependencies {
    implementation 'com.google.android.gms:play-services-maps:18.2.0'
    // 如果需要位置服务，可添加以下依赖
    implementation 'com.google.android.gms:play-services-location:21.0.1'
}

额外验证点 #

• 确认API Key已正确配置在AndroidManifest.xml中，且已在Google Cloud控制台启用Google Maps Android API：

  <meta-data
      android:name="com.google.android.geo.API_KEY"
      android:value="你的API_KEY" />
  

• 确保测试设备/模拟器已安装Google Play服务，且版本符合Maps SDK要求；
• 检查是否添加了必要权限：

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

按照以上步骤修改后，重新编译运行应用，应该就能解决这两个闪退问题了。

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