如何在edge-to-edge模式下为AppBarLayout设置Drawable背景？

我要给AppBarLayout设置渐变背景，但碰到两个头疼的问题：

• 开启edge-to-edge模式后，标题直接覆盖在状态栏上面
• 给布局添加fitsSystemWindows="true"后，界面会多出一块不必要的空白区域

原布局代码：

<?xml version="1.0" encoding="utf-8"?>
<androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    xmlns:tools="http://schemas.android.com/tools">

    <com.google.android.material.appbar.AppBarLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:background="@android:color/transparent"
        android:clipToPadding="true"
        app:liftOnScroll="true"
        app:liftOnScrollTargetViewId="@id/recycler_view">

        <com.google.android.material.appbar.CollapsingToolbarLayout
            style="@style/CollapsingToolbar.Large"
            android:layout_width="match_parent"
            android:layout_height="?attr/collapsingToolbarLayoutLargeSize"
            app:contentScrim="@android:color/transparent"
            app:layout_scrollFlags="scroll|exitUntilCollapsed|snap">

            <ImageView
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:scaleType="centerCrop"
                android:src="@drawable/gradient"
                app:layout_collapseMode="parallax" />

            <com.google.android.material.appbar.MaterialToolbar
                android:id="@+id/topAppBar"
                android:layout_width="match_parent"
                android:fitsSystemWindows="true"
                android:layout_height="?attr/actionBarSize"
                app:layout_collapseMode="pin"
                app:title="Title"
                />
            

        </com.google.android.material.appbar.CollapsingToolbarLayout>

    </com.google.android.material.appbar.AppBarLayout>

    <androidx.recyclerview.widget.RecyclerView
        android:id="@id/recycler_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:clipToPadding="false"
        app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
        app:layout_behavior="@string/appbar_scrolling_view_behavior" />

</androidx.coordinatorlayout.widget.CoordinatorLayout>

1. 调整fitsSystemWindows的设置位置 #

把fitsSystemWindows="true"从MaterialToolbar移到AppBarLayout上，同时移除Toolbar的该属性。这样整个AppBar区域会统一适配系统窗口，避免局部区域出现空白：

<com.google.android.material.appbar.AppBarLayout
    android:layout_width="match_parent"
    android:layout_height="wrap_content"
    android:background="@android:color/transparent"
    android:clipToPadding="true"
    android:fitsSystemWindows="true" <!-- 移到此处 -->
    app:liftOnScroll="true"
    app:liftOnScrollTargetViewId="@id/recycler_view">

    <!-- 其他代码不变 -->

    <com.google.android.material.appbar.MaterialToolbar
        android:id="@+id/topAppBar"
        android:layout_width="match_parent"
        <!-- 删除此处的fitsSystemWindows属性 -->
        android:layout_height="?attr/actionBarSize"
        app:layout_collapseMode="pin"
        app:title="Title" />

2. 让渐变背景延伸到状态栏 #

给CollapsingToolbarLayout和内部的ImageView都添加android:fitsSystemWindows="true"，确保渐变背景能铺满包括状态栏在内的整个AppBar区域：

<com.google.android.material.appbar.CollapsingToolbarLayout
    style="@style/CollapsingToolbar.Large"
    android:layout_width="match_parent"
    android:layout_height="?attr/collapsingToolbarLayoutLargeSize"
    android:fitsSystemWindows="true" <!-- 添加该属性 -->
    app:contentScrim="@android:color/transparent"
    app:layout_scrollFlags="scroll|exitUntilCollapsed|snap">

    <ImageView
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:scaleType="centerCrop"
        android:src="@drawable/gradient"
        android:fitsSystemWindows="true" <!-- 添加该属性 -->
        app:layout_collapseMode="parallax" />

3. 正确配置Edge-to-Edge模式 #

在Activity的onCreate方法中完成edge-to-edge的基础配置，同时根据渐变背景的深浅调整状态栏图标的颜色：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    // 启用edge-to-edge模式
    WindowCompat.setDecorFitsSystemWindows(window, false)
    // 状态栏图标设为深色（如果渐变背景偏浅则开启，反之关闭）
    WindowInsetsControllerCompat(window, window.decorView).isAppearanceLightStatusBars = true
    setContentView(R.layout.your_layout)
}

4. 调整RecyclerView的内边距 #

启用edge-to-edge后，RecyclerView的顶部内容可能会被AppBar遮挡，给它添加顶部内边距，直接引用系统ActionBar的高度值即可：

<androidx.recyclerview.widget.RecyclerView
    android:id="@id/recycler_view"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:clipToPadding="false"
    android:paddingTop="?attr/actionBarSize" <!-- 添加顶部内边距 -->
    app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
    app:layout_behavior="@string/appbar_scrolling_view_behavior" />

最终完整布局代码 #

<?xml version="1.0" encoding="utf-8"?>
<androidx.coordinatorlayout.widget.CoordinatorLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    xmlns:tools="http://schemas.android.com/tools">

    <com.google.android.material.appbar.AppBarLayout
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:background="@android:color/transparent"
        android:clipToPadding="true"
        android:fitsSystemWindows="true"
        app:liftOnScroll="true"
        app:liftOnScrollTargetViewId="@id/recycler_view">

        <com.google.android.material.appbar.CollapsingToolbarLayout
            style="@style/CollapsingToolbar.Large"
            android:layout_width="match_parent"
            android:layout_height="?attr/collapsingToolbarLayoutLargeSize"
            android:fitsSystemWindows="true"
            app:contentScrim="@android:color/transparent"
            app:layout_scrollFlags="scroll|exitUntilCollapsed|snap">

            <ImageView
                android:layout_width="match_parent"
                android:layout_height="match_parent"
                android:scaleType="centerCrop"
                android:src="@drawable/gradient"
                android:fitsSystemWindows="true"
                app:layout_collapseMode="parallax" />

            <com.google.android.material.appbar.MaterialToolbar
                android:id="@+id/topAppBar"
                android:layout_width="match_parent"
                android:layout_height="?attr/actionBarSize"
                app:layout_collapseMode="pin"
                app:title="Title" />

        </com.google.android.material.appbar.CollapsingToolbarLayout>

    </com.google.android.material.appbar.AppBarLayout>

    <androidx.recyclerview.widget.RecyclerView
        android:id="@id/recycler_view"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:clipToPadding="false"
        android:paddingTop="?attr/actionBarSize"
        app:layoutManager="androidx.recyclerview.widget.LinearLayoutManager"
        app:layout_behavior="@string/appbar_scrolling_view_behavior" />

</androidx.coordinatorlayout.widget.CoordinatorLayout>

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