自定义状态栏系统图标

状态栏是 Android 系统 UI 的一个组件，可持续向用户显示重要信息。本页面介绍了如何自定义状态栏系统图标。如需详细了解如何叠加资源，请参阅自定义系统 UI。

Status bar

图 1. 状态栏。

特定图标的叠加层

状态栏中显示的大多数项的资源都在以下目录中提供

/platform/frameworks/base/packages/SystemUI/res/drawable

单个图标

用途 资源 含义
闹钟 stat_sys_alarm 已设置闹钟。
stat_sys_alarm_dim 设备处于禅定模式。
投射 stat_sys_cast 设备正在投射到另一台设备。
蓝牙 stat_sys_data_bluetooth 蓝牙已启用。
stat_sys_data_bluetooth_connected 至少有一台蓝牙设备已连接。
流量节省程序 stat_sys_data_saver 设备处于流量节省程序模式。
请勿打扰 stat_sys_dnd 设备处于请勿打扰模式。
以太网 stat_sys_ethernet 设备已通过以太网连接。
stat_sys_ethernet_fully
耳机 stat_sys_headset 已连接耳机。
stat_sys_headset_mic 连接的耳机带有麦克风。
热点 stat_sys_hotspot 热点处于活动状态。
stat_sys_managed_profile_status 正在管理个人资料。
响铃 stat_sys_ringer_silent 设备处于静音模式。
stat_sys_ringer_vibrate 设备处于仅振动模式。
旋转 stat_sys_rotate_landscape 屏幕处于横向模式。
stat_sys_rotate_portrait 屏幕处于纵向模式。
传感器关闭 stat_sys_sensors_off
电传打字机模式 stat_sys_tty_mode
VPN 图标 stat_sys_vpn_ic 当设备启用 VPN 且 VPN 版本为品牌 VPN 时显示。
stat_sys_branded_vpn
位置信息 perm_group_location 当位置信息请求的当前状态为活动状态时显示。
位于 platform/frameworks/base/core/res/res/drawable。

复合图标

传入和传出图标指示器 Wi-Fi和移动网络图标的传入和传出活动图标指示器相同，并且会添加到图标中显示。
ic_activity_down 指示入站活动。
ic_activity_up 指示出站活动。
Wi-Fi ic_wifi_signal_0
ic_wifi_signal_1
ic_wifi_signal_2,
ic_wifi_signal_3
ic_wifi_signal_4		 Wi-Fi 图标显示在状态栏中。
实际显示的图标取决于信号强度。
ic_wifi_signal_0 最弱，而 ic_wifi_signal_4 最强。
移动网络 移动网络图标的位置使得仅显示以下图标之一，具体取决于移动网络信号类型。
stat_sys_airplane_mode 飞行模式图标
stat_sys_roaming 漫游模式图标
ic_lte_mobiledata LTE 图标
ic_lte_plus_mobiledata LTE Plus 图标
ic_g_mobiledata GPRS 图标
ic_e_mobiledata Edge 图标
ic_h_mobiledata HSDPA 图标
ic_h_plus_mobiledata HSDPA Plus 图标
ic_3g_mobiledata 3G 图标
ic_4g_mobiledata 4G 图标
ic_4g_plus_mobiledata 4G Plus 图标
ic_5g_e_mobiledata 5G Evolution 图标
ic_5g_mobiledata 5G 图标
ic_5g_plus_mobiledata 5G Plus 图标
ic_1x_mobiledata 1X 图标

特殊图标

此配置集决定是否显示某些图标

值 说明
config_showMin3G 设置为 true 时，显示当前数据连接级别的最低图标为 3G。否则，例如，可以显示 1x。
config_alwaysUseCdmaRssi 设置为 true 时，即使在 EVDO（Evolution-Data Optimized，优化数据演进）上，接收信号强度指示器也应始终显示 CDMA 信号强度。
config_hspa_data_distinguishable 当 HSPA 数据图标要与 UMTS（通用移动通信系统）数据图标区分开来时，设置为 true。
config_inflateSignalStrength 设置为 true 可人为地将所有信号强度解释为比实际强度高一格。

运营商配置服务也使用自己的一组配置来确定是否显示某些图标。这些值与特定的 SIM 卡相关联，OEM 无法将其替换。例如

值 说明
KEY_ALWAYS_SHOW_DATA_RAT_ICON_BOOL 始终显示数据图标。
KEY_SHOW_4G_FOR_LTE_DATA_ICON_BOOL 为 LTE 显示 4G。
KEY_SHOW_4G_FOR_3G_DATA_ICON_BOOL 为 3G 显示 4G。
KEY_HIDE_LTE_PLUS_DATA_ICON_BOOL 不显示 LTE Plus。

配置图标

以下常规配置变量适用于所有状态栏系统图标

值 说明
status_bar_system_icon_size 更改系统图标的大小。
status_bar_system_icon_spacing 确定系统图标之间的间距。
config_statusBarIconBlacklist 标识状态栏中绝不应显示的系统图标。
config_statusBarIcons 确定应显示属于配置的图标的顺序。