Kotlin开发中Fragment内无法加载Google Map的问题求助

• 核心不匹配：布局文件使用MapView控件，但代码中尝试通过childFragmentManager查找SupportMapFragment，二者类型不兼容，导致mapFragment始终为null，getMapAsync方法从未执行，onMapReady无回调。
• 生命周期缺失：MapView需要手动绑定Fragment的生命周期方法，未绑定会导致地图无法正常初始化、加载和销毁。

提供两种可选方案，二选一即可：

方案1：保留现有MapView布局，修改Kotlin代码 #

修改后的Kotlin代码如下：

class busFragment : Fragment(), OnMapReadyCallback {
    private lateinit var mMap: GoogleMap
    private lateinit var mapView: MapView

    companion object {
        val TAG: String = busFragment::class.java.simpleName
        fun newInstance() = busFragment()
    }

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        val rootView = inflater.inflate(R.layout.fragment_bus, container, false)
        // 初始化MapView
        mapView = rootView.findViewById(R.id.map)
        // 绑定MapView的onCreate生命周期
        mapView.onCreate(savedInstanceState)
        // 异步获取地图实例
        mapView.getMapAsync(this)
        return rootView
    }

    override fun onMapReady(googleMap: GoogleMap) {
        mMap = googleMap
        // 这里可以添加地图配置，比如添加标记、移动镜头等
    }

    // 手动绑定MapView的其余生命周期
    override fun onStart() {
        super.onStart()
        mapView.onStart()
    }

    override fun onResume() {
        super.onResume()
        mapView.onResume()
    }

    override fun onPause() {
        super.onPause()
        mapView.onPause()
    }

    override fun onStop() {
        super.onStop()
        mapView.onStop()
    }

    override fun onDestroyView() {
        super.onDestroyView()
        mapView.onDestroy()
    }

    override fun onSaveInstanceState(outState: Bundle) {
        super.onSaveInstanceState(outState)
        mapView.onSaveInstanceState(outState)
    }

    override fun onLowMemory() {
        super.onLowMemory()
        mapView.onLowMemory()
    }
}

方案2：改用SupportMapFragment实现（无需手动管理生命周期） #

第一步：修改XML布局 #

将布局中的MapView替换为Fragment控件：

<androidx.constraintlayout.widget.ConstraintLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context="busFragment">

    <fragment
        android:id="@+id/map"
        android:name="com.google.android.gms.maps.SupportMapFragment"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</androidx.constraintlayout.widget.ConstraintLayout>

第二步：修改Kotlin代码 #

修正查找Fragment的逻辑，补全变量赋值：

class busFragment : Fragment(), OnMapReadyCallback {
    private lateinit var mMap: GoogleMap

    companion object {
        val TAG: String = busFragment::class.java.simpleName
        fun newInstance() = busFragment()
    }

    override fun onCreateView(
        inflater: LayoutInflater,
        container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        val rootView = inflater.inflate(R.layout.fragment_bus, container, false)
        // 查找SupportMapFragment并赋值给变量
        val mapFragment = childFragmentManager.findFragmentById(R.id.map) as SupportMapFragment
        mapFragment.getMapAsync(this)
        return rootView
    }

    override fun onMapReady(googleMap: GoogleMap) {
        mMap = googleMap
        // 此处添加地图配置逻辑
    }
}

• 确认AndroidManifest.xml中的YOUR_API_KEY已替换为谷歌云控制台申请的有效密钥，且已开启Maps SDK for Android服务。
• 设备需安装谷歌服务框架，且网络可正常访问谷歌服务。

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