Android系统状态栏定制-六虎

背景

项目中为了适应产品形状需求对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"
        ...
        <!-- 左边显现区域 全体权重只占了1-->
        <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"
                 />
                <!-- 运用告诉icon区域 -->
                <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:orientation="horizontal"
                    android:clipChildren="false"/>
            </LinearLayout>
        </FrameLayout>
        ...
        <!-- 中间icon显现区域 -->
        <com.android.systemui.statusbar.AlphaOptimizedFrameLayout
            android:id="@+id/centered_icon_area"
            android:layout_width="wrap_content"
            android:layout_height="match_parent"
            android:orientation="horizontal"
            android:clipChildren="false"
            android:gravity="center_horizontal|center_vertical"/>
        <!-- 体系icon显现区域-->
        <com.android.keyguard.AlphaOptimizedLinearLayout android:id="@+id/system_icon_area"
            android:layout_width="0dp"
            android:layout_height="match_parent"
            android:layout_weight="1"
            android:orientation="horizontal"
            android:gravity="center_vertical|end"
            >
            <!-- 体系icon实践显现布局 -->
            <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一致，倒是宽度却坚持了原有图标宽，导致显现布局不对。

Android系统状态栏定制

背景

状况栏是什么？

体系ICON布局

StatusIconContainer — onMeasure

StatusIconContainer –onLayout

StatusIconContainer — onDraw

状况栏图标显现逻辑操控

要害view办理

图标怎么更新？

怎么定制？

留意事项：

相关文章

Kotlin | 利用扩展函数转换对象的一个小技巧

Android 图片裁剪

聊一聊Kotlin之contract

【HTTP协议】HTTP协议初体验，深入浅出网络协议

作者信息