SystemUI的实现
以StatusBar为例,来分析下Android系统具体是如何实现它们的。
相关代码分为两部分,即:
- Service部分
代码路径:frameworks/base/services/java/com/android/server。
- 应用部分
代码路径:frameworks/base/packages/SystemUI。
下面来看看SystemUI的“目录”:
…
<applicationandroid:persistent="true"android:allowClearUserData="false"
android:allowBackup="false"android:hardwareAccelerated="true"android:label="@string/app_ label" android:icon="@*android:drawable/platlogo"android:supportsRtl="true" ><service android:name="SystemUIService"android:exported="true"/>/*SystemUIService是我们分析的重点,状态栏等系统UI实现都是在这里完成的*/<service android:name=".screenshot.TakeScreenshotService"android:process=":screenshot" android:exported="false" />/*由此可知,SystemUI提供了截屏操作。有兴趣的读者可以自己研究下是如何实现的*/<receiver android:name=".BootReceiver"androidprv:primaryUserOnly="true" >/*开机自启动,不过这里启动的是LoadAverageService,而不是SystemUIService*/<intent-filter><action android:name="android.intent.action.BOOT_COMPLETED" /></intent-filter>
</receiver>
…
通过AndroidManfiest
我们知道SystemUIService
是整个系统UI的“载体”,所以接下来将根据这一线索来把整个代码流程“串”起来。和其他很多系统服务一样,SystemUIService
也是在SystemServer
中启动的。具体而言,SystemServer
会在适当的时机通知ActivityManagerService
“系统已经就绪(systemReady
),可以进一步运行第三方模块了”——这其中就包括将由startServiceAsUser
启动的SystemUIService
。
SystemUIService
继承了标准的Service
组件,因而必须重载onCreate
接口:
/*frameworks/base/packages/systemui/src/com/android/systemui/SystemUIService.java*/public void onCreate() {… IWindowManager wm = WindowManagerGlobal.getWindowManagerService();//获取WMS服务try {SERVICES[0] = wm.hasSystemNavBar()? R.string.config_systemBarComponent: R.string.config_statusBarComponent;//是StatusBar还是SystemBar?} catch (RemoteException e) {Slog.w(TAG, "Failing checking whether status bar can hide", e);}final int N = SERVICES.length;mServices = new SystemUI[N];for (int i=0; i<N; i++) {Class cl = chooseClass(SERVICES[i]);Slog.d(TAG, "loading: " + cl);try {mServices[i] = (SystemUI)cl.newInstance();} …mServices[i].mContext = this;Slog.d(TAG, "running: " + mServices[i]);mServices[i].start();//mServices中的每个元素都继承自SystemUI}}
SERVICES是一个object数组,它的初始值如下所示:
final Object[] SERVICES = new Object[] {0, // system bar or status bar, filled in below.com.android.systemui.power.PowerUI.class,com.android.systemui.media.RingtonePlayer.class,com.android.systemui.settings.SettingsUI.class,};
其中,SERVICES[0]在初始化时没有赋值。它将根据hasSystemNavBar的执行结果来决定是用systemBar还是statusBar。上面这段代码首先取出SERVICES数组中的class名,然后分别实例化它们,最后调用start接口统一启动。因此,每一个系统ui元素(包括statusBar,PowerUI等)都必须继承自SystemUI这个抽象类,并重载其中的start方法。
函数hasSystemNavBar做了哪些判断来对statusBar和systemBar进行取舍呢?WindowManager的真正实现体是WindowManagerService。
/*frameworks/base/services/java/com/android/server/wm/WindowManagerService.java*/public boolean hasSystemNavBar() {return mPolicy.hasSystemNavBar();}
**Policy是Android中定义UI行为的一个“规范”。**比如有没有Navigation Bar,WindowLayer如何排布等。以PhoneWindowManager为例,它判断当前系统是否需要导航条。
我们假设设备的分辨率是800*480,屏幕密度为ldpi:
/*frameworks/base/policy/src/com/android/internal/policy/impl/PhoneWindowManager.java*/int shortSizeDp = shortSize*DisplayMetrics.DENSITY_DEFAULT/ density;/*在这个场景中,shortSize=480,DENSITY_DEFAULT=160,density =120, 所以最终shortSizeDp = 640*/if (shortSizeDp < 600) {//在这个场景中不成立mHasSystemNavBar = false;mNavigationBarCanMove = true;} else if (shortSizeDp < 720) {/*本场景属于这一分支*/mHasSystemNavBar = false;mNavigationBarCanMove = false;} if (!mHasSystemNavBar) {//进一步判断是否有Navigation Bar…} else {mHasNavigationBar = false;}
所以在这个场景中,经过上面的判决后mHasSystemNavBar
为false。换句话说,对于分辨率800*480且密度为ldpi的屏幕,它的SERVICES[0]
对应的class类名是R.string.config_statusBar Component
即“com.android.systemui.statusbar.phone.PhoneStatusBar
”。下面以PhoneStatusBar
为例来看看它的创建过程及具体样式:
/*frameworks/base/packages/systemui/src/com/android/systemui/statusbar/phone/ PhoneStatusBar.java*/public void start() {mDisplay = ((WindowManager)mContext.getSystemService(Context.WINDOW_SERVICE)).getDefaultDisplay();/*mDisplay记录了当前默认显示屏的大小,密度等等信息*/…super.start();// 关键语句,下面我们会重点介绍addNavigationBar();/*不是所有Phone都需要Navigation Bar。比如设备本身已经配备了物理按键,这种情况下如果一直在屏幕上显示导航条反而是一种累赘*/…}
PhoneStatusBar
的“父类”是BaseStatusBar
,很多框架性的操作都是在这里面完成的(但UI界面的具体描述还是会通过回调PhoneStatusBar
中的方法来确定):
/*frameworks/base/packages/systemui/src/com/android/systemui/statusbar/BaseStatusBar.java*/public void start() {…mBarService = IStatusBarService.Stub.asInterface(ServiceManager.getService(Context.STATUS_BAR_SERVICE));// Connect in to the status bar manager serviceStatusBarIconList iconList = new StatusBarIconList();//状态栏图标列表ArrayList<IBinder> notificationKeys = new ArrayList<IBinder>();ArrayList<StatusBarNotification> notifications = new ArrayList<StatusBarNoti fication>();mCommandQueue = new CommandQueue(this, iconList);int[] switches = new int[7];ArrayList<IBinder> binders = new ArrayList<IBinder>();try {mBarService.registerStatusBar(mCommandQueue,iconList,notificationKeys,notifications,switches, binders); /*经过一系列对象的创建与初始化后,开始向StatusBarService进行注册。这里涉及跨进程操作,因而传递的参数都是继承自Parcelable的*/} catch (RemoteException ex) {// If the system process isn't there we're doomed anyway.}createAndAddWindows(); /*这是真正将Status Bar显示出来的地方*/…}
好不容易快到“水落石出”的时候了,但是上面这段代码却又杀出一个“程咬金”——StatusBarService。
既然SystemUI这个应用程序中已经有StatusBar了,为什么又需要StatusBarService?
先来看看StatusBarService是在哪里启动的。
/*frameworks/base/services/java/com/android/server/SystemServer.java*/try {Slog.i(TAG, "Status Bar");statusBar = new StatusBarManagerService(context, wm); /*确实在这里。而且具体的实现类叫做StatusBarManagerService*/ServiceManager.addService(Context.STATUS_BAR_SERVICE, statusBar);} catch (Throwable e) {reportWtf("starting StatusBarManagerService", e);}
现在可以进一步分析StatusBarManagerService的实现了。针对上面BaseStatusBar中调用的注册操作:
public void registerStatusBar(IStatusBar bar, StatusBarIconList iconList,List<IBinder>notificationKeys,List<StatusBarNotification> notifications,int switches[], List<IBinder> binders) {enforceStatusBarService();mBar = bar;synchronized (mIcons) {iconList.copyFrom(mIcons); /*复制Icon列表,注意方向是从StatusBarManager-> BaseStatusBar*/}synchronized (mNotifications) {for (Map.Entry<IBinder,StatusBarNotification> e: mNotifications.entrySet()) {notificationKeys.add(e.getKey());notifications.add(e.getValue());/*和Icon列表类似,方向也是从StatusBarManager到BaseStatusBar*/}}…}
由上面这段代码可以看出,registerStatusBar有两个作用:
其一,为新启动的SystemUI应用中的StatusBar赋予当前系统的真实值(比如有多少需要显示的图标)。其二,通过成员变量mBar记录下IStatusBar对象——它在SystemUI中对应的是CommandQueue。
我们再回到BaseStatusBar。向StatusBarManagerService注册完成后,它会执行如下语句。
createAndAddWindows();
BaseStatusBar中的这个方法是抽象的,因而其子类PhoneStatusBar必须要重载它:
/*frameworks/base/packages/systemui/src/com/android/systemui/statusbar/phone/Ph- oneStatusBar.java*/public void createAndAddWindows() {addStatusBarWindow();}private void addStatusBarWindow() {final int height = getStatusBarHeight();/*首先获取StatusBar的高度。默认的高度值是通过com.android.internal.R.dimen.status_bar_height来指定的,因而开发人员如果需要更改StatusBar高度的话,可以考虑修改这个值*/ final WindowManager.LayoutParams lp = new WindowManager.LayoutParams(ViewGroup.LayoutParams.MATCH_PARENT, /*宽度是MATCH_PARENT*/height, //高度值是可定制的WindowManager.LayoutParams.TYPE_STATUS_BAR, /*指定窗口类型*/WindowManager.LayoutParams.FLAG_NOT_FOCUSABLE|WindowManager.LayoutParams.FLAG_TOUCHABLE_WHEN_WAKING| WindowManager.LayoutParams.FLAG_SPLIT_TOUCH,/*设置flag, 下面还会加上硬件加速属性*/PixelFormat.TRANSLUCENT/*半透明的*/);lp.flags |=windowManager.LayoutParams.FLAG_HARDWARE_ACCELERATED;lp.gravity = getStatusBarGravity();/*设置Gravity属性,默认值为Gravity.TOP |Gravity.FILL_HORIZONTAL,所以StatusBar是在屏幕上方*/lp.setTitle("StatusBar"); //标题lp.packageName = mContext.getPackageName();makeStatusBarView(); //下面会详细介绍mWindowManager.addView(mStatusBarWindow, lp); /*将一切就绪的mStatusBarWindow加入WindowManager中。请参见本书显示系统章节的讲解*/}
从makeStatusBarView这个函数名可以推断出,StatusBarView会被创建并且初始化。先来了解下两个重要的变量。
-
mStatusBarWindow
这是一个StatusBarWindowView类对象,同时我们通过addView传给WindowManager的也是这个变量——说明它很可能包含了StatusBarView。 -
mStatusBarView
这就是makeStatusBarView需要操作的对象。
/*frameworks/base/packages/systemui/src/com/android/systemui/statusbar/phone/Ph-one
StatusBar.java*/protected PhoneStatusBarView makeStatusBarView() {…mStatusBarWindow = (StatusBarWindowView) View.inflate(context, R.layout.super_ status_bar, null);mStatusBarWindow.mService = this; //mService其实指的是PhoneStatusBarmStatusBarWindow.setOnTouchListener(new View.OnTouchListener() {//设置触摸事件@Overridepublic boolean onTouch(View v, MotionEvent event) {if (event.getAction() == MotionEvent.ACTION_DOWN) {//支持下拉手势if (mExpandedVisible) {animateCollapsePanels ();//通知栏的“下拉展开”需要动画效果,不然会很突兀}}return mStatusBarWindow.onTouchEvent(event);}});mStatusBarView =(PhoneStatusBarView)mStatusBarWindow.findViewById(R.id.status_ bar);mStatusBarView.setBar(this); /*状态栏出场了*/…mNotificationPanel = (NotificationPanelView) mStatusBarWindow.findViewById(R.id. notification_panel);mNotificationPanel.setStatusBar(this); /*通知栏也很关键,只不过它只有在下拉后才会出现*//*从下面开始将利用mStatusBarView为PhoneStatusBar中的众多内部变量赋值*/…try {boolean showNav = mWindowManagerService.hasNavigationBar();/*决定是否需要导航条*/if (showNav) {mNavigationBarView = (NavigationBarView) View.inflate(context, R.layout. navigation_ bar, null);/*Navigation Bar对应的layout。有兴趣的读者可以自己看一下*/…}} catch (RemoteException ex) {/*Android中的不少代码在捕捉异常时,很常见的一种处理就是“听天由命”…*/}/*接下来通过findViewById从mStatusBarView中获取StatusIcons、NotificationIcons、ClearButton等一系列按键。我们将会在StatusBar布局文件中做统一分析。这里暂时略过*/… /*最后动态注册需要接收的广播,比如系统设置改变,屏幕关闭等*/IntentFilter filter = new IntentFilter();filter.addAction(Intent.ACTION_CONFIGURATION_CHANGED);filter.addAction(Intent.ACTION_CLOSE_SYSTEM_DIALOGS);…context.registerReceiver(mBroadcastReceiver, filter);…return mStatusBarView;//注意最终返回值是mStatusBarWindow的子View}
变量mStatuBarWindow
来源于super_status_bar
布局。它本质上还是一个FrameLayout
,包含的元素也很简单,就是status_bar
和status_bar_expanded
两个布局,前者对应的是状态栏mStatusBarView
,后者其实就是通知栏mNotificationPanel
。为status_bar中的众多元素(按键、背景等)进行初始化。
最终的返回值是mStatusBarView。然后利用WindowManager的addView接口将mStatus- BarWindow(注意:不是mStatusBarView)添加进窗口系统中。接下来的主动权就转交给WindowManager。
这样我们就把StatusBar,Notification和NavigationBar的调用流程“串”起来了。
Android壁纸资源——WallpaperService
除了前面讲解的状态栏、通知栏外,壁纸也属于SystemUI管理的一个重点。在Android系统中,用户可以从设备内部或者外存储器(比如SD卡中)中选取图片资源作为壁纸。另外,系统还支持动态壁纸的显示。
壁纸管理系统主要包括以下几个方面。
-
WallpaperManagerService(WPMS)
它是壁纸机制的“大总管”,静态、动态壁纸都是在这里统一调度的。 -
WallpaperService(WPS)
WPS继承了标准的Service组件,因而它一定会实现onCreate、onDestroy、onBind等一系列方法。此外它还包含了一个重要的嵌套类engine,我们在后面会做详细讲解。WPS是静态、动态壁纸的基类,代表了作为“壁纸”所应该具有的一切属性。 -
ImageWallpaper(IWP)
从名称可以看出,它是静态壁纸的实现类,而且一定是继承自上面的WPS。
WallPaperManagerService
WPMS既然是基于AIDL实现的,我们来看看它的接口描述:
/*frameworks/base/core/java/android/app/IWallpaperManager.aidl*/
interface IWallpaperManager {ParcelFileDescriptor setWallpaper(String name); /*设置壁纸*/void setWallpaperComponent(in ComponentName name); /*设置动态壁纸*/ParcelFileDescriptor getWallpaper(IWallpaperManagerCallback cb,out Bundle outParams);WallpaperInfo getWallpaperInfo();…
}
从上面的接口定义可以看出,WPMS的工作并不复杂——它提供了全局的壁纸注册、取消和查询功能,并在接收到事件时进行合理分配。
和其他系统服务一样,WPMS是在SystemServer.java中启动并注册进ServiceManager中的,如下所示:
/*frameworks/base/services/java/com/android/server/SystemServer.java*/try {Slog.i(TAG, "Wallpaper Service");if (!headless) {wallpaper = new WallpaperManagerService(context);ServiceManager.addService(Context.WALLPAPER_SERVICE, wallpaper);}} catch (Throwable e) {reportWtf("starting Wallpaper Service", e);}
接下来的一个问题是:既然系统同时支持静态壁纸和动态壁纸,而且每种类型中还包含了N个实例(比如原生态系统就自带多个动态壁纸供用户选择),那么系统在显示时是如何选择的呢?我们很自然地会想到,在WPMS启动时它应该会去读取某个“配置文件”,这个文件记录了用户最近一次的选择:
public WallpaperManagerService(Context context) {…loadSettingsLocked(UserHandle.USER_OWNER);//加载配置}
当WPMS构造时,它调用了loadSettingsLocked
:
private void loadSettingsLocked(int userId) {//这里传进来的userId=0…try {stream = new FileInputStream(file);XmlPullParser parser = Xml.newPullParser();parser.setInput(stream, null);int type;do {type = parser.next();if (type == XmlPullParser.START_TAG) {String tag = parser.getName();if ("wp".equals(tag)) {…wallpaper.name = parser.getAttributeValue(null, "name");String comp = parser.getAttributeValue(null, "component");…}}} while (type != XmlPullParser.END_DOCUMENT);success = true;} … }
上面这段代码会按照写入时的格式将wallpaper的配置信息读出来,并保存在WallpaperData结构中——专门用于描述壁纸信息的通用数据结构。不过这时壁纸还没有真正显示出来,而是要等到系统进入Ready状态(此时系统会回调SystemReady接口)后才会通知具体的壁纸程序进行绘制:
public void systemReady() {WallpaperData wallpaper = mWallpaperMap.get(UserHandle.USER_OWNER);switchWallpaper(wallpaper, null);…}
接着进入Wallpaper的具体处理中:
void switchWallpaper(WallpaperData wallpaper, IRemoteCallback reply) {synchronized (mLock) {…try {ComponentName cname = wallpaper.wallpaperComponent != null ?wallpaper.wallpaperComponent : wallpaper.nextWallpaperComponent;if (bindWallpaperComponentLocked(cname, true, false, wallpaper,reply)) {return;}} …}
系统开机后,
wallpaper.wallpaperComponent
为空(除非上一次用户选择了其他方式);而wallpaper.nextWallpaperComponent
则在loadSettingsLocked
中被设置为wallpaper.imageWallpaper Component
,即我们前面提到的ImageWallpaper
这个Service
。所以当调用bindWallpaperComponentLocked
时,传入的cname就代表了ImageWallpaper。从bindWallpaperComponentLocked
的函数名称可以看出,它将会以bindService的方式来启动目标壁纸Service(所以后期如果确认已经不再使用这个Service,还要主动执行unbind,然后这个壁纸服务就会自动销毁)。
WPMS启动后就可以接收客户端的请求了,因为它属于实名的BinderServer,意味着所有人都可以自由地使用它所提供的服务。比如我们既可以在系统自带的Launcher应用程序中选择壁纸,也完全可以自己编写一个更改壁纸的应用程序。
下面我们以设置壁纸这一场景为例来分析WPMS的内部实现:
/*frameworks/base/services/java/com/android/server/WallpaperManagerService.java*/public ParcelFileDescriptor setWallpaper(String name) {checkPermission(android.Manifest.permission.SET_WALLPAPER);synchronized (mLock) {int userId = UserHandle.getCallingUserId();WallpaperData wallpaper = mWallpaperMap.get(userId);…final long ident = Binder.clearCallingIdentity();try {ParcelFileDescriptor pfd = updateWallpaperBitmapLocked(name, wallpaper);…return pfd;} finally {Binder.restoreCallingIdentity(ident);}}}
首先系统会做下权限检查,所以提供壁纸设置功能的应用程序一定要在AndroidManifest.xml中显式写上如下权限声明:
<uses-permission android:name="android.permission.SET_WALLPAPER" />
变量wallpaper是从mWallpaperMap取出来的,代表UserId为0时的壁纸——如果不为空就进入以下函数:
ParcelFileDescriptor updateWallpaperBitmapLocked(String name, WallpaperData wallpaper) {if (name == null) name = "";try {File dir = getWallpaperDir(wallpaper.userId);//wallpaper的路径if (!dir.exists()) {//指定的路径不存在,需要创建dir.mkdir();FileUtils.setPermissions(dir.getPath(),FileUtils.S_IRWXU|FileUtils.S_IRWXG|FileUtils.S_IXOTH, -1, -1);}File file = new File(dir, WALLPAPER);ParcelFileDescriptor=ParcelFileDescriptor.open(file,MODE_CREATE|MODE_READ_WRITE);if (!SELinux.restorecon(file)) {return null;}wallpaper.name = name;return fd;} catch (FileNotFoundException e) {Slog.w(TAG, "Error setting wallpaper", e);}return null;}
上面getWallpaperDir将得到一个WALLPAPER_BASE_DIR+“/”+userId的路径,其中WALLPAPER_BASE_DIR默认值是"/data/system/users"。
ImageWallpaper
前面讲过,当WPMS开机启动时,默认情况下会选择ImageWallpaper这个壁纸实现,并且以bindService的方式来启动它。在bindService中,WPMS同时传入名为newConn的Binder对象(WallpaperConnection)来使ImageWallpaper(其他WallpaperService也是一样的)可以访问到WPMS。而ImageWallpaper则响应onBind返回一个IWallpaperServiceWrapper的Binder对象,如图所示。
我们来看看当绑定成功后WPMS中的操作:
public void onServiceConnected(ComponentName name, IBinder service) {synchronized (mLock) {if (mWallpaper.connection == this) {…attachServiceLocked(this, mWallpaper);…saveSettingsLocked(mWallpaper);}}}
WPMS除了要保存当前所选的壁纸外,还要调用attachServiceLocked(间接调用Iwallpaper ServiceWrapper.attach)来执行实际的工作。
WPS这边的attach函数将生成一个IWallpaperEngineWrapper对象并给它发送一个DO_ATTACH,这个消息最终由IWallpaperEngineWrapper. executeMessage来处理:
public void executeMessage(Message message) {switch (message.what) {case DO_ATTACH: {try {mConnection.attachEngine(this);} catch (RemoteException e) {Log.w(TAG, "Wallpaper host disappeared", e);return;}Engine engine = onCreateEngine();mEngine = engine;mActiveEngines.add(engine);engine.attach(this);return;}
上述代码段通过onCreateEngine生成了一个壁纸引擎——这也是各壁纸应用间最核心的差异。所以系统要求每一个WallpaperService实例必须要重载onCreateEngine来实现自己的engine。在ImageWallpaper中,它将产生一个DrawableEngine——这个engine随后会被加入mActiveEngines的全局list中,然后调用它提供的attach接口。如下所示:
/*frameworks/base/core/java/android/service/wallpaper/WallpaperService.java*/public class Engine {…void attach(IWallpaperEngineWrapper wrapper) {…mSession = WindowManagerGlobal.getWindowSession();mWindow.setSession(mSession);…IntentFilter filter = new IntentFilter();filter.addAction(Intent.ACTION_SCREEN_ON);filter.addAction(Intent.ACTION_SCREEN_OFF);registerReceiver(mReceiver, filter); …updateSurface(false, false, false);//更新Surface
}…
Engine内部首先需要进行各重要变量的初始化,然后注册监听屏幕的开/关事件,最后调用updateSurface。