Android中FLAG_TRANSLUCENT_STATUS标记已过时的修复方案及动态更新状态栏问题解决

Hey，我来帮你搞定这个过时警告的问题！从Android 10（API 29）开始，FLAG_TRANSLUCENT_STATUS就被官方标记为过时了，取而代之的是更灵活的系统栏控制方案，下面分情况给你讲清楚怎么适配：

一、核心适配思路 #

• 对于Android 10及以上版本，官方推荐使用WindowInsetsController来控制状态栏的显示、透明度以及图标颜色；同时可以用setDecorFitsSystemWindows(false)来实现布局延伸到状态栏下方的沉浸式效果。
• 如果你只是单纯想修改状态栏颜色，其实在API 21+的设备上，直接调用setStatusBarColor就足够，旧的FLAG处理可以针对低版本保留，高版本跳过即可。

二、修改你的现有代码 #

你的原有代码在API 21-28上运行没问题，但在API 29+会触发过时警告，我们可以通过版本区分来优化：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
    
    // 仅在Android 10以下版本清除过时标记，避免警告
    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.Q) {
        getWindow().clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
    }
    
    // 统一设置状态栏颜色，API 21+都支持
    getWindow().setStatusBarColor(ContextCompat.getColor(this, color));
}

三、不同场景的完整适配方案 #

1. 仅修改状态栏颜色（无沉浸式需求） #

如果不需要布局延伸到状态栏下方，只需要改颜色，上面的代码就足够了。这样既兼容了旧版本，又在高版本避免了过时警告。

2. 实现沉浸式状态栏（布局延伸到状态栏） #

如果需要让页面内容延伸到状态栏下方，就需要结合setDecorFitsSystemWindows(false)和状态栏图标颜色控制，适配不同版本：

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
    // 让布局延伸到系统栏下方
    getWindow().setDecorFitsSystemWindows(false);
    getWindow().addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
    getWindow().setStatusBarColor(ContextCompat.getColor(this, color));
    
    // 根据状态栏颜色设置图标明暗，确保可读性
    boolean isLightColor = isColorLight(ContextCompat.getColor(this, color));
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R) {
        // Android 11及以上，用InsetsController
        WindowInsetsController insetsController = getWindow().getInsetsController();
        if (insetsController != null) {
            insetsController.setSystemBarsAppearance(
                isLightColor ? WindowInsetsController.APPEARANCE_LIGHT_STATUS_BARS : 0,
                WindowInsetsController.APPEARANCE_LIGHT_STATUS_BARS
            );
        }
    } else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
        // Android 6-10，用旧的SystemUiVisibility
        getWindow().getDecorView().setSystemUiVisibility(
            isLightColor ? View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR : 0
        );
    }
}

// 辅助方法：判断颜色是否为浅色
private boolean isColorLight(int color) {
    double darkness = 1 - (0.299 * Color.red(color) + 0.587 * Color.green(color) + 0.114 * Color.blue(color)) / 255;
    return darkness < 0.5;
}

四、额外提示 #

• 如果你的项目使用了Jetpack Compose，还可以用systemBarsPadding()或者WindowInsets相关API来更方便地处理系统栏适配。
• 记得在AndroidManifest.xml中给Activity设置android:windowTranslucentStatus=false（如果之前设置过的话），避免和代码逻辑冲突。

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