Android API 29-35 全屏适配问题求助

一、主题配置 #

首先为目标Activity配置全屏主题，确保无ActionBar并适配刘海/挖孔屏：

<!-- res/values/themes.xml -->
<style name="AppTheme.Fullscreen" parent="Theme.Material3.Light.NoActionBar">
    <item name="android:windowFullscreen">true</item>
    <item name="android:windowDrawsSystemBarBackgrounds">true</item>
    <!-- 允许内容延伸至刘海/挖孔区域 -->
    <item name="android:windowLayoutInDisplayCutoutMode">shortEdges</item>
</style>

在AndroidManifest.xml中为对应Activity绑定该主题：

<activity
    android:name=".YourFullscreenActivity"
    android:theme="@style/AppTheme.Fullscreen"/>

二、Activity代码实现 #

根据API版本分情况处理，避免使用过时方法，同时保证沉浸式体验：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_your_fullscreen);

    Window window = getWindow();
    View decorView = window.getDecorView();

    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        // API 30+ 采用WindowInsetsController实现全屏
        WindowInsetsController insetsController = decorView.getWindowInsetsController();
        if (insetsController != null) {
            // 隐藏状态栏和导航栏
            insetsController.hide(WindowInsets.Type.statusBars() | WindowInsets.Type.navigationBars());
            // 设置滑动临时显示系统栏的行为
            insetsController.setSystemBarsBehavior(WindowInsetsController.BEHAVIOR_SHOW_TRANSIENT_BARS_BY_SWIPE);
        }
        // 禁用系统栏布局偏移，让内容延伸至全屏区域
        window.setDecorFitsSystemWindows(false);
    } else {
        // API 29 兼容旧实现（添加过时注解消除警告）
        @SuppressLint("ObsoleteSdkInt")
        int systemUiFlags = View.SYSTEM_UI_FLAG_FULLSCREEN
                | View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
                | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY
                | View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
                | View.SYSTEM_UI_FLAG_LAYOUT_HIDE_NAVIGATION
                | View.SYSTEM_UI_FLAG_LAYOUT_STABLE;
        decorView.setSystemUiVisibility(systemUiFlags);
        // 允许窗口布局不受系统栏限制
        window.setFlags(WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS, WindowManager.LayoutParams.FLAG_LAYOUT_NO_LIMITS);
    }
}

三、布局文件配置 #

确保根布局禁用系统栏适配偏移，避免预留空白区域：

<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout 
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:fitsSystemWindows="false">

    <!-- 你的业务内容布局 -->

</androidx.constraintlayout.widget.ConstraintLayout>

四、常见问题解决 #

• 顶部黑条：检查根布局的android:fitsSystemWindows是否设为false，该属性设为true会导致系统预留状态栏空间，隐藏系统栏后该区域显示黑色背景。
• Play Store过时方法提示：严格区分API版本，API30+必须使用WindowInsetsController替代SystemUiVisibility相关方法，避免调用已标记为过时的API。
• API34适配异常：确认主题中windowLayoutInDisplayCutoutMode设为shortEdges，确保内容可以延伸至刘海/挖孔区域，避免出现黑边。

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