Android UsageStatsService：要点解析

最新推荐文章于 2025-06-23 09:27:19 发布
原创 最新推荐文章于 2025-06-23 09:27:19 发布 · 1.1w 阅读 · 13 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#android #应用 #启动次数 #频率

本文详细介绍了Android系统中UsageStatsService的作用、使用方法及其工作原理。包括如何获取APP使用数据、服务内部实现细节及数据持久化过程。

1、UsageStatsService作用是什么？

   这是一个Android私有service，主要作用是收集用户使用每一个APP的频率、使用时常；


2、如何通过UsageStatsService获取用户使用APP的数据？

（1）必须要具备系统权限；（APP内置在/system/app下）

（2）必须要在manifest中申明权限：PACKAGE_USAGE_STATS；例如：

<uses-permission android:name="android.permission.PACKAGE_USAGE_STATS" />


（3）调用UsageStatsService.getAllPkgUsageStats or UsageStatsService.getPkgUsageStats 接口获取用户使用APP频率：

 <span style="white-space:pre">	</span>    //相当于：IBinder oRemoteService = ServiceManager.getService("usagestats");
            Class<?> cServiceManager = Class.forName("android.os.ServiceManager");
            Method mGetService = cServiceManager.getMethod("getService", java.lang.String.class);
            Object oRemoteService = mGetService.invoke(null, "usagestats");

            // 相当于:IUsageStats mUsageStatsService = IUsageStats.Stub.asInterface(oRemoteService)
            Class<?> cStub = Class.forName("com.android.internal.app.IUsageStats$Stub");
            Method mUsageStatsService = cStub.getMethod("asInterface", android.os.IBinder.class);
            Object oIUsageStats = mUsageStatsService.invoke(null, oRemoteService);

            // 相当于:PkgUsageStats[] oPkgUsageStatsArray =mUsageStatsService.getAllPkgUsageStats();
            Class<?> cIUsageStatus = Class.forName("com.android.internal.app.IUsageStats");
            Method mGetAllPkgUsageStats = cIUsageStatus.getMethod("getAllPkgUsageStats", (Class[]) null);
            Object[] oPkgUsageStatsArray = (Object[]) mGetAllPkgUsageStats.invoke(oIUsageStats, (Object[]) null);

            //相当于
            //for (PkgUsageStats pkgUsageStats: oPkgUsageStatsArray)
            //{
            //  当前APP的包名：
            //  packageName = pkgUsageStats.packageName
            //  当前APP的启动次数
            //  launchCount = pkgUsageStats.launchCount
            //  当前APP的累计使用时间：
            //  usageTime = pkgUsageStats.usageTime
            //  当前APP的每个Activity的最后启动时间
            //  componentResumeTimes = pkgUsageStats.componentResumeTimes
            //}
            Class<?> cPkgUsageStats = Class.forName("com.android.internal.os.PkgUsageStats");
            for (Object pkgUsageStats : oPkgUsageStatsArray) {
                String packageName = (String) cPkgUsageStats.getDeclaredField("packageName").get(pkgUsageStats);
                int launchCount = cPkgUsageStats.getDeclaredField("launchCount").getInt(pkgUsageStats);
                long usageTime = cPkgUsageStats.getDeclaredField("usageTime").getLong(pkgUsageStats);
                Map<String, Long > componentResumeMap = (Map<String, Long>) cPkgUsageStats.getDeclaredField("componentResumeTimes").get(pkgUsageStats);
            }

3、UsageStatsService工作原理是什么？
（3-1）首先是service的初始化，主要分为两步；
第一步是从/data/system/usagestats/usage-history.xml文件中读取每个APP中每个Activity最后启动的时间；
//初始化/data/system/usagestats/usage-history.xml
 mHistoryFile = new AtomicFile(new File(mDir, FILE_HISTORY));
 //解析xml文件，将xml解析成为数据，并存储
 readStatsFromFile();
第二步是从“/data/system/usagestats/usage-当前日志”文件中解析今天的使用记录的数据：
//指定文件前缀为usage，根据日志生成文件后缀，例如usage-20140817
 mFileLeaf = getCurrentDateStr(FILE_PREFIX);
 //解析文件，为文件流的格式，直接读取即可
 readStatsFromFile();
其中“/data/system/usagestats/usage-当前日志”文件格式为2精制的序列化流，可直接从中读取相应的对象即可；如果对应文件不存在，则创建它；

（3-2）在初始化service完成后，需要组数据存储：
从usage-history.xml文件中解析出来的数据，放在：
   // key为包名，value为Map<String, Long>，记录该包下的Activity名以及该Activity最后启动时间
    final private Map<String, Map<String, Long>> mLastResumeTimes;

从“/data/system/usagestats/usage-当前日志”解析出来的数据，放在：
    // String为包名，PkgUsageStatsExtended存储相应的启动信息
    final private Map<String, PkgUsageStatsExtended> mStats;

可以发现此处封装了一个内部类PkgUsageStatsExtended做数据存储，其实PkgUsageStatsExtended还封装了许多操作，后面会逐步涉及，目前PkgUsageStatsExtended主要存储了这些信息：
   private class PkgUsageStatsExtended {
        //每个Activity最后启动时间
        final HashMap<String, TimeStats> mLaunchTimes
                = new HashMap<String, TimeStats>();
        //当前APP启动次数
        int mLaunchCount;
        //当前APP使用时间
        long mUsageTime;
        //当前APP最后一次调用onPause时间
        long mPausedTime;
        //当前APP最后一个调用onResume时间
        long mResumedTime;
        
        //更新mResumedTime为当前时间
        void updateResume(String comp, boolean launched) {
            if (launched) {
                mLaunchCount ++;
            }
            mResumedTime = SystemClock.elapsedRealtime();
        }
        
        //更新mPausedTime为当前时间，并且使用时常=mPausedTime - mResumedTime
        void updatePause() {
            mPausedTime =  SystemClock.elapsedRealtime();
            mUsageTime += (mPausedTime - mResumedTime);
        }
        
        //记录activity次数
        void addLaunchCount(String comp) {
            TimeStats times = mLaunchTimes.get(comp);
            if (times == null) {
                times = new TimeStats();
                mLaunchTimes.put(comp, times);
            }
            times.incCount();
        }
        
        //记录activity启动时间
        void addLaunchTime(String comp, int millis) {
            TimeStats times = mLaunchTimes.get(comp);
            if (times == null) {
                times = new TimeStats();
                mLaunchTimes.put(comp, times);
            }
            times.add(millis);
        }
        /*more code
        */
        
    }

(3-3)当应用启动一个Activity时，UsageStatsService会发生什么行为？
ActivityManagerService会调用UsageStatsService.noteResumeComponent方法，在该方法中会有以下操作：
public void noteResumeComponent(ComponentName componentName) {
        enforceCallingPermission();
        String pkgName;
        synchronized (mStatsLock) {
        		/*some code
        		*/
            final boolean samePackage = pkgName.equals(mLastResumedPkg);
            //1、mIsResumed会在onResume中变为true，在onPause中变为false
            if (mIsResumed) {
                if (mLastResumedPkg != null) {
                    //2、这里是为了避免没有调用onPause的情况出现，理论上不存在
                    PkgUsageStatsExtended pus = mStats.get(mLastResumedPkg);
                    if (pus != null) {
                    		//3、增加保护，调用一次updatePause
                        pus.updatePause();
                    }
                }
            }
            
            final boolean sameComp = samePackage
                    && componentName.getClassName().equals(mLastResumedComp);
                    
            //5、内部数据更新，记录最后一次启动的Activity
            mIsResumed = true;
            mLastResumedPkg = pkgName;
            mLastResumedComp = componentName.getClassName();
            
            PkgUsageStatsExtended pus = mStats.get(pkgName);
            if (pus == null) {
                pus = new PkgUsageStatsExtended();
                mStats.put(pkgName, pus);
            }
            //6、更新Activity启动时间，如果用户是从一个App启动进入另外一个APP，那么需要App标识启动次数+1
            pus.updateResume(mLastResumedComp, !samePackage);
            if (!sameComp) {
            		//7、同上，Activity启动次数+1
                pus.addLaunchCount(mLastResumedComp);
            }
						
            Map<String, Long> componentResumeTimes = mLastResumeTimes.get(pkgName);
            if (componentResumeTimes == null) {
                componentResumeTimes = new HashMap<String, Long>();
                mLastResumeTimes.put(pkgName, componentResumeTimes);
            }
            //8、更新componentResumeTimes
            componentResumeTimes.put(mLastResumedComp, System.currentTimeMillis());
        }
    }

（3-4）当退出一个Activity，UsageStatsService会发生什么行为？
ActivityManagerService会调用UsageStatsService.notePauseComponent方法，UsageStatsService会更新当前展示Activity的OnPause时间：
public void notePauseComponent(ComponentName componentName) {
				/*some code
				*/
        synchronized (mStatsLock) {
            /*some code
            */
            //1、mIsResumed会在onResume中变为true，在onPause中变为false
            mIsResumed = false;

            PkgUsageStatsExtended pus = mStats.get(pkgName);
            if (pus == null) {
                // Weird some error here
                Slog.i(TAG, "No package stats for pkg:"+pkgName);
                return;
            }
            //2、更新onPause的时间
            pus.updatePause();
        }
      //3、视情况而定确认是否需要将内存数据保存成文件
  　　writeStatsToFile(false, false);      
｝

（3-5）现在，我们已经明白APP启动数据如何在内存中流转了，那么什么时候系统将数据持久化成文件？
UsageStatsService通过writeStatsToFile方法将数据持久化成文件，函数原型如下：
    /**
     *　在特定条件下，将mStats或者mLastResumeTimes写入到文件中，由用户操作触发
     * @params force  强制将mStats实例化到文件中
     *               
     * @params forceWriteHistoryStats 强制将mLastResumeTimes实例化到文件中
     */
    private void writeStatsToFile(final boolean force, final boolean forceWriteHistoryStats) {
    ｝

具体触发writeStatsToFile的时机有：
1、用户关机，触发writeStatsToFile(true, true);
2、用户打开一个新应用，触发writeStatsToFile(false,false);
3、在notePauseComponent最后，调用writeStatsToFile(false,false);

writeStatsToFile触发写文件操作的条件有：
1、关机强制触发；
2、当前日期与最后一次写文件日期不同；
3、除用户关机外，两次写文件间隔必须在30分钟以上；

（3-6）卸载APP后，已经记录的数据会被清除；



Android 应用使用情况统计
赵航的博客
02-19 3万+
本篇文章简单记录下android中usageStatsManager的简单使用.UsageStatsManager提供对设备使用历史记录和统计信息的访问,时间周期为days, weeks, months, and years.
AndroidX（1）androidx.core.core:1.0.0解析
ZPCrobot的博客
05-29 6675
前言 AndroidX出来一段时间了，从09年开始一直在做公司的quickstart和组件化的东西，基础框架搭建这一块也算是有一些成绩。从原来的功能的抽象的封装，到现在系统性质研究。 正文 新的项目启动，有利于做一些前沿技术的思想的学习和吸收。androidx问世以后，从长远角度出发，确实是android开发者的福音。谷歌终于开始布局对于开发者友好以一块的事情了。也许是长期依赖开发者对兼容包诟病很多，不管谷歌出于什么样的目的，长远看来确实是一件好事 然而，实际并没有那么简单 在开始使用androidx的时候
UsageStatsService之坑：一个XML解析异常导致的开机动画死循环
一路到黑
07-26 1802
文章目录UsageStatsService之坑：一个XML解析异常导致的开机动画死循环声明问题说明日志排查猜想和验证问题定位插曲 -- XML的解析问题修复举一反三参考资料修改说明 UsageStatsService之坑：一个XML解析异常导致的开机动画死循环 声明 郑重声明：博文为原创内容，可以转载或引用，但必须在明显位置标明原文作者和出处，未经同意不得擅自修改本文内容！ 博客地址：http:/...
Android UsageStatsService 系统数据统计和数据上报
u012514113的专栏
07-03 3939
UsageStatsService 工作原理 UsageStatsManager API 使用
Android 自带的应用统计服务（UsageStatsService)
XiaoMu_Mu的博客
11-09 2256
最近要弄在 framework 中弄一个统计应用使用时长的功能。刚开始想着要怎么是不是要在 ActivityManagerService（AMS）的几个 Activity 的生命周期那埋几个统计点，后面发现 android 自带了一个 UsageStatsService（USS）的系统服务。这个东西统计的数据已经满足这边的需求了。只不过 android 好像只是统计了数据，并没怎么用（不过不排除 ...
Android UsageStatsService（应用使用统计服务）的学习与调研
weixin_34416754的博客
12-04 628
一. 简介 UsageStatsService是一个系统服务，其主要通过AMS等，来监测并记录各个应用的使用数据，如上次调用com.android.settings的时间等。 UsageStatsService，a service that collects, aggregates, and persists application usage data. This data can be...
Android源码：高仿360手机卫士2015-04
04-16
Android源码：高仿360手机卫士。深度访问手机资源权限。 更新于2015年4月，有需要的朋友可以参考下。 0分，方便没有分的朋友。
android源码设计模式解析与实战.pdf下载 完整版高清
12-02
本书从Android源码的角度由浅入深地剖析设计模式的运用，让工程师们把设计与模式重视起来，提升自己的设计能力与代码质量。因此本书适合的读者为初、中、高级Android工程师。另外，设计思想都是相通的，其他领域的...
Android 天气预报【解析XML / Json文件(2种方式：手动解析、Gson库解析)】
upward
03-19 4574
Android 天气预报 ；导入gson包【解析XML / Json 文件】 2种解析Json文件的方式（1：导入Gson进行解析；2：手动解析）
android在线时长统计
05-10
最精准的android在线时长统计，0权限要求，仅仅一个入参context。简单易用
Android开发：60个入门案例及完整源代码解析
8. **网络请求与处理**：通过网络请求获取数据，并在UI中展示数据，如使用Gson库解析JSON格式的网络数据。 ### 案例特点和学习方式 每一个案例都附有完整的源代码，这样初学者可以直接查看和理解代码是如何一步步...
Android 自带的应用统计服务（UsageStatsService）
thinkinwm的专栏
10-12 7553
http://light3moon.com/2015/01/31/%E5%B7%A5%E4%BD%9C%E5%B0%8F%E7%AC%94%E8%AE%B0%E2%80%94%E2%80%94Android%20%E8%87%AA%E5%B8%A6%E7%9A%84%E5%BA%94%E7%94%A8%E7%BB%9F%E8%AE%A1%E6%9C%8D%E5%8A%A1[UsageStatsSe
Android UsageStats：应用根据启动次数、启动时间、应用名称排序
weixin_33893473的博客
09-24 548
Android 7.1.1 developers/samples/android/system/AppUsageStatistics/Application/src/main/java/com/example/android/appusagestatistics/AppUsageStatisticsFragment.java packages/apps/Settings/src/com/and...
Android 应用使用数据统计服务——UsageStatsManager
fromVillageCoolBoy的博客
01-03 2424
先了解下相关知识。
Android应用使用统计与分析：UsageStatsManager实践指南
weixin_29717341的博客
06-23 1584
在Android系统中，了解和追踪应用的使用情况对于开发者和企业来说至关重要。这些数据可以帮助开发者优化应用性能，提升用户体验，并为企业提供有价值的信息，如用户行为分析和市场趋势预测。本章将概述Android应用使用情况追踪的重要性、基本原理以及其在不同场景下的应用。本章将引导读者从基础到进阶，逐步深入了解如何通过Android提供的工具和API实现对应用使用情况的追踪。我们将首先介绍，这是Android系统用于追踪应用使用数据的API，之后会探讨如何在实际应用中解析和分析这些数据。
Android UsageStatsManager的使用
jx_shi的博客
11-19 8348
背景：在做一个App Lock的demo，完全从应用层的层面去实现。 在5.0以下通过ActivityManager类的getRunningTasks（）获取当前打开的所有应用程序 。 在5.0版本之后废弃了getRunningTasks（）方法，意味着我们在5.0以后不能通过该方法获取正在运行的应用程序，google在5.0又提供类新的api，可以通过ActivityManager的g
Android UsageStatsManager的简单使用
shanfuming的博客
02-28 4473
最近公司要弄一个积分墙的app，因为涉及一些业务逻辑，所以查资料，做了一些总结。 （不懂积分墙的小伙伴请点 http://baike.baidu.com/link?url=N4uRhzK4qHtAsuSqotNJgT9DCIJXZb5014ia5tDsiWO81-Nh7M-7Qmdg0S1DH7_LB7USJMcL7wT9sEaCJEuk_9d1vPkkfWwneYfOigBBPMEqf_eC8
【Android N 7】使用量统计usagestats
weixin_34326179的博客
06-12 349
Android N 7.1.1 高通 1. /data/system/usagestats/0 2. 每天使用量统计 /data/system/usagestats/0/daily 查看数值： cat 1497186009952 即可 frameworks/base/services/usage/java/com/android/server/usage...
User[0] SELECT * FROM 0 WHERE beginTime >= 1760434216618 AND endTime < 1760520616618 行 110876: 10-15 17:30:16.626493 3250 5186 D UsageStatsService: Got 131 results from disk 行 110877: 10-15 17:30:16.626530 3250 5186 D UsageStatsService: Current stats beginTime=1760515444089 endTime=1760520614927 帮我解析一下这段日志是否与otg不识别有关
最新发布
10-17
<think>我们正在分析一段日志，用户询问这段日志是否与OTG不识别有关。日志内容如下： User[0] SELECT * FROM 0 WHERE beginTime >= 1760434216618 AND endTime < 1760520616618 行 110876: 10-15 17:30:16.626493 3250 5186 D UsageStatsService: Got 131 results from disk 行 110877: 10-15 17:30:16.626530 3250 5186 D UsageStatsService: Current stats beginTime=1760515444089 endTime=1760520614927 首先，我们需要理解日志的含义： - 第一行是一个SQL查询语句，从某个表（可能是使用统计数据库）中查询特定时间范围内的数据。时间戳（beginTime和endTime）是毫秒级Unix时间戳。 - 后续两行是UsageStatsService（使用统计服务）的调试日志，表明它从磁盘获取了131条结果，并记录了当前统计数据的开始时间和结束时间。 根据之前的讨论，UsageStatsService负责记录应用的使用情况，而不直接处理硬件事件（如OTG识别）。因此，这段日志本身并没有提到任何与USB、OTG或硬件相关的内容。 那么，这段日志是否与OTG不识别有关呢？ - **直接关联性低**：日志中未出现USB、OTG、FunctionFS、UsbService等关键词，也没有错误提示（如设备无法识别）。UsageStatsService的日志通常只与应用使用统计相关。 - **间接关联可能**：如果OTG插入后导致某个应用（如文件管理器）被启动或使用，UsageStatsService可能会记录该应用的活动。但这段日志只展示了查询操作和结果数量，没有具体应用信息，无法直接推断OTG状态。 结论：这段日志**与OTG不识别问题无直接关联**，它仅反映UsageStatsService在正常运行（查询并加载应用使用统计数据）。若需排查OTG问题，建议检查UsbService、内核USB驱动或ADB相关日志（如`adb logcat | grep -i 'usb'`）。 §§相关问题§§ 1. UsageStatsService的日志中哪些关键信息可以间接反映OTG设备的使用？ 2. 如何通过日志区分UsageStatsService的正常操作和异常情况？ 3. OTG设备无法识别时，Android系统的哪些核心日志模块需要优先检查？ 4. UsageStatsService的数据库查询时间范围（如beginTime和endTime）如何与系统事件时间关联？ 5. UsageStatsService记录的"results from disk"具体包含哪些数据类型？ </think>### 日志解析与OTG关联性分析 您提供的日志片段属于Android系统UsageStatsService的正常操作记录，**与OTG识别问题无直接关联**。以下是关键解析： 1. **SQL查询分析** `SELECT * FROM 0 WHERE beginTime >= 1760434216618 AND endTime < 1760520616618` - 这是UsageStatsService在查询应用使用统计数据库（表`0`代表设备事件统计表） - 时间范围： `1760434216618` → UTC 2025-10-15 16:30:16.618 `1760520616618` → UTC 2025-10-16 16:30:16.618 - 目的：检索24小时内应用使用事件记录 2. **UsageStatsService日志** - `Got 131 results from disk`：从磁盘加载131条应用使用记录（正常操作） - `Current stats beginTime=1760515444089 endTime=1760520614927`： 当前统计周期为2025-10-16 15:44:04.089至16:30:14.927（约46分钟） - 日志级别`D`(Debug)表明是常规调试信息 --- ### 与OTG不识别问题的关联性 - **无关证据** - ❌ 无USB/OTG关键词（如`UsbService`, `OTG`, `FunctionFS`等） - ❌ 无硬件事件（`USB_ATTACHED`, `USB_CONFIGURED`等广播） - ❌ 无错误提示（如`permission denied`, `unsupported device`等） - **间接关联场景（仅当同时发生）** 若OTG插入**恰好触发应用使用行为**，则可能被记录在此统计中： ```mermaid graph LR OTG插入 --> 启动文件管理器 --> 被UsageStats记录 OTG故障 --> 无应用响应 --> 无相关日志 ``` 但当前日志**未显示任何应用活动记录**，仅体现服务自身数据加载操作。 --- ### 排查建议 若存在OTG识别问题，应检查以下日志： 1. **内核层**：`dmesg | grep dwc3`（USB控制器驱动） 2. **系统层**：`logcat | grep -Ei 'usb|otg'` 3. **广播事件**：`logcat | grep 'ACTION_USB'` 4. **权限日志**：`logcat | grep 'UsbPermission'`
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值