1. 理解全屏沉浸式UI的需求
在现代Android应用设计中，全屏沉浸式体验（Edge-to-Edge UI）已成为一种趋势。它允许应用内容充分利用屏幕空间，延伸到系统状态栏（顶部）和导航栏（底部）的下方，从而提供更广阔、更具吸引力的视觉效果。实现这一效果，需要将系统栏设置为透明，并确保应用内容能够绘制到这些区域。
2. 配置系统栏透明度
首先，我们需要通过应用的主题样式将状态栏和导航栏设置为透明。这通常在themes.xml文件中完成。
注意事项：
- android:enforceStatusBarContrast 和 android:enforceNavigationBarContrast 属性在 Android 10 (API 29) 及以上版本引入，用于防止系统在透明系统栏下强制添加一层半透明背景以提高对比度。将其设置为false可以确保系统栏的完全透明。
- 为了更好的兼容性，建议在values-v29/themes.xml中定义这些特定于API 29+的属性，而在values/themes.xml中只定义statusBarColor和navigationBarColor。
3. 允许内容绘制到系统栏下方
仅仅设置系统栏透明并不能让内容绘制到其下方。我们需要告诉系统，我们的应用窗口不应该被系统UI（如状态栏、导航栏）所“装饰”或“适配”，而是应该全屏显示。这通过WindowCompat.setDecorFitsSystemWindows()方法实现。
在你的Activity中，通常在onCreate()方法或onAttachedToWindow()方法中调用此API：
import androidx.core.view.WindowCompat;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import android.view.Window;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
// 获取当前窗口
Window window = getWindow();
// 设置窗口不适应系统窗口，允许内容绘制到系统栏下方
WindowCompat.setDecorFitsSystemWindows(window, false);
}
}WindowCompat是AndroidX库提供的一个兼容性API，它能确保在不同Android版本上以正确的方式实现这一效果。
4. 解决常见陷阱：android:fitsSystemWindows="true"
许多开发者在尝试实现全屏沉浸式UI时，会发现即使按照上述步骤操作，内容依然没有绘制到系统栏下方，屏幕边缘仍有空白区域。这通常是由于布局文件中存在android:fitsSystemWindows="true"属性导致的。
android:fitsSystemWindows="true"属性的本意是告诉系统，该View（或其子View）应该在其内容周围留出足够的内边距，以避免与系统窗口（如状态栏、导航栏）重叠。当你在根布局或某个父布局上设置了此属性时，它会抵消WindowCompat.setDecorFitsSystemWindows(window, false)的效果，导致内容被“推”离系统栏区域。
解决方案： 检查你的所有布局文件，尤其是Activity的根布局，确保没有将android:fitsSystemWindows属性设置为true。通常，你应该直接移除此属性，或者将其设置为false。
错误的示例（导致内容不延伸）：
正确的示例（允许内容延伸）：
或者，如果你确实需要在某个子View上保留fitsSystemWindows的行为，请确保它不会影响到你希望延伸到系统栏下方的根内容。
5. 处理内容与系统栏的重叠（Window Insets）
当内容绘制到系统栏下方后，可能会出现UI元素（如顶部工具栏、底部按钮）被状态栏图标或导航手势区域遮挡的问题。为了解决这个问题，你需要使用WindowInsets来获取系统栏的实际大小，并相应地调整你的UI布局。
WindowInsets提供了一种机制，允许View查询其周围的系统UI元素（如状态栏、导航栏、键盘等）所占用的空间。通过监听WindowInsets的变化，你可以为你的View添加合适的内边距，以避免内容被遮挡。
import androidx.core.view.ViewCompat;
import androidx.core.view.WindowInsetsCompat;
import androidx.core.view.WindowInsetsControllerCompat;
import android.os.Bundle;
import androidx.appcompat.app.AppCompatActivity;
import android.view.View;
import android.widget.LinearLayout;
public class MainActivity extends AppCompatActivity {
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Window window = getWindow();
WindowCompat.setDecorFitsSystemWindows(window, false);
// 获取根布局
View rootLayout = findViewById(R.id.root_layout); // 假设你的根布局ID为root_layout
// 监听WindowInsets的变化
ViewCompat.setOnApplyWindowInsetsListener(rootLayout, (v, insets) -> {
// 获取系统栏的insets
WindowInsetsCompat systemBarsInsets = insets.getInsets(WindowInsetsCompat.Type.systemBars());
// 获取状态栏高度
int statusBarHeight = systemBarsInsets.top;
// 获取导航栏高度
int navigationBarHeight = systemBarsInsets.bottom;
// 获取左右边距（例如刘海屏或圆角屏幕）
int leftInset = systemBarsInsets.left;
int rightInset = systemBarsInsets.right;
// 例如，为顶部Toolbar添加顶部内边距，避免被状态栏遮挡
// 假设你的Toolbar ID为toolbar
View toolbar = findViewById(R.id.toolbar);
if (toolbar != null) {
toolbar.setPadding(toolbar.getPaddingLeft(),
statusBarHeight,
toolbar.getPaddingRight(),
toolbar.getPaddingBottom());
}
// 例如，为底部按钮添加底部内边距，避免被导航栏遮挡
// 假设你的底部按钮容器ID为bottom_buttons_container
View bottomButtonsContainer = findViewById(R.id.bottom_buttons_container);
if (bottomButtonsContainer != null) {
bottomButtonsContainer.setPadding(bottomButtonsContainer.getPaddingLeft(),
bottomButtonsContainer.getPaddingTop(),
bottomButtonsContainer.getPaddingRight(),
navigationBarHeight);
}
// 如果需要，也可以处理左右边距
v.setPadding(leftInset, v.getPaddingTop(), rightInset, v.getPaddingBottom());
// 返回insets，表示你已经处理了这些insets，不再向下传递
return insets; // 或者 insets.consumeSystemWindowInsets() 在旧版API中
});
}
}布局示例 (activity_main.xml):
6. 总结
实现Android全屏沉浸式UI，使内容延伸至透明系统栏下方，需要以下关键步骤：
- 主题配置： 在themes.xml中设置android:statusBarColor和android:navigationBarColor为@android:color/transparent，并在API 29+上禁用android:enforceStatusBarContrast和android:enforceNavigationBarContrast。
- 窗口适配： 在Activity中调用WindowCompat.setDecorFitsSystemWindows(getWindow(), false)，告知系统窗口不应为系统UI保留空间。
- 布局检查： 确保根布局或相关父布局中没有android:fitsSystemWindows="true"属性，这是最常见的导致问题的原因。
- 内容适配： 使用ViewCompat.setOnApplyWindowInsetsListener监听WindowInsets，并根据系统栏的高度动态调整UI元素的内边距，以避免内容被遮挡。
通过遵循这些指导原则，开发者可以成功构建出具有现代化、全屏沉浸式体验的Android应用程序。
