Android体系状态栏定制

程序员 · 2024-9-15 08:46:39

配景

项目中为了顺应产物形态须要对Android体系状态栏体系图标以及时钟和电池等做客制化，满足差异用户群体的视觉特性，那在定制过程中须要留意哪些事项？图标icon是否可以恣意巨细？状态栏多颜色模式下图标如何适配？复杂状态图标如何调解逻辑？
状态栏是什么？

起首来看下状态栏载体是什么？状态栏本质着实就是一个悬浮窗，在systemui初始化时创建体现。SystemUI/src/com/android/systemui/statusbar/phone/StatusBar.java
protected void inflateStatusBarWindow(Context context) { mStatusBarWindow = (StatusBarWindowView) mInjectionInflater.injectable(          LayoutInflater.from(context)).inflate(R.layout.super_status_bar, null);}由上可知状态栏就是使用super_status_bar.xml结构创建的一个悬浮窗。而这个结构包罗了状态栏全部内容，应用关照，体系图标，时钟等。其主体内容如下
<com.android.systemui.statusbar.phone.StatusBarWindowView ... <FrameLayout       android:id="@+id/status_bar_container"       android:layout_width="match_parent"       android:layout_height="wrap_content" /> ...</com.android.systemui.statusbar.phone.StatusBarWindowView>此中包罗status_bar_container 的framelayout的容器即为状态栏的view，在代码中通过fragmentmanager更换了了这个container。
protected void makeStatusBarView(@Nullable RegisterStatusBarResult result) {       ...       FragmentHostManager.get(mStatusBarWindow)             .addTagListener(...).getFragmentManager()             .beginTransaction()             .replace(R.id.status_bar_container, new CollapsedStatusBarFragment(),                      CollapsedStatusBarFragment.TAG)             .commit();而CollapsedStatusBarFragment的实现就是加载了status_bar.xml 这个结构。
@Override public View onCreateView(LayoutInflater inflater, @Nullable ViewGroup container,          Bundle savedInstanceState) {       return inflater.inflate(R.layout.status_bar, container, false); }status_bar.xml 结构内容就是体现出来的状态栏结构。如许状态栏整体结构就比力清楚，包罗了应用关照，体系图标, 时钟，电池等。
<com.android.systemui.statusbar.phone.PhoneStatusBarView ... android:layout_height="@dimen/status_bar_height" android:id="@+id/status_bar" ... > ... <LinearLayout android:id="@+id/status_bar_contents"       ...              <FrameLayout          android:layout_height="match_parent"          android:layout_width="0dp"          android:layout_weight="1">          ...          <LinearLayout             android:id="@+id/status_bar_left_side"             ...                            >                          <com.android.systemui.statusbar.policy.Clock                   android:id="@+id/clock"                   ...                   android:textAppearance="@style/TextAppearance.StatusBar.Clock"                />                          <com.android.systemui.statusbar.AlphaOptimizedFrameLayout                   android:id="@+id/notification_icon_area"                   android:layout_width="0dp"                   android:layout_height="match_parent"                   android:layout_weight="1"                   android

rientation="horizontal" android:clipChildren="false"/> </LinearLayout> </FrameLayout> ...  <com.android.systemui.statusbar.AlphaOptimizedFrameLayout android:id="@+id/centered_icon_area" android:layout_width="wrap_content" android:layout_height="match_parent" android

rientation="horizontal" android:clipChildren="false" android:gravity="center_horizontal|center_vertical"/>  <com.android.keyguard.AlphaOptimizedLinearLayout android:id="@+id/system_icon_area" android:layout_width="0dp" android:layout_height="match_parent" android:layout_weight="1" android

rientation="horizontal" android:gravity="center_vertical|end" >  <include layout="@layout/system_icons" /> </com.android.keyguard.AlphaOptimizedLinearLayout> </LinearLayout>...</com.android.systemui.statusbar.phone.PhoneStatusBarView>体系icon地区 system_icons.xml
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" xmlns:systemui="http://schemas.android.com/apk/res-auto" android:id="@+id/system_icons" ...> <com.android.systemui.statusbar.phone.StatusIconContainer android:id="@+id/statusIcons" android:layout_width="0dp" android:layout_weight="1" .../> <com.android.systemui.statusbar.phone.seewo.BatteryImageView android:id="@+id/battery" .../></LinearLayout>整个状态栏整体结构表示如下：

此中我们须要定制的从UI筹划稿中可以看出，是三个地区，时钟，体系icon，电池，应用关照在这个项目中不须要，可以直接去掉关照信息功能，就不会体现出来。clock和battery都是自界说控件，比力优点置惩罚。重点看下体系icon实现。
体系ICON结构

由上客制体系图标地区包罗一个statusIcons 的容器view，尚有battery 体现view。
其结构也是自界说view, StatusIconContainer.java
<com.android.systemui.statusbar.phone.StatusIconContainer android:id="@+id/statusIcons"       android:layout_width="0dp"       .../>着实现是基于AlphaOptimizedLinearLayout结构实现的一个自界说结构。AlphaOptimizedLinearLayout是继续自LinearLayout只是覆盖了
public boolean hasOverlappingRendering() {    return false;  }该方法用来标记当前view是否存在太过绘制，存在返回ture，不存在返回false，默认返回为true。在android的View里有透明度的属性，当设置透明度setAlpha的时间，android里默认会把当前view绘制到offscreen buffer中，然后再体现出来。这个offscreen buffer 可以理解为一个暂时缓冲区，把当前View放进来并做透明度的转化，然后在体现到屏幕上。这个过程是斲丧资源的，以是应该只管制止这个过程。而当继续了hasOverlappingRendering()方法返回false后，android会自动举行公道的优化，制止使用offscreen buffer。
体系icon绘制流程会比力多。先从顶层view StatusIconContainer的绘制来分析。view的绘制离不开三个步调，onMeasure, onLayout, onDraw，如今来一一拆解检察。
StatusIconContainer -- onMeasure

protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {       // 获取到全部须要展示的view，留意看不可见的，icon处于blocked状态的，       // 尚有须要忽略的都不会被参加mMeasureViews中       for (int i = 0; i < count; i++) {          StatusIconDisplayable icon = (StatusIconDisplayable) getChildAt(i);          if (icon.isIconVisible() && !icon.isIconBlocked()                   && !mIgnoredSlots.contains(icon.getSlot())) {             mMeasureViews.add((View) icon);          }       }       int visibleCount = mMeasureViews.size();       //  计算最大可见的icon数量，默以为7       int maxVisible = visibleCount <= MAX_ICONS ? MAX_ICONS : MAX_ICONS - 1;       int totalWidth = mPaddingLeft + mPaddingRight;       boolean trackWidth = true;       int childWidthSpec = MeasureSpec.makeMeasureSpec(width, MeasureSpec.UNSPECIFIED);       mNeedsUnderflow = mShouldRestrictIcons && visibleCount > MAX_ICONS;       for (int i = 0; i < mMeasureViews.size(); i++) {          // Walking backwards          View child = mMeasureViews.get(visibleCount - i - 1);          //丈量每个childview的宽          measureChild(child, childWidthSpec, heightMeasureSpec);          if (mShouldRestrictIcons) {             // 计算总的宽度             if (i < maxVisible && trackWidth) {                   totalWidth += getViewTotalMeasuredWidth(child);             } else if (trackWidth) {                   // 高出最大可见数量时须要给省略点计算空间。                   totalWidth += mUnderflowWidth;                   trackWidth = false;             }          } else {             totalWidth += getViewTotalMeasuredWidth(child);          }       }       // 通过setMeasuredDimension设置view的宽高       if (mode == MeasureSpec.EXACTLY) {          ...          setMeasuredDimension(width, MeasureSpec.getSize(heightMeasureSpec));       } else {          ...          setMeasuredDimension(totalWidth, MeasureSpec.getSize(heightMeasureSpec));       } }从上面可以看出来， onMeaure紧张时计算每个子view的宽高，并计算出父view的整的宽度，此中会给高出最大数量的环境下计算省略点的宽度，可以视项目环境来决定这个省略点的数量，其可在代码中通过常量来自界说。
StatusIconContainer -- onLayout

protected void onLayout(boolean changed, int l, int t, int r, int b) {       float midY = getHeight() / 2.0f;       for (int i = 0; i < getChildCount(); i++) {          View child = getChildAt(i);          int width = child.getMeasuredWidth();          int height = child.getMeasuredHeight();          int top = (int) (midY - height / 2.0f);          child.layout(0, top, width, top + height);       }       // 重置每个view的状态。通过StatusIconState重置状态       resetViewStates();       // 重新依据实际环境计算每个icon的表近况态，下面单独拎出来讲。       calculateIconTranslations();       // 应用view的状态，包罗icon体现的动画。       applyIconStates(); }onLayou通例是计算每个view的宽高，并按预定的规则排放，然后计算每个view的位置。calculateIconTranslations体现逻辑会比力多，单独拎出来讲：
private void calculateIconTranslations() {       mLayoutStates.clear();       ...       //       for (int i = childCount - 1; i >= 0; i--) {          View child = getChildAt(i);          StatusIconDisplayable iconView = (StatusIconDisplayable) child;          StatusIconState childState = getViewStateFromChild(child);          if (!iconView.isIconVisible() || iconView.isIconBlocked()                   || mIgnoredSlots.contains(iconView.getSlot())) {             childState.visibleState = STATE_HIDDEN;             if (DEBUG) Log.d(TAG, "skipping child (" + iconView.getSlot() + ") not visible");             continue;          }          childState.visibleState = STATE_ICON;          // 位置体现的关键点， translationX 初始值是整个view的宽度，如许计算每个view          // 的实际结构位置          childState.xTranslation = translationX - getViewTotalWidth(child);          mLayoutStates.add(0, childState);          translationX -= getViewTotalWidth(child);       }       // Show either 1-MAX_ICONS icons, or (MAX_ICONS - 1) icons + overflow       int totalVisible = mLayoutStates.size();       int maxVisible = totalVisible <= MAX_ICONS ? MAX_ICONS : MAX_ICONS - 1;       mUnderflowStart = 0;       int visible = 0;       int firstUnderflowIndex = -1;       for (int i = totalVisible - 1; i >= 0; i--) {          StatusIconState state = mLayoutStates.get(i);          // Allow room for underflow if we found we need it in onMeasure          // 这里比力关键从列表中逆序获取到每个view的位置，如果view的xTranslation 下雨          // 小于体现的内容就克制，后续就从这个index开始绘制          if (mNeedsUnderflow && (state.xTranslation < (contentStart + mUnderflowWidth))||                   (mShouldRestrictIcons && visible >= maxVisible)) {             firstUnderflowIndex = i;             break;          }          mUnderflowStart = (int) Math.max(contentStart, state.xTranslation - mUnderflowWidth);          visible++;       }       //后续逻辑就是设置是否体现icon和体现多少个dot       ... }onLayout逻辑较多，简单来说就是通过每个子view的xTranslation和整体的view空间，计算须要体现多少icon，同时要给省略点预留空间。简单表示如下。大概高出空间的就用dot来体现。

StatusIconContainer -- onDraw

这块没有定制处置惩罚，只是做了debug的一些信息绘制.
至此体系icon的顶层view分析完成，其紧张是通过子view的状态以及父view的空间等环境来决定是否须要体现哪些icon，以及体现省略点符号。接下来再看每个子view的环境。
子view就是表近况态栏上icon，但是其封装了一层继续自AnimatedImageView，动员画结果的ImageView。子view的具体实现 StatusBarIconView
SystemUI/src/com/android/systemui/statusbar/phone/StatusBarIconView.java
挑此中重点剖析。图片的缩放，怎么把恣意图片的巨细得当在状态栏体现。
private void updateIconScaleForSystemIcons() {       float iconHeight = getIconHeight();       if (iconHeight != 0) {          mIconScale = mSystemIconDesiredHeight / iconHeight;       } else {          mIconScale = mSystemIconDefaultScale;       } }先获取到mIconScale须要缩放的比例，mSystemIconDesiredHeight 是设置的全局的system icon的巨细。
      mSystemIconDesiredHeight = res.getDimension(             com.android.internal.R.dimen.status_bar_system_icon_size);存在icon的环境下，通过获取实际的icon的巨细，计算出 mIconScale.
在onDraw的时间通过canvas.scale 把画布以icon的中央点根据mIconScale缩放到system_icon_size. 但是如许存在一个标题，icon的实际巨细照旧原巨细，只是体现小了。其它部门包罗动画就不再细讲。
@Override protected void onDraw(Canvas canvas) {       if (mIconAppearAmount > 0.0f) {          canvas.save();          canvas.scale(mIconScale * mIconAppearAmount, mIconScale * mIconAppearAmount,                   getWidth() / 2, getHeight() / 2);          super.onDraw(canvas);          canvas.restore();       }       ... }到这里状态栏结构以及体系图标的view绘制大要分析完成。接下来看icon是怎么控制添加，删除以及更新的。
状态栏图标体现逻辑控制

状态栏图标体现逻辑是通过 StatusBarIconControllerImpl 这个类来实现管理，在对象构造的时间默认初始化
public StatusBarIconControllerImpl(Context context) {       super(context.getResources().getStringArray(             com.android.internal.R.array.config_statusBarIcons)); ... }config_statusBarIcons 这个array中包罗了全部支持的icon。如有须要定制图标次序可在这个列表中对图标对应的item举行调解。
<string-array name="config_statusBarIcons">       <item><xliff:g id="id">@string/status_bar_alarm_clock</xliff:g></item>       ...       <item><xliff:g id="id">@string/status_bar_battery</xliff:g></item>       <item><xliff:g id="id">@string/status_bar_sensors_off</xliff:g></item> </string-array>这些 icon字串信息当做一个title信息，保存在mSlots列表中。而Slot中包罗StatusBarIconHolder:
public static class Slot {       private final String mName;       private StatusBarIconHolder mHolder;       ... }public class StatusBarIconHolder { public static final int TYPE_ICON = 0; public static final int TYPE_WIFI = 1; public static final int TYPE_MOBILE = 2; private StatusBarIcon mIcon; private WifiIconState mWifiState; private MobileIconState mMobileState;       ...}启动mIcon即为体现的图标资源保存类。此中包罗了图标表近况态，标签信息以及状态信息等。将其都保存在mSlogs的列表中，方便管理体现。
总结数据保存链条 Slots--> StatusBarIconHolder --> StatusBarIcon;
关键view管理

在状态栏初始化的时间 CollapsedStatusBarFragment 的view创建中 onViewCreated对体系icon管理举行初始化。
      mDarkIconManager = new DarkIconManager(view.findViewById(R.id.statusIcons));       mDarkIconManager.setShouldLog(true);       Dependency.get(StatusBarIconController.class).addIconGroup(mDarkIconManager);DarkIconManager 构造函数中传入了system_icon的容器viewgroup, 负责view的增长和删除。StatusBarIconController管理DarkIconManager. 如许体现图标地区控制部门与体现部门关联起来。
图标如何更新？

控制管理的实现战略类都在 PhoneStatusBarPolicy 这个内里实现。具体实现通过StatusBarIconControllerImpl类实现，可以通过如下接口更新体现图标。
mIconController.setIcon(mSlotVolume, volumeIconId, volumeDescription);mIconController.setIconVisibility(mSlotVolume, volumeVisible);以音量更新为例。setIcon流程分析。
@Override public void setIcon(String slot, int resourceId, CharSequence contentDescription) {       //  查抄是否在列表中存在holder，默认初始环境下是都没有holder的，须要新建       int index = getSlotIndex(slot);       StatusBarIconHolder holder = getIcon(index, 0);       if (holder == null) {          先通过resoureid和 contentDescription创建一个StatusBarIcon实例          StatusBarIcon icon = new StatusBarIcon(UserHandle.SYSTEM, mContext.getPackageName(),                   Icon.createWithResource(                         mContext, resourceId), 0, 0, contentDescription);          // 通过icon封装一个holder。          holder = StatusBarIconHolder.fromIcon(icon);          // 将holder赋值给mSlots          setIcon(index, holder);       } else {          holder.getIcon().icon = Icon.createWithResource(mContext, resourceId);          holder.getIcon().contentDescription = contentDescription;          handleSet(index, holder);       } }传入slot为icon的title， resourceId为资源文件，contentDescription为形貌字串。如果判定为没有holder就会新建一个holder类，并传入mSlots的列表中。
@Override public void setIcon(int index, @NonNull StatusBarIconHolder holder) {       boolean isNew = getIcon(index, holder.getTag()) == null;       super.setIcon(index, holder);       if (isNew) {          // 通过tag判定如果是新的就加到systemicon中          addSystemIcon(index, holder);       } else {          //已经存在的直接设置          handleSet(index, holder);       } } private void addSystemIcon(int index, StatusBarIconHolder holder) {       String slot = getSlotName(index);       int viewIndex = getViewIndex(index, holder.getTag());       boolean blocked = mIconBlacklist.contains(slot);       mIconGroups.forEach(l -> l.onIconAdded(viewIndex, slot, blocked, holder)); }onIconAdded是在DarkIconManager中实现。
      protected void onIconAdded(int index, String slot, boolean blocked,             StatusBarIconHolder holder) {          addHolder(index, slot, blocked, holder);       }       protected StatusIconDisplayable addHolder(int index, String slot, boolean blocked,             StatusBarIconHolder holder) {          switch (holder.getType()) {             case TYPE_ICON:                   return addIcon(index, slot, blocked, holder.getIcon());             case TYPE_WIFI:                   return addSignalIcon(index, slot, holder.getWifiState());             case TYPE_MOBILE:                   return addMobileIcon(index, slot, holder.getMobileState());          }          return null;       }       protected StatusBarIconView addIcon(int index, String slot, boolean blocked,             StatusBarIcon icon) {          StatusBarIconView view = onCreateStatusBarIconView(slot, blocked);          view.set(icon); //mGroup 即为状态栏体系图标的容器view。这里就完成了view的添加          mGroup.addView(view, index, onCreateLayoutParams());          return view;       }如许就通过setIcon把图标添加到了体系图标区，然后再通过setIconVisibility体现出图标。体现的逻辑和setIcon差不多，只是增长了visible状态，可以自行分析。更新过程中有两个特殊的图标，wifi和数据网络，其状态会包罗多个，正常都是只有体现与否逻辑，以是这里逻辑会多一些，但是原理一样的。
至此就完成了整个体系图标体现控制分析。
如何定制？

数量和次序通过设置 config_statusBarIcons 增删自己须要的图标。
状态栏巨细定制 framework/base/core/res/res/values/dimens.xml
设置项阐明status_bar_height_portrait状态栏高度status_bar_system_icon_intrinsic_size体系图标期望巨细，用于icon的缩放，和icon_size设置一样巨细即可status_bar_system_icon_size体系图标巨细SystemUI/res/values/dimens.xml
设置项阐明status_bar_padding_start状态栏离左侧空间status_bar_padding_end状态栏离右侧空间signal_cluster_battery_padding体系图标离电池图标间隔
图标体现定制通过上述分析代码 setIcon找到对应的icon举行更换自己项目标icon， StatusIconContainer中须要修改MAX_DOTS为0，不体现省略点。再onLayout的时间须要根据项目设置icon的间距， child.layout中增长r值。
体现逻辑战略都在PhoneStatusBarPhicy中实现，尤其是体系原生没有支持的图标逻辑会定制较多。

留意事项：

图标选择，使用新的svg图标时，宽高最好和体系system_icon_size设置为同等，原生逻辑会把图标缩放到高度和system_icon同等，倒是宽度却保持了原有图标宽，导致体现结构不对。

作者：SugarTurboS
链接：https://juejin.cn/post/7157878498525184013

Android体系状态栏定制

所属分类: 问答交流

新帖推荐: 30日

推荐作品