Android 沉浸式状态栏完美解决方案

最新推荐文章于 2024-09-27 21:46:09 发布

code_dream_wq

最新推荐文章于 2024-09-27 21:46:09 发布

阅读量1.6k

点赞数 4

分类专栏： android第三方库

本文链接：https://blog.csdn.net/code_dream_wq/article/details/85336715

版权

android第三方库专栏收录该内容

30 篇文章 2 订阅

订阅专栏

https://blog.csdn.net/u014418171/article/details/81223681

源码：https://gitee.com/code_q/MyStatusBarColor

版权声明：本文为博主原创文章，转载请注明出处。 https://blog.csdn.net/u014418171/article/details/81223681
注明下,这里只讲状态栏,导航栏后面看有没有必要再讲
国内很多类似的文章, 我只想说一个字, 真tm乱! 我看不懂… 评论里面全在说无效什么的 (我试了也无效, 好厉害的样子)

不废话,回到正题, 首先贴上一个众所周知的库 SystemBarTint
我只要这个类
https://github.com/jgilfelt/SystemBarTint/blob/master/library/src/com/readystatesoftware/systembartint/SystemBarTintManager.java
然后复制到你的工程

这个类我就不多说了, 就是兼容4.x以上沉浸透明状态栏的一个兼容类, 有空可以研究下
#开始
先贴工具类, 有部分代码参考自网上并有做改动, 但这,不重要…

public class StatusBarUtil {
public final static int TYPE_MIUI = 0;
public final static int TYPE_FLYME = 1;
public final static int TYPE_M = 3;//6.0

@IntDef({TYPE_MIUI,
TYPE_FLYME,
TYPE_M})
@Retention(RetentionPolicy.SOURCE)
@interface ViewType {
}

/**
* 修改状态栏颜色，支持4.4以上版本
*
* @param colorId 颜色
*/
public static void setStatusBarColor(Activity activity, int colorId) {

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
Window window = activity.getWindow();
window.setStatusBarColor(colorId);
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
//使用SystemBarTintManager,需要先将状态栏设置为透明
setTranslucentStatus(activity);
SystemBarTintManager systemBarTintManager = new SystemBarTintManager(activity);
systemBarTintManager.setStatusBarTintEnabled(true);//显示状态栏
systemBarTintManager.setStatusBarTintColor(colorId);//设置状态栏颜色
}
}

/**
* 设置状态栏透明
*/
@TargetApi(19)
public static void setTranslucentStatus(Activity activity) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
//5.x开始需要把颜色设置透明，否则导航栏会呈现系统默认的浅灰色
Window window = activity.getWindow();
View decorView = window.getDecorView();
//两个 flag 要结合使用，表示让应用的主体内容占用系统状态栏的空间
int option = View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN
| View.SYSTEM_UI_FLAG_LAYOUT_STABLE;
decorView.setSystemUiVisibility(option);
window.addFlags(WindowManager.LayoutParams.FLAG_DRAWS_SYSTEM_BAR_BACKGROUNDS);
window.setStatusBarColor(Color.TRANSPARENT);
//导航栏颜色也可以正常设置
//window.setNavigationBarColor(Color.TRANSPARENT);
} else if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
Window window = activity.getWindow();
WindowManager.LayoutParams attributes = window.getAttributes();
int flagTranslucentStatus = WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS;
attributes.flags |= flagTranslucentStatus;
//int flagTranslucentNavigation = WindowManager.LayoutParams.FLAG_TRANSLUCENT_NAVIGATION;
//attributes.flags |= flagTranslucentNavigation;
window.setAttributes(attributes);
}
}

/**
* 代码实现android:fitsSystemWindows
*
* @param activity
*/
public static void setRootViewFitsSystemWindows(Activity activity, boolean fitSystemWindows) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
ViewGroup winContent = (ViewGroup) activity.findViewById(android.R.id.content);
if (winContent.getChildCount() > 0) {
ViewGroup rootView = (ViewGroup) winContent.getChildAt(0);
if (rootView != null) {
rootView.setFitsSystemWindows(fitSystemWindows);
}
}
}

}

/**
* 设置状态栏深色浅色切换
*/
public static boolean setStatusBarDarkTheme(Activity activity, boolean dark) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
setStatusBarFontIconDark(activity, TYPE_M, dark);
} else if (OSUtils.isMiui()) {
setStatusBarFontIconDark(activity, TYPE_MIUI, dark);
} else if (OSUtils.isFlyme()) {
setStatusBarFontIconDark(activity, TYPE_FLYME, dark);
} else {//其他情况
return false;
}

return true;
}
return false;
}

/**
* 设置状态栏深色浅色切换
*/
public static boolean setStatusBarFontIconDark(Activity activity, @ViewType int type,boolean dark) {
switch (type) {
case TYPE_MIUI:
return setMiuiUI(activity, dark);
case TYPE_FLYME:
return setFlymeUI(activity, dark);
case TYPE_M:
default:
return setCommonUI(activity,dark);
}
}

//设置6.0 状态栏深色浅色切换
public static boolean setCommonUI(Activity activity, boolean dark) {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
View decorView = activity.getWindow().getDecorView();
if (decorView != null) {
int vis = decorView.getSystemUiVisibility();
if (dark) {
vis |= View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR;
} else {
vis &= ~View.SYSTEM_UI_FLAG_LIGHT_STATUS_BAR;
}
if (decorView.getSystemUiVisibility() != vis) {
decorView.setSystemUiVisibility(vis);
}
return true;
}
}
return false;

}

//设置Flyme 状态栏深色浅色切换
public static boolean setFlymeUI(Activity activity, boolean dark) {
try {
Window window = activity.getWindow();
WindowManager.LayoutParams lp = window.getAttributes();
Field darkFlag = WindowManager.LayoutParams.class.getDeclaredField("MEIZU_FLAG_DARK_STATUS_BAR_ICON");
Field meizuFlags = WindowManager.LayoutParams.class.getDeclaredField("meizuFlags");
darkFlag.setAccessible(true);
meizuFlags.setAccessible(true);
int bit = darkFlag.getInt(null);
int value = meizuFlags.getInt(lp);
if (dark) {
value |= bit;
} else {
value &= ~bit;
}
meizuFlags.setInt(lp, value);
window.setAttributes(lp);
return true;
} catch (Exception e) {
e.printStackTrace();
return false;
}
}

//设置MIUI 状态栏深色浅色切换
public static boolean setMiuiUI(Activity activity, boolean dark) {
try {
Window window = activity.getWindow();
Class<?> clazz = activity.getWindow().getClass();
@SuppressLint("PrivateApi") Class<?> layoutParams = Class.forName("android.view.MiuiWindowManager$LayoutParams");
Field field = layoutParams.getField("EXTRA_FLAG_STATUS_BAR_DARK_MODE");
int darkModeFlag = field.getInt(layoutParams);
Method extraFlagField = clazz.getDeclaredMethod("setExtraFlags", int.class, int.class);
extraFlagField.setAccessible(true);
if (dark) { //状态栏亮色且黑色字体
extraFlagField.invoke(window, darkModeFlag, darkModeFlag);
} else {
extraFlagField.invoke(window, 0, darkModeFlag);
}
return true;
} catch (Exception e) {
e.printStackTrace();
return false;
}
}
//获取状态栏高度
public static int getStatusBarHeight(Context context) {
int result = 0;
int resourceId = context.getResources().getIdentifier(
"status_bar_height", "dimen", "android");
if (resourceId > 0) {
result = context.getResources().getDimensionPixelSize(resourceId);
}
return result;
}
}

好了,这个类支持了设置状态栏透明, 设置状态栏颜色, 支持了状态栏深色浅色切换(则状态栏上的文字图标颜色)

停!
如果你在看这篇文章, 先不要看别的文章 (23333…) .因为可能会扰乱你的思路,导致你无法理解和使用, 并且你乱入的代码会干扰这边的代码正常工作, 先删掉你在别的文章的代码修改, 相信我, 我这边啥都不用做, 你绝对能以最简单的方式让你的项目实现沉浸状态栏兼容~ 包括图片沉浸!

前期准备:
我就怕你搞了一堆在别的文章的配置,所以我还是要说下以下代码不能出现:
全局搜索你的代码里是否有 android:fitsSystemWindows , 删掉!, 没错删掉!!!
检查你的values、values-v19、values-v21等是否配置了
如下item标签

// values-v19。v19 开始有 android:windowTranslucentStatus 这个属性
<style name="TranslucentTheme" parent="Theme.AppCompat.Light.NoActionBar">
<item name="android:windowTranslucentStatus">true</item>
<item name="android:windowTranslucentNavigation">true</item>
</style>

// values-v21。5.0 以上提供了 setStatusBarColor() 方法设置状态栏颜色。
<style name="TranslucentTheme" parent="Theme.AppCompat.Light.NoActionBar">
<item name="android:windowTranslucentStatus">false</item>
<item name="android:windowTranslucentNavigation">true</item>

<item name="android:statusBarColor">@android:color/transparent</item>
</style>

凡是在style.xml中有关 windowTranslucentNavigation、windowTranslucentStatus、statusBarColor 统统删掉,全部删掉~
因为我们要通过代码去实现, xml中的各种属性全部不要写, 避免代码出现互相干扰, 会出现各种为啥啊无效啊的bug

这里我要吐槽一下, 我浏览过很多文章博客, 关于状态栏适配, 一会儿在java 设置setFitsSystemWindows setStatusBarColor 一会儿又回到布局里设置 android:fitsSystemWindows=“xxx” ,一会儿在style 配置 android:windowTranslucentStatus等一会儿又使用工具类设置FLAG_TRANSLUCENT_NAVIGATION …,然后还什么4.4 5.x各一份 style ,甚至还拿colorPrimary来乱入一通, 搞得是真的乱! 不信你看完我写的之后再去看别的, 有的说的不全比如漏了图片如何沉浸没讲 , 或者是漏了图片沉浸后布局也跟着沉浸进状态栏如何解决没讲… 唉…

好了干扰已全部去除,开始适配

首先在Activity 的setContentView 下一行编写如下代码(一般你可以写到你的BaseActivity里,否则你每个activity都得写一次)

@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.xxx);
//当FitsSystemWindows设置 true 时，会在屏幕最上方预留出状态栏高度的 padding
StatusBarUtil.setRootViewFitsSystemWindows(this,true);
//设置状态栏透明
StatusBarUtil.setTranslucentStatus(this);
//一般的手机的状态栏文字和图标都是白色的, 可如果你的应用也是纯白色的, 或导致状态栏文字看不清
//所以如果你是这种情况,请使用以下代码, 设置状态使用深色文字图标风格, 否则你可以选择性注释掉这个if内容
if (!StatusBarUtil.setStatusBarDarkTheme(this, true)) {
//如果不支持设置深色风格为了兼容总不能让状态栏白白的看不清, 于是设置一个状态栏颜色为半透明,
//这样半透明+白=灰, 状态栏的文字能看得清
StatusBarUtil.setStatusBarColor(this,0x55000000);
}
}

上面先这样由于界面风格很多, 比如同一个app有的界面是黑色风格的页面, 有的是白色风格的页面,有的是顶部是图片的界面希望沉浸进去这样更好看, 同时此时状态栏文字要跟随改变

其实都不用我解释了就按自己需求配置呗,工具类都写好功能了.
比如我这个 4个不同的fragment,有一个是白色, 另外两个是顶部是图片的
我是这样切换状态栏文字深浅色的,你们参考下
0界面设置状态栏黑色图标

123界面设置状态栏白色图标

代码:

你还可以随时使用
StatusBarUtil.setStatusBarColor(this,颜色值);
设置不同fragment时的状态栏颜色

至此你明白了设置状态栏颜色和随界面切换时该怎么改状态栏颜色或状态栏文字颜色, 没错,你没有漏看! 用了我这个你不需要在xml中或style中设置各种属性, 也不用判断什么4.4 啊 5.0 啊 6.0啊怎么处理… 就是这么神奇!~

现在来一个蛋疼的问题

我要把图片也沉浸进去!!!
通常你使用我刚才的代码时相同颜色的界面没啥问题,比如:

但当你界面顶部是图片界面的时候或者标题颜色不一样时
成了这鬼样子,

这是因为我前面设置了 setRootViewFitsSystemWindows(this,true); 于是带有 paddingTop=状态栏高度的效果

首先你可以选择两种应对办法
如果顶部不是图片布局 , 可以直接使用 setStatusBarColor 设置相同颜色即可
如果顶部是图片布局, 那么问题来了
这里注意了

想要图片沉浸, 必须设置fitsSystemWindows=false, 以去掉padding效果, 然后想办法把图片上层的其他View 整体 paddingTop=状态栏高让其他View向下挪动
这句话一定要理解
,现在试试在当前带图片的activity 重新设置setRootViewFitsSystemWindows(this,false);
效果如下(你会发现图标跑左边了, 请无视, 将就看,我是在现有项目中演示的 )
去掉padding效果后图片沉浸了! 但内容进入了状态栏里被遮挡.

那, 怎么以最方便的方式让整个内容布局往下挪动?

有很多教程都是写的是在代码里 findView 然后设置padding , 很是麻烦, 要是多个界面都这样代码岂止乱?
曾经试图在xml中使用状态栏高度值 ,结果发现这是几乎是不可能的, 因为编译后 xml固定了值,除非使用反射, 但这到了安卓9.0不能反射系统api怎么办…
于是我想出了一种解决办法

自定义一个View ,用来做状态栏高度占位

/**
* 作者:东芝
* 功能:状态栏高度View,用于沉浸占位
*/

public class StatusBarHeightView extends LinearLayout {
private int statusBarHeight;
private int type;

public StatusBarHeightView(Context context, @Nullable AttributeSet attrs) {
super(context, attrs);
init(attrs);
}

public StatusBarHeightView(Context context, @Nullable AttributeSet attrs, int defStyleAttr) {
super(context, attrs, defStyleAttr);
init(attrs);
}

public StatusBarHeightView(Context context, @Nullable AttributeSet attrs, int defStyleAttr, int defStyleRes) {
super(context, attrs, defStyleAttr);
init(attrs);

}

private void init(@Nullable AttributeSet attrs) {

int resourceId = getResources().getIdentifier("status_bar_height", "dimen", "android");
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
if(resourceId>0) {
statusBarHeight = getResources().getDimensionPixelSize(resourceId);
}
}else{
//低版本直接设置0
statusBarHeight = 0;
}
if (attrs != null) {
TypedArray typedArray = getContext().obtainStyledAttributes(attrs, R.styleable.StatusBarHeightView);
type = typedArray.getInt(R.styleable.StatusBarHeightView_use_type, 0);
typedArray.recycle();
}
if (type == 1) {
setPadding(getPaddingLeft(), statusBarHeight, getPaddingRight(), getPaddingBottom());
}
}

@Override
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
if (type == 0) {
setMeasuredDimension(getDefaultSize(getSuggestedMinimumWidth(), widthMeasureSpec),
statusBarHeight);
} else {
super.onMeasure(widthMeasureSpec, heightMeasureSpec);
}
}

}

attrs.xml

<declare-styleable name="StatusBarHeightView">
<attr name="use_type" format="integer">
<enum name="use_height" value="0" />
<enum name="use_padding_top" value="1" />
</attr>
</declare-styleable>

代码很简单, 就是写一个View, 支持paddingTop= 状态栏高度值的View,
解释下两个类型:
use_height: 设置当前布局高度=状态栏高度值用于无子View时的占位
use_padding_top: 设置当前顶部padding=状态栏高度值用于有子View时的占位
适配低于4.4时占位View的高度为0 所以不可见

使用方法, 用StatusBarHeightView 来包住你要往下移动的内容! 单独留出要沉浸的View不包住,
举例:

<RelativeLayout 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:layout_width="match_parent"
android:layout_height="match_parent"
>

<ImageView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:background="@mipmap/icon_top_bg"
android:scaleType="centerCrop" />


   <com.xxx.views.StatusBarHeightView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentEnd="true"
android:layout_marginEnd="@dimen/widget_size_5"
app:use_type="use_padding_top"
android:orientation="vertical" >
       
<ImageView
android:id="@+id/ivUserShare"
android:layout_width="@dimen/title_height"
android:layout_height="@dimen/title_height"
android:padding="@dimen/widget_size_10"
android:src="@mipmap/icon_share_white" />

   </com.xxx.views.StatusBarHeightView>
</RelativeLayout>

//不要忘记了, 在当前activity onCreate中设置取消padding, 因为这个padding 我们用代码实现了,不需要系统帮我
StatusBarUtil.setRootViewFitsSystemWindows(this,false);
1
2
java 代码这边不需要改动, 运行app即可.
完美!

结束
值得注意的是如果你按我那样去做, 状态栏颜色无法被修改, 请检查上层布局是否设置了背景
或者受了全局主题的

<item name="android:windowBackground">@color/xxx</item>
1
的颜色影响

好了,可能有不对的地方望指出, 或出现任何兼容性适配问题欢迎在下方评论

关于兼容性
该功能已通过大量真机测试, 低版本4.1到安卓9.0 的手机均未出现状态栏错位,颜色重叠显示不清,等问题,而且 app发布到国内外均未反映关于这个状态栏适配方案导致的bug 或其他问题, 可放心食用. 至于有一些文章说到侧滑布局 DrawerLayout 需要特殊处理… 放心, 本文的兼容方案是获取activity 根层布局来处理实现兼容的, 与activity里面是什么布局无关.

================================================================

补充:
================================================================

================================================================

感谢@Narbolo 的提醒, 漏了个Rom类型判断的工具类,现在贴上

public class OSUtils {

public static final String ROM_MIUI = "MIUI";
public static final String ROM_EMUI = "EMUI";
public static final String ROM_FLYME = "FLYME";
public static final String ROM_OPPO = "OPPO";
public static final String ROM_SMARTISAN = "SMARTISAN";
public static final String ROM_VIVO = "VIVO";
public static final String ROM_QIKU = "QIKU";

private static final String KEY_VERSION_MIUI = "ro.miui.ui.version.name";
private static final String KEY_VERSION_EMUI = "ro.build.version.emui";
private static final String KEY_VERSION_OPPO = "ro.build.version.opporom";
private static final String KEY_VERSION_SMARTISAN = "ro.smartisan.version";
private static final String KEY_VERSION_VIVO = "ro.vivo.os.version";

private static String sName;
private static String sVersion;

public static boolean isEmui() {
return check(ROM_EMUI);
}

public static boolean isMiui() {
return check(ROM_MIUI);
}

public static boolean isVivo() {
return check(ROM_VIVO);
}

public static boolean isOppo() {
return check(ROM_OPPO);
}

public static boolean isFlyme() {
return check(ROM_FLYME);
}

public static boolean is360() {
return check(ROM_QIKU) || check("360");
}

public static boolean isSmartisan() {
return check(ROM_SMARTISAN);
}

public static String getName() {
if (sName == null) {
check("");
}
return sName;
}

public static String getVersion() {
if (sVersion == null) {
check("");
}
return sVersion;
}

public static boolean check(String rom) {
if (sName != null) {
return sName.equals(rom);
}

if (!TextUtils.isEmpty(sVersion = getProp(KEY_VERSION_MIUI))) {
sName = ROM_MIUI;
} else if (!TextUtils.isEmpty(sVersion = getProp(KEY_VERSION_EMUI))) {
sName = ROM_EMUI;
} else if (!TextUtils.isEmpty(sVersion = getProp(KEY_VERSION_OPPO))) {
sName = ROM_OPPO;
} else if (!TextUtils.isEmpty(sVersion = getProp(KEY_VERSION_VIVO))) {
sName = ROM_VIVO;
} else if (!TextUtils.isEmpty(sVersion = getProp(KEY_VERSION_SMARTISAN))) {
sName = ROM_SMARTISAN;
} else {
sVersion = Build.DISPLAY;
if (sVersion.toUpperCase().contains(ROM_FLYME)) {
sName = ROM_FLYME;
} else {
sVersion = Build.UNKNOWN;
sName = Build.MANUFACTURER.toUpperCase();
}
}
return sName.equals(rom);
}

public static String getProp(String name) {
String line = null;
BufferedReader input = null;
try {
Process p = Runtime.getRuntime().exec("getprop " + name);
input = new BufferedReader(new InputStreamReader(p.getInputStream()), 1024);
line = input.readLine();
input.close();
} catch (IOException ex) {
return null;
} finally {
if (input != null) {
try {
input.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
return line;
}
}