AppMethodOrder

Introduction: 一个能让你了解所有函数调用顺序的 Android 库(无需侵入式代码)
More: Author   ReportBugs   
Tags:

背景:当项目代码量很大的时候,或者你作为一名新人要快速掌握代码的时候,给函数打上 log,来了解代码执行逻辑,这种方式会显然成本太大,要改动项目编译运行,NO!太耗时;或者你想 debug 的方式来给你想关注的几个函数,来了解代码执行逻辑,NO!因为你肯定会漏掉函数;也许你可以固执的给你写的项目打满 log 说这样也行,但是你要知道你方法所调用的 jdk 的函数或者第三方 aar 或者 jar 再或者 android sdk 中的函数调用顺序你怎么办,还能打 log 吗?显然不行吧,来~这个项目给让可以让你以包名为过滤点过滤你想要知道所有函数调用顺序。

项目地址:https://github.com/zjw-swun/AppMethodOrder 欢迎 star

作者列表(排名按代码贡献时间顺序):二精-霁雪清虹,xingstarx,大精-wing,pighead4u ,lijunjie,三精-虹猫,Harlber

图片描述

动作简介:首先点击 MainActivity 的自定义 MyTextView 然后进入 SecondActivity 再点击 textview 之后 finish 跳转回 MainActivity
下面是库处理过所得到的函数调用顺序order.txt文件(我这里屏蔽了 jdk 函数,第三方库函数,以及 android sdk 中函数,换句话说我就保留了我自己包名中的函数顺序)

832 ent     67593 .....com.zjw.appmethodorder.MainActivity.onClick (Landroid/view/View;)V    MainActivity.java
832 ent     99956 ..........com.zjw.appmethodorder.MainActivity.onPause ()V    MainActivity.java
832 ent     99970 ...........com.zjw.appmethodorder.BaseActivity.onPause ()V    BaseActivity.java
832 ent    100472 ............com.zjw.appmethodorder.BaseActivity.baseOnPause ()V    BaseActivity.java
832 ent    128540 ........com.zjw.appmethodorder.SecondActivity.<init> ()V    SecondActivity.java
832 ent    128562 .........com.zjw.appmethodorder.BaseActivity.<init> ()V    BaseActivity.java
832 ent    213911 ........com.zjw.appmethodorder.SecondActivity.onCreate (Landroid/os/Bundle;)V    SecondActivity.java
832 ent    213928 .........com.zjw.appmethodorder.BaseActivity.onCreate (Landroid/os/Bundle;)V    BaseActivity.java
832 ent    258414 ..........com.zjw.appmethodorder.BaseActivity.baseOnCreate ()V    BaseActivity.java
832 ent   1440503 .........com.zjw.appmethodorder.SecondActivity.onResume ()V    SecondActivity.java
832 ent   1440563 ..........com.zjw.appmethodorder.BaseActivity.onResume ()V    BaseActivity.java
832 ent   1445675 ...........com.zjw.appmethodorder.BaseActivity.baseOnResume ()V    BaseActivity.java
832 ent   2954291 .................com.zjw.appmethodorder.MyTextView.onWindowVisibilityChanged (I)V    MyTextView.java
832 ent   3065664 ........com.zjw.appmethodorder.MainActivity.onStop ()V    MainActivity.java
832 ent   3065701 .........com.zjw.appmethodorder.BaseActivity.onStop ()V    BaseActivity.java
832 ent   3069155 ..........com.zjw.appmethodorder.BaseActivity.baseOnStop ()V    BaseActivity.java
832 ent   3139519 .......com.zjw.appmethodorder.SecondActivity.click (Landroid/view/View;)V    SecondActivity.java
832 ent   3146300 ........com.zjw.appmethodorder.SecondActivity.finish ()V    SecondActivity.java
832 ent   3183478 ..........com.zjw.appmethodorder.SecondActivity.onPause ()V    SecondActivity.java
832 ent   3183498 ...........com.zjw.appmethodorder.BaseActivity.onPause ()V    BaseActivity.java
832 ent   3183843 ............com.zjw.appmethodorder.BaseActivity.baseOnPause ()V    BaseActivity.java
832 ent   3209420 ........com.zjw.appmethodorder.MainActivity.<init> ()V    MainActivity.java
832 ent   3209438 .........com.zjw.appmethodorder.BaseActivity.<init> ()V    BaseActivity.java
832 ent   3283359 ........com.zjw.appmethodorder.MainActivity.onCreate (Landroid/os/Bundle;)V    MainActivity.java
832 ent   3283378 .........com.zjw.appmethodorder.BaseActivity.onCreate (Landroid/os/Bundle;)V    BaseActivity.java
832 ent   3330938 ..........com.zjw.appmethodorder.BaseActivity.baseOnCreate ()V    BaseActivity.java
832 ent   4363295 .....................com.zjw.appmethodorder.MyTextView.<init> (Landroid/content/Context;Landroid/util/AttributeSet;)V    MyTextView.java
832 ent   4436094 ..................com.zjw.appmethodorder.MyTextView.onFinishInflate ()V    MyTextView.java
832 ent   4449689 .........com.zjw.appmethodorder.MainActivity.initView ()V    MainActivity.java
832 ent   4539427 .........com.zjw.appmethodorder.MainActivity.onResume ()V    MainActivity.java
832 ent   4539467 ..........com.zjw.appmethodorder.BaseActivity.onResume ()V    BaseActivity.java
832 ent   4543597 ...........com.zjw.appmethodorder.BaseActivity.baseOnResume ()V    BaseActivity.java
832 ent   4917854 .................com.zjw.appmethodorder.MyTextView.onAttachedToWindow ()V    MyTextView.java
832 ent   4918658 .................com.zjw.appmethodorder.MyTextView.onWindowVisibilityChanged (I)V    MyTextView.java
832 ent   5090653 ...................................com.zjw.appmethodorder.MyTextView.onMeasure (II)V    MyTextView.java
832 ent   5355203 ..................................com.zjw.appmethodorder.MyTextView.onMeasure (II)V    MyTextView.java
832 ent   5456681 .......................................com.zjw.appmethodorder.MyTextView.onSizeChanged (IIII)V    MyTextView.java
832 ent   5467577 ....................................com.zjw.appmethodorder.MyTextView.onLayout (ZIIII)V    MyTextView.java
832 ent   5876623 ...........................................com.zjw.appmethodorder.MyTextView.onDraw (Landroid/graphics/Canvas;)V    MyTextView.java
832 ent   6121967 ........com.zjw.appmethodorder.SecondActivity.onStop ()V    SecondActivity.java
832 ent   6121986 .........com.zjw.appmethodorder.BaseActivity.onStop ()V    BaseActivity.java
832 ent   6123689 ..........com.zjw.appmethodorder.BaseActivity.baseOnStop ()V    BaseActivity.java
832 ent   6127522 ........com.zjw.appmethodorder.SecondActivity.onDestroy ()V    SecondActivity.java
832 ent   6127679 .........com.zjw.appmethodorder.BaseActivity.onDestroy ()V    BaseActivity.java
832 ent   6133301 ..........com.zjw.appmethodorder.BaseActivity.baseOnDestroy ()V    BaseActivity.java

2. 原理篇

废弃 dmtracedump 解析,采用 android studio 官方源码解析方案(官方 android studio 解析 trace 的移植版版本),核心代码详见com.android.tools.perflib.vmtrace.VmTraceParser类,相比之前的方案无需再配置 dmtracedump 环境变量,以及兼容 android studio 3.1 及其以后掐表生成的 trace 格式。

3. 使用方法

3.1 生成 trace 文件的方式

生成 trace 文件的方式有 2 种操作,一种是在项目中使用代码操作 即android.os.Debug.startMethodTracing();android.os.Debug.stopMethodTracing();,执行完stopMethodTracing将会在您手机 app 的 sdcard 下面生成.trace文件,该方式不区分版本,dumtracedump 可解析
第二种方式是掐表生成 trace 文件
android studio 3.0 之前版本操作如下
第一次点击下图时钟 icon 代表开始掐表,然后回到您的 app,进行您要跟踪函数调用顺序的操作,再次点击下图时钟 icon 代表结束掐表 图片描述 掐表结束后即会在 captures 目录生成com.zjw.appmethodorder_2017.03.25_21.41.trace文件,android studio 会默认打开一个可视化窗口

图片描述

android studio 3.0 版本操作如下

点击 CPU 进入 CPU 面板,然后选择 Instrumented 选项(Sampled 和 Instrumented 区别在于,Sampled 函数调用采样率低生成的 trace 文件小,采样率低会造成大部分函数调用顺序漏记,Instrumented 相当于无损采样生成文件大),第一次点击下图红色圆形 icon 代表开始掐表,然后回到您的 app,进行您要跟踪函数调用顺序的操作,再次点击下图红色圆形 icon 代表结束掐表, 图片描述 图片描述 结束掐表就会在C:\Users\hasee\AppData\Local\Temp\cpu_trace.trace(本人是 windows 环境,使用 windows 系统可以参照,使用 Mac 的同学 cd /private/var/folders 在 folders 搜索 cpu_trace.trace),存在 cpu_trace.trace 时会新建 cpu_trace1.tracecpu_trace2.trace 以此类推

android studio 3.1 开始,掐表默认实现改成 cpu profiler

详见https://developer.android.google.cn/studio/profile/cpu-profiler,如果掐表生成的 trace 文件可以用文本编辑器打开看是否开头带有"slow"字样,dmtracedump 无法解析,但是现在的小工具是基于最新 android studio 源码实现,支持此种 trace 格式啦啦啦!。android studio 3.4 掐表生成 trace 文件在 cpu 面板右键支持自定义路径的 export 导出。

3.2 appMethodOrder 小工具使用

appMethodOrder 小工具 下载地址AppMethodOrderUtils.jar
appMethodOrder 小工具 源码地址AppMethodOrderUtils.zip appMethodOrder 小工具改良自 https://github.com/Harlber/Method_Trace_Tool 感谢 Harlberhttps://github.com/Harlber

好消息,现在小工具使用无需配置 dmtracedump 环境变量了!开箱即用!!!

将 trace 文件拖拽到小工具File Path左边区域 图片描述 package name处填入您需要过滤的目标包名,或者填入空串(空串将生成所有线程所有包名的函数调用顺序)

图片描述

如上图所示,查询结构存在四个 tab,第一个threadID代表线程 id,第二个threadName代表线程名,第三个usecs代表函数耗时(单位微秒,有时候耗时为 0 不要惊讶,是因为该次掐表刚好没包括到其函数结束时机),第四个method代表函数名,(查询结果是以时间排序的)

特别注意 这里注意 android studio 3.1 以后掐表生成的 trace 解析的时候 时间耗时有点小问题(官方代码的问题),在一段时间内函数 ent 给出的 threadTime 都是一致的,这里需要小小的注意一下,所以 3.1 以后掐表要看耗时的朋友,建议还是在 studio 面板看相对耗时,或者使用代码方式生成 trace 文件。

4. 海量信息的处理手段

不难发现 trace 文件时间越长意味着记录的信息也会越来越多,这时候单纯以包名过滤其实满足不了需求,比如我们想通过 3 个条件(例如 主线程+含 zjw 包名的 or android.view)来过滤出结果,以下将给出解决办法。

appMethodOrder 小工具会在该 jar 所在目录生成appMethodOrderTrace.txt,以文本方式记录查询结果。 我们可以借助数据库这个工具使用查询语句来帮助我们过滤出有用的信息,可以使用以下数据库命令,把appMethodOrderTrace.txt内容导入到数据库表中 //从 text 导入数据到 mysql (以下语句在 mysql 中实验是 OK 的)

truncate table app;
LOAD DATA LOCAL INFILE 'C:/Users/hasee/Desktop/appMethodOrderTrace.txt' INTO TABLE `app`;

图片描述

app 表结创建语句如下

CREATE TABLE `app` (
  `threadId` int(11) DEFAULT NULL,
  `threadName` varchar(255) DEFAULT NULL,
  `usecs` varchar(255) DEFAULT NULL,
  `method` varchar(255) DEFAULT NULL,
) ENGINE=InnoDB DEFAULT CHARSET=utf8;

查询语句示范 //查询 main 线程中 自定义包下最耗时的操作(以毫秒为单位,降序) SELECT threadName, usecs/1000, method FROM app WHERE app.threadName = "main" AND method like "%自定义包名%" ORDER BY app.usecs DESC 图片描述

5. 计算得出的函数耗时不是准确的时间

根据官方文档(https://developer.android.com/studio/profile/traceview.html) Interpreted code runs more slowly when profiling is enabled. Don't try to generate absolute timings from the profiler results (such as, "function X takes 2.5 seconds to run"). The times are only useful in relation to other profile output, so you can see if changes have made the code faster or slower relative to a previous profiling run.所知(我也用了代码在函数开头结尾用 System.nanoTime()时间相减,发现,生成 trace 的时候确实会拖慢所以函数的执行时间,比 System.nanoTime()时间相减得出的时间差的比较多)。原因是 trace 过程会整体拖慢 JVM 执行,因此函数耗时只是一个参考值,比较哪个函数更耗时是可以的。

Apps
About Me
GitHub: Trinea
Facebook: Dev Tools