Android UsageStatsService(应用使用统计服务)的学习与调研

一. 简介

UsageStatsService是一个系统服务,其主要通过AMS等,来监测并记录各个应用的使用数据,如上次调用com.android.settings的时间等。

UsageStatsService,a service that collects, aggregates, and persists application usage data. This data can be queried by apps that have been granted permission by AppOps.

代码位置:frameworks/base/services/usage/java/com/android/server/usage/

UsageStatsService创建时,其在onStart()方法中会调用如下方法提供服务,

publishLocalService(UsageStatsManagerInternal.class, new LocalService()); // AMS会调用

publishBinderService(Context.USAGE_STATS_SERVICE, new BinderService()); // 给其他Service和APP调用

其中重点关注LocalService,ActivityManagerService有一个成员变量mUsageStatsService,其会统计4个UsageStatsService自定义的事件(MOVE_TO_FOREGROUND,MOVE_TO_BACKGROUND,CONFIGURATION_CHANGE,SYSTEM_INTERACTION)。mUsageStatsService的赋值在SystemServer#startCoreServices()方法中,如下:

mActivityManagerService.setUsageStatsManager(LocalServices.getService(UsageStatsManagerInternal.class));

二. 事件

数据的事件类型有7种,全部定义在UsageEvents.java中,如下:

数值
事件
解释
调用方
备注
1 MOVE_TO_FOREGROUND An event type denoting that a component moved to the foreground ActivityManagerService 例如当Activity被置于前台显示时,会记录此事件及时间,包括Activity名字
2 MOVE_TO_BACKGROUND An event type denoting that a component moved to the background ActivityManagerService 例如当Activity被置于后台时,会记录此事件及时间,包括Activity名字
3 END_OF_DAY An event type denoting that a component was in the foreground when the stats * rolled-over. This is effectively treated as a {@link #MOVE_TO_BACKGROUND} UsageStatsService

每一次记录事件时间时,都会判定,如果此次记录时系统时间越过一天,此时会记录此事件,它的作用是这次的时间会做为今天的最后一个记录时间。

那么下次再记录事件时,将会当作新的一天来记录,新建一个新的XML文件

4 CONTINUE_PREVIOUS_DAY An event type denoting that a component was in the foreground the previous day. * This is effectively treated as a {@link #MOVE_TO_FOREGROUND} UsageStatsService -
5 CONFIGURATION_CHANGE An event type denoting that the device configuration has changed ActivityManagerService 记录下系统配置变化的数据,时间等
6 SYSTEM_INTERACTION An event type denoting that a package was interacted with in some way by the system ActivityManagerService 较多事件是此类型,具体解释可见下方2
7 USER_INTERACTION An event type denoting that a package was interacted with in some way by the user NotificationManagerService 当一条通知显示给用户看时,会记录此事件,包括时间,package等

重点介绍以下3个事件,

1. 事件【MOVE_TO_FOREGROUND与MOVE_TO_BACKGROUND】

Activity在前台显示时,ActivityStackSupervisor.java中方法reportResumedActivityLocked(),其会调用ActivityManagerService#updateUsageStats(),resumedf参数为true,

Activity在后台时,ActivityStack.java中方法startPausingLocked()或removeHistoryRecordsForAppLocked(),其会调用ActivityManagerService#updateUsageStats(),resumedf参数为false,

void updateUsageStats(ActivityRecord componentboolean resumed) {

        ......
if (resumed) {
if (mUsageStatsService != null) {
mUsageStatsService.reportEvent(component.realActivity, component.userId,
UsageEvents.Event.MOVE_TO_FOREGROUND);
}
......
} else {
if (mUsageStatsService != null) {
mUsageStatsService.reportEvent(component.realActivity, component.userId,
UsageEvents.Event.MOVE_TO_BACKGROUND);
}
......
}
}

在updateUsageStats()中会调用UsageStatsService的reportEvent方法,来记录下MOVE_TO_FOREGROUND或MOVE_TO_FOREGROUND事件,以及Activity等,这些数据会通过UsageStatsService被保存。

2. 事件【SYSTEM_INTERACTION】

统计此事件的代码调用顺序是:AcitivityManagerService#applyOomAdjLocked()  -> ActivityManagerService#maybeUpdateUsageStatsLocked() -> mUsageStatsService.reportEvent(packages[i], app.userId, UsageEvents.Event.SYSTEM_INTERACTION);

代码:frameworks/base/services/core/java/com/android/server/am/ActivityManagerService.java#maybeUpdateUsageStatsLocked

其中在方法maybeUpdateUsageStatsLocked中,判断是否向UsageStatsService发送此事件统计的依据之一是变量isInteraction(通过对比app.curProcState)。

举个例子:

百度小米输入法(com.baidu.input_mi)的进程状态由PROCESS_STATE_NONEXISTENT(-1)变更为PROCESS_STATE_BOUND_FOREGROUND_SERVICE(3)时,AMS会向UsageStatsService发送此事件记录。debug log如下:

Checking proc [[com.baidu.input_mi]] state changes: old = -1, new = 3

report SYSTEM_INTERACTION event, package = com.baidu.input_mi

另外,重点注意以下2点:

A. UsageStatsService中,SYSTEM_INTERACTION事件在数据存储时,其event type会被记为0。代码依据:

frameworks/base/services/usage/java/com/android/server/usage/IntervalStats.java#108

B. SYSTEM_INTERACTION事件的上次使用时间,在数据存储时,会被记为0,通过UTC时间转换后,是1970年1月1日

112        if (eventType != UsageEvents.Event.SYSTEM_INTERACTION) {
113 usageStats.mLastTimeUsed = timeStamp;
114 }

frameworks/base/services/usage/java/com/android/server/usage/IntervalStats.java#112

以上2点是应用使用统计服务的by design逻辑

三. 数据存储

UsageStatsService的数据存储在哪里?有一个类在管理UsageStatsDatabase,通过它的源码即可发现,真正的数据持久化是存储在XML中,XML位置:/data/system/usagestats/。XML的所有操作,例如读,写等,都被封装在类UsageStatsXmlV1中,由UsageStatsDatabase调用。

以下介绍3个方面,以及重点介绍下【时间跳变时UsageStatsService是如何更新已记录的时间】

1. 缓存与文件存储

UsageStatsService每次在启动时,都会先按照user生成各个UserUsageStatsService,其中每个对象都会先去各自的文件路径下读取数据到内存中。代码如下:

98        for (int i = 0; i < mCurrentStats.length; i++) {
99 mCurrentStats[i] = mDatabase.getLatestUsageStats(i);
100 ......

此后每次外界reportEvent,都会先更新内存中的数据,相当于缓存。那什么时候内存中的数据会更新至文件中呢?主要有以下几种情况:

  情况

内存中数据更新至文件中的时机

1. 手机关机,具体见:UsageStatsService.java#shutdown
2. 系统时间跳变(如人为修改系统时间或时间随网络校准)
3. 一天结束时,因为daily下面xml文件存储一天的数据,此时需下次新建文件
4. ......

数据在内存中保存在mCurrentStats变量中

2. 数据目录按daily,monthly,weekly,yearly四个文件夹存储,每个文件夹中包含若干个XML文件

如:Android UsageStatsService(应用使用统计服务)的学习与调研

3. 每一个XML中的数据

打开一个XML,即可看到,存储的数据包括三类,package上次访问和使用的时间,configurations,event-log。举例如下:

<?xml version='1.0' encoding='utf-8' standalone='yes' ?>

       <usagestats version="1" endTime="93054">

             <packages>

                   <package lastTimeActive="92995" package="com.android.settings" timeActive="87841" lastEvent="2" />

                   <package lastTimeActive="93054" package="com.miui.home" timeActive="5076" lastEvent="1" />

             </packages>

       <configurations>

             <config lastTimeActive="0" timeActive="0" count="1" active="true" fs="1065353216" locales="zh-CN" touch="3" key="1" keyHid="1" hardKeyHid="2" nav="1" navHid="2" ori="1" scrLay="268435810" ui="17" width="360" height="620" sw="360" density="480" />

       </configurations>

       <event-log>

             <event time="0" package="com.android.settings" class="com.android.settings.UsageStatsActivity" type="2" />

             <event time="61" package="com.miui.home" class="com.miui.home.launcher.Launcher" type="1" />

             <event time="5137" package="com.miui.home" class="com.miui.home.launcher.Launcher" type="2" />

             <event time="5154" package="com.android.settings" class="com.android.settings.MiuiSettings" type="1" />

             <event time="92995" package="com.android.settings" class="com.android.settings.MiuiSettings" type="2" />

             <event time="93054" package="com.miui.home" class="com.miui.home.launcher.Launcher" type="1" />

    </event-log>

</usagestats>

数据类型
简介
package 以包为记录单位,例如com.android.settings上一次被访问的时间,上次被使用的时间以及事件类型。注意:其数值是能在event log中查询找到,对应起来
configurations 由AMS发送事件给UsageStatsService来统计,记录下系统配置变化的数据,时间等
event-log 以Activity为单位,例如桌面界面,上一次被访问的时间,以及事件类型

注意:XML中package的lastEvent字段,event-log的type字段,都是指上面介绍过的事件类型。但是注意,事件类型是有7种,但真正记录在XML中,除了4种(MOVE_TO_FOREGROUND,MOVE_TO_BACKGROUND,END_OF_DAY,CONTINUE_PREVIOUS_DAY)记录其int值,其他的事件(CONFIGURATION_CHANGE,SYSTEM_INTERACTION,USER_INTERACTION)都记录为0,所以在XML中看到事件类型为0,那么是指这三种。这段逻辑是在数据记录的IntervalStats#update方法中,

95    void update(String packageName, long timeStamp, int eventType) {
96 UsageStats usageStats = getOrCreateUsageStats(packageName);
......
108 if (isStatefulEvent(eventType)) {
109 usageStats.mLastEvent = eventType;
110 }
111
112 if (eventType != UsageEvents.Event.SYSTEM_INTERACTION) {
113 usageStats.mLastTimeUsed = timeStamp;
114 }
......
122 }

isStatefulEvent的实现如下:

84    private boolean isStatefulEvent(int eventType) {
85 switch (eventType) {
86 case UsageEvents.Event.MOVE_TO_FOREGROUND:
87 case UsageEvents.Event.MOVE_TO_BACKGROUND:
88 case UsageEvents.Event.END_OF_DAY:
89 case UsageEvents.Event.CONTINUE_PREVIOUS_DAY:
90 return true;
91 }
92 return false;
93 }

另外,格外注意以上方法中第112行,SYSTEM_INTERACTION这个事件在存储时,上次访问时间是不记录真实时间的,取初始默认值0,转换成现代时间,就是1970年1月1日。

以下重点介绍:

1. 数据随时间跳变而调整

手机系统时间会每秒发生变化,但也会发生跳变,常见的方式是2种,一是人为修改时间,二是系统时间通过网络自动校准(SIM卡或WiFi等)。

举个例子,手机第一次使用,未联网校准时,手机时间是错误的,可能显示为1970年3月25日,这时候用户在手机的操作,各个应用的上次使用时间肯定是被记录为1970年3月25日。但手机联网后,时间被通过网络校准为2017年11月29日。那这样会有一个情况?UsageStatsService中统计的时间仍然记录为1970年3月25日吗?显然不会的,Google的工程师想到了这一点,因此在UsageStatsService中有一个巧妙的机制,来保证记录时间的准确性。

A. UsageStatsService中有一个方法checkAndGetTimeLocked,此方法会在每次reportEvent记录应用事件时,获取系统时间,在获取的同时呢,它也记录了上一次使用的系统时间。通过差值计算,能够判定出系统的时间是否发生了跳变,例如人为的修改,通过网络进行的时间自动校准等。如果判定系统时间发生了跳变,UsageStatsService会调用onTimeChanged()方法,它会负责更新UsageStatsService记录的时间,以便他们能够跟随系统时间跳变,而相应更新。

         void onTimeChanged(long oldTime, long newTime) {
persistActiveStats();
mDatabase.onTimeChanged(newTime - oldTime);
loadActiveStats(newTime);
}

B. 这里的时间是直接存储在XML中吗?例如XML中Activity1,上次使用时间:2017年11月29日XX时XX分XX秒。不是这样的,这里的设计也它的特别之处,

首先时间的存储全部是按毫秒来存储的,此毫秒也就是对比1970年1月1日,换算来的差值。

其次时间的存储分为2部分,这里有一个公式,应用的上次使用时间  = XML文件名 + XML中此应用的上次使用时间。注意:XML文件的名字不是随便起的,是用某个基准时间的毫秒值来存储的。举个例子:

XML文件名为:1511953275497,打开文件,其中的数据如下:

<?xml version='1.0' encoding='utf-8' standalone='yes' ?>
           <usagestats version="1" endTime="2936118">
           <packages>
           <package lastTimeActive="2936118" package="com.android.settings" timeActive="78268" lastEvent="2" />

.......

那么在查询上次使用数据时,Settings的上次使用时间为:1511953275497 + 2936118 = 1511956211615,通过对比1970年1月1日,换算为日常时间是大约是2017/11/29 19:50:11。所以这就是手机中设置Settings上次的使用时间。

这样设计的好处是,当系统时间跳变时,只需要更新XML的文件名时间,XML中所有的值不需要逐条更新。那么通过算加法得到的时间,也就是正确的时间了。再举个例子:

1. 用户手机时间为1970年3月25日,这时UsageStatsService中XML的文件名为:7142400,其中设置的上次使用时间,在XML中存储的值是10000,那么设置的上次使用时间是:

7142400 + 10000 = 7152400,换算为正常时间是:1970年3月25日。(注意,举例中时间用得秒,并非毫秒,实际XML中存储的都是毫秒)

2. 用户手机时间通过跳变,校准为2017年11月29日。这时UsageStatsService通过onTimeChanged方法,XML中文件名变为1511953275497,在XML中存储的值还是10000,那么设置的上次使用时间是:

1511953275 + 10000 = 1511963275,换算为正常时间是:2017年11月29日。(注意,举例中时间用得秒,并非毫秒,实际XML中存储的都是毫秒)

通过以上这样的机制,UsageStatsService中记录的时间,就会随着系统时间的跳变(人为修改或网络校准)而保持为正确的值。用户查询时也不会感到诧异。

 我的博客即将搬运同步至腾讯云+社区,邀请大家一同入驻:https://cloud.tencent.com/developer/support-plan

上一篇:centos和ubuntu下pycharm无法输入中文的解决办法


下一篇:solr的访问权限管理及ubuntu下iptables的设置