MapFragment中Toolbar状态栏适配异常的特殊问题求助

Let me break down why your current setup isn't working and walk you through the exact fixes to get your map fullscreen with the toolbar positioned correctly below the translucent status bar.

The Root Problem #

MapFragment (especially Google Maps' implementation) has its own internal logic to handle system window insets, which often overrides the fitsSystemWindows="false" setting you applied to your top-level FrameLayout. This is why it works in other Activities but fails here.

Step-by-Step Solution #

1. Configure Your Activity Theme First

Make sure your Activity uses a theme that enables a transparent status bar and removes the default action bar. Add this to your res/values/styles.xml:

<style name="MapActivityTheme" parent="Theme.MaterialComponents.Light.NoActionBar">
    <item name="android:statusBarColor">@android:color/transparent</item>
    <item name="android:windowTranslucentStatus">true</item>
    <item name="android:windowDrawsSystemBarBackgrounds">true</item>
</style>

Then apply this theme to your Activity in AndroidManifest.xml:

<activity
    android:name=".YourMapActivity"
    android:theme="@style/MapActivityTheme" />

2. Adjust Your Layout Structure

Your root FrameLayout should keep fitsSystemWindows="false", and we'll position the toolbar to sit below the status bar dynamically (since status bar height varies across devices):

<FrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="false">

    <!-- Container for MapFragment -->
    <FrameLayout
        android:id="@+id/map_container"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

    <!-- Translucent Toolbar -->
    <androidx.appcompat.widget.Toolbar
        android:id="@+id/toolbar"
        android:layout_width="match_parent"
        android:layout_height="?attr/actionBarSize"
        android:background="@color/dark_transparent" />

</FrameLayout>

3. Dynamically Set Toolbar Padding for Status Bar

Hardcoding a status bar height isn't reliable, so use window insets to set the toolbar's top padding programmatically.

In your Activity's onCreate method (Kotlin):

val toolbar = findViewById<Toolbar>(R.id.toolbar)
setSupportActionBar(toolbar)

// Apply status bar inset as toolbar top padding
ViewCompat.setOnApplyWindowInsetsListener(toolbar) { view, insets ->
    val statusBarHeight = insets.systemWindowInsetTop
    view.setPadding(view.paddingLeft, statusBarHeight, view.paddingRight, view.paddingBottom)
    insets.consumeSystemWindowInsets()
}

Or for Java:

Toolbar toolbar = findViewById(R.id.toolbar);
setSupportActionBar(toolbar);

ViewCompat.setOnApplyWindowInsetsListener(toolbar, (view, insets) -> {
    int statusBarHeight = insets.getSystemWindowInsetTop();
    view.setPadding(view.getPaddingLeft(), statusBarHeight, view.getPaddingRight(), view.getPaddingBottom());
    return insets.consumeSystemWindowInsets();
});

4. Force MapFragment to Ignore System Window Insets

This is the critical step to override the MapFragment's internal inset handling. In your MapFragment's onViewCreated method:

Kotlin:

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    // Disable fitsSystemWindows for the map's root view
    ViewCompat.setFitsSystemWindows(view, false)

    // Initialize map and disable default map toolbar if needed
    getMapAsync { googleMap ->
        googleMap.uiSettings.isMapToolbarEnabled = false
        // Add your map configuration here
    }
}

Java:

@Override
public void onViewCreated(@NonNull View view, @Nullable Bundle savedInstanceState) {
    super.onViewCreated(view, savedInstanceState);
    ViewCompat.setFitsSystemWindows(view, false);

    getMapAsync(googleMap -> {
        googleMap.getUiSettings().setMapToolbarEnabled(false);
        // Add your map configuration here
    });
}

Why This Works #

• The theme ensures the status bar is transparent and doesn't block the map.
• Dynamically setting the toolbar's padding ensures it sits exactly below the status bar on any device.
• Disabling fitsSystemWindows on the MapFragment's view forces the map to extend fullscreen, including under the status bar.

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