Android 沉浸式状态栏与导航栏：实现内容边缘到边缘显示教程

<!-- res/values/themes.xml 或 res/values-v21/themes.xml (如果需要兼容旧版本) -->
<resources>
    <style name="AppTheme" parent="Theme.MaterialComponents.DayNight.NoActionBar">
        <!-- 设置状态栏颜色为透明 -->
        <item name="android:statusBarColor">@android:color/transparent</item>
        <!-- 设置导航栏颜色为透明 -->
        <item name="android:navigationBarColor">@android:color/transparent</item>

        <!-- 可选：禁用对比度强制，以确保完全透明，但需注意内容可见性 -->
        <!-- 对于某些Android版本或特定设备，这些属性可能需要设置为false以确保完全透明 -->
        <!-- <item name="android:enforceStatusBarContrast">false</item> -->
        <!-- <item name="android:enforceNavigationBarContrast">false</item> -->
    </style>
</resources>

import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import androidx.core.view.WindowCompat; // 确保导入 androidx.core.view.WindowCompat
import android.view.Window;

public class MainActivity extends AppCompatActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // 获取当前窗口
        Window window = getWindow();
        // 关键一步：告诉系统不要为内容视图添加系统窗口内边距
        // 这将允许应用内容绘制到状态栏和导航栏的下方
        WindowCompat.setDecorFitsSystemWindows(window, false);

        setContentView(R.layout.activity_main);

        // 如果你的布局中有需要响应系统内边距的特定视图（例如，避免内容被导航栏遮挡），
        // 可以使用 ViewCompat.setOnApplyWindowInsetsListener 进行更精细的控制。
        // 示例：为根布局设置内边距监听器
        // ViewCompat.setOnApplyWindowInsetsListener(findViewById(R.id.root_layout), (v, insets) -> {
        //     // 获取系统栏的内边距
        //     Insets systemBars = insets.getInsets(WindowInsetsCompat.Type.systemBars());
        //     // 根据需要调整视图的 padding 或 margin，例如，为RecyclerView添加底部padding
        //     // v.setPadding(systemBars.left, systemBars.top, systemBars.right, systemBars.bottom);
        //     // 返回insets，以便它们可以被分发给子视图
        //     return insets;
        // });
    }
}

<!-- activity_main.xml -->
<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:id="@+id/root_layout"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="false" > <!-- 关键：确保此属性为 false 或不设置 -->

    <!-- 你的应用内容将在此处绘制，并可以延伸到系统栏下方 -->
    <ImageView
        android:layout_width="0dp"
        android:layout_height="0dp"
        android:scaleType="centerCrop"
        android:src="@drawable/background_image"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintBottom_toBottomOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent" />

    <TextView
        android:layout_width="wrap_content"
        android:layout_height="wrap_content"
        android:text="内容已延伸至屏幕边缘"
        android:textColor="@android:color/white"
        android:textSize="24sp"
        app:layout_constraintTop_toTopOf="parent"
        app:layout_constraintStart_toStartOf="parent"
        app:layout_constraintEnd_toEndOf="parent"
        app:layout_constraintBottom_toBottomOf="parent" />

</androidx.constraintlayout.widget.ConstraintLayout>