android TraceView 使用方法搜集

一、TraceView简介

      TraceView是AndroidSDK里面自带的工具，用于对Android的应用程序以及Framework层的代码进行性能分析。

      TraceView是图形化的工具，最终它会产生一个图表，用于对性能分析进行说明。

      TraceView可以跟踪到具体的Method

 

 

二、TraceView的原理

      TraceView通过修改code，在需要调试的起始位置加入调试函数，程序运行之后会在SD的根目录下产生*.trace文件来保存运行时的数据，然后把*.trace文件考到pc机上，通过traceview命令对*.trace文件进行分析。

 

二、TraceView的使用

      TraceView使用的前提是无论手机还是模拟器，都要有SD卡的支持，因为它产生的数据文件将会存到SD卡上。对于手机需要插入SD卡，对于模拟器要在建立/启动模拟器的时候加入SD卡的支持就可以了。

      需要TraceView起作用，需要在对code进行修改。具体修改内容如下：

 

 

只要在打算调试的开始位置和结束位置加上相应的函数就可以，至于调试的起始位置的选择需要根据具体情况而定。

    

      通过命令traceview *.trace对数据文件进行分析。

 

四、TraceView举例

      下面的例子是我在一个Activity的里面对于TraceView的应用。

 

 

在这个例子里面特意对init()进行处理，使其耗费比较大的时间。

       通过traceview得到的结果是：

 

 

从这个图里面可以很明显的看到init占用了大量的时间。

 摘自 亨利摩根的专栏 

 

Traceview的使用

已有 10 次阅读2012-5-21 18:14

Traceview是android平台配备的一个很好的性能分析工具。它可以通过图形化的方式让我们了解我们要跟踪的程序的性能，并且能具体到method。

使用Traceview的版本限制

对于Android 1.5及以下的版本：不支持。

对于Android 1.5以上2.1下（含2.1）的版本：受限支持。trace文件只能生成到SD卡，且必须在程序中加入代码。

对于Android 2.2上（含2.2）的版本：全支持。可以不用SD卡，不用在程序中加代码，直接自己用DDMS就可以进程Traceview。

一、Android 1.5以上2.1下（含2.1）的版本中Traceview的使用

首先，必须在程序当中加入代码，以便生成trace文件，有了这个trace文件我们才可以将其转化为图形。

1.1、启动追踪

使用Debug的以下静态方法方法来启动：

static void  startMethodTracing(String traceName)

Start method tracing, specifying the trace log file name.

使用指定trace文件的名字和默认最大容量（8M）的方式开始方法的追踪

static void  startMethodTracing()

Start method tracing with default log name and buffer size.

使用默认trace文件的名字（dmtrace.trace）和默认最大容量（8M）的方式开始方法的追踪

static void  startMethodTracing(String traceName, int bufferSize, int flags)

Start method tracing, specifying the trace log file name and the buffer size.

使用指定trace文件的名字和最大容量的方式开始方法的追踪。并可指定flags.

注：int flags好像没意义。一般都用0.

static void  startMethodTracing(String traceName, int bufferSize)

Start method tracing, specifying the trace log file name and the buffer size.

使用指定trace文件的名字和最大容量的方式开始方法的追踪。

注1：以上的方法的文件都会创建于SD卡下，即"/sdcard/"下，对默认文件名的就是"/sdcard/dmtrace.trace"

如果没SD卡，以上方法会抛异常致使程序crash.

注2：如果文件名没有指定类型，系统为其加上类型.trace

1.2、停止追踪

使用Debug的静态方法方法来停止：

public static void stopMethodTracing ()。

例如在activity的onCreate()中添加Debug.startMethodTracing(), 而在onDestroy()中添加Debug.stopMethodTracing()，

如下：

    @Override

    public void onCreate(Bundle savedInstanceState) {

      Debug.startMethodTracing();

        super.onCreate(savedInstanceState);

      ..............................

     }

protected void onDestroy() {

super.onDestroy();

.................

Debug.stopMethodTracing();

}

对于模拟器我们还得创建一个带有SD card的AVD，这样才能使trace文件保存到/sdcard/...当中。

可以在命令中分别单独创建，也可以在创建avd的时候一起将sdcard创建。创建之后通过DDMS file explore我们就可以看到/sdcard/目录下有一个trace文件，如果没有在Debug语句中设置名字则默认为dmtrace.trace.

注意：需要在AndroidManifest.xml文件中添加android.permission.WRITE_EXTERNAL_STORAGE权限。

1.3、 把trace文件从SD卡拷到电脑上

现在我们把这个文件copy到我们的电脑上指定的目录:

adb pull /sdcard/dmtrace.trace d:

1.4、启动traceview可视界面

现在就可以通过命令行来执行traceview了。进入SDK的tools目录后，执行traceview，如下： 

traceview D:\dmtrace.trace.

之后即可以看到图形界面了。

1.5、分析traceview结果

Timeline Panel

窗口的上半部分是时间轴面图（Timeline Panel）

The image below shows a close up of the timeline panel. Each thread’s execution is shown in its own row, with time increasing to the right. 

Each method is shown in another color (colors are reused in a round-robin fashion starting with the methods that have the most inclusive time). 

The thin lines underneath the first row show the extent (entry to exit) of all the calls to the selected method.

界面上方的尺子代表了MethodTracing的时间段（从Debug.startMethodTracing()到Debug.stopMethodTracing()的时间）。

每个线程的函数执行时间图处于和线程名同一行的右侧。

注1：线宽度代表执行该函数本身操作所用的时间。

注2：函数所调用的子函数时间线夹杂在该函数本身操作所用的时间线之间。

注3：时间线的高度不知道有什么意义。

注4：函数本身是嵌套的。

注5：每行下面粗的线段标注了Profile Panel中被选中函数调用所消耗的时间段。每个线段对应一次函数的运行。

在下面的图中我们可以看到有11次对LoadListener.nativeFinished()的调用，其中有一次调用耗时特别的多。这里的11次和图2并不一致，应该是google的疏忽。

图1The Traceview Timeline Panel

 

Profile Panel

窗口的下半界面是对各个函数调用的汇总图Profile Panel

  Figure 2 shows the profile pane, a summary of all the time spent in a method. 

The table shows both the inclusive and exclusive times (as well as the percentage of the total time). 

Exclusive time is the time spent in the method. 

Inclusive time is the time spent in the method plus the time spent in any called functions. 

We refer to calling methods as "parents" and called methods as "children." When a method is selected (by clicking on it), 

it expands to show the parents and children. Parents are shown with a purple background and children with a yellow background. 

The last column in the table shows the number of calls to this method plus the number of recursive calls. 

The last column shows the number of calls out of the total number of calls made to that method. 

In this view, we can see that there were 14 calls to LoadListener.nativeFinished(); 

looking at the timeline panel shows that one of those calls took an unusually long time.

图2是对各个函数调用的汇总图Profile Panel。该表给出了the inclusive and exclusive times及他们所占有的百分比。

Exclusive time是该函数本身基本操作（不包括子函数调用）的时间。

Inclusive time是该函数调用所用的时间（包括子函数调用）的时间。

列1："Name"表示函数名。

双击函数名，可以看到在上半界面是时间轴面图（Timeline Panel）看他的所消耗的时间段。（用粗的线段标注）。

双击函数名左边的"+"展开后可以看到，该函数的"parents"和"children"

列2："incl%"表示函数的Inclusive time在整个MethodTracing时间里占的百分比。

列3："Inclusive"表示Inclusive time。

列4："Excl%"表示函数的Exclusive time在整个MethodTracing时间里占的百分比。

列5："Exclusive"表示Exclusive time。

列6："Calls+RecurCalls/Total"表示对函数的调用次数（包括递归调用）。如图2的nativeFinished()那列为"14+0"表示14次非递归调用，0次递归调用.

列7：新的版本（比如2.1）还有"time/calls"表示平均的调用时间（即Inclusive time/ total calls）。如图3。来自google文档的图2感觉有老了。

注：如果函数A调用函数B那么函数A称为函数B的"parents"，函数B称为函数A的"children."

图2：Profile Panel

图3：Profile Panel

 

二、Android 2.2以上（含2.2）的版本中Traceview的简化使用。

Android 2.2除了像2.1当中那样使用Traceview，还可以在DDMS使用Traceview，比以前简化的不少。

* The trace log files are streamed directly to your development machine.

在Android 2.2后可以不用SD卡。Traceview文件流是直接指向开发调试的主机（即DDMS所在的电脑）

To start method profiling:

   1. On the Devices tab, select the process that you want to enable method profiling for.

   2. Click the Start Method Profiling button.

   3. Interact with your application to start the methods that you want to profile.

   4. Click the Stop Method Profiling button. DDMS stops profiling your application and opens Traceview with the method profiling information that was collected between the time you clicked on Start Method Profiling and Stop Method Profiling.

 在DDMS中如何进行Traceview。

 1，在设备表中选中你想进行method trace的进程。

 2，单击Method Profiling按钮开始method trace。该按钮在窗口的左上方，它在"stop"按钮的左方，"Device菜单的正下方"。

 3，method trace进行中。

 4，单击Method Profiling按钮停止method trace。紧接着系统会自动弹出Traceview窗口来显示刚才的method trace结果。

三、Traceview文件格式

  关于Traceview文件格式请参照http://developer.android.com/guide/developing/debugging/debugging-tracing.html

 

 

 

 

=================================================

   

【Android游戏开发之十】（优化处理）详细剖析Android Traceview 效率检视工具！分析程序运行速度！并讲解两种创建SDcard方式！

分类： 【 Android 游戏开发】2010-12-29 15:51 8331人阅读 评论(28) 收藏 举报

 李华明Himi 原创,转载务必在明显处注明：
转载自【黑米GameDev街区】 原文链接: http://www.himigame.com/android-game/316.html

 

很多童鞋说我的代码运行后，点击home或者back后会程序异常，如果你也这样遇到过，那么你肯定没有仔细读完Himi的博文，第十九篇Himi专门写了关于这些错误的原因和解决方法，这里我在博客都补充说明下，省的童鞋们总疑惑这一块；请点击下面联系进入阅读：

【Android游戏开发十九】(必看篇)SurfaceView运行机制详解—剖析Back与Home按键及切入后台等异常处理！

   由于本人现在在一家专职做网游的公司，所以现在需要使用一些方法对现运营的网游代码进行精简和优化，那么就要使用到Android sdk中提供的一款很好的检视工具—Android TraceView、下面先给出对此的解释：然后讲解实现的详细步骤和需要特别注意的一点！

 

什么是TraceView？先看下百度出来的解释吧：

Traceview是android平台配备一个很好的性能分析的工具。它可以通过图形化的方式让我们了解我们要跟踪的程序的性能，并且能具体到method。

　　关于Traceview的使用

　　首先，必须在程序当中加入代码，以便生成trace文件，有了这个trace文件才可以将其转化为图形。

　　要添加的代码如下：

　　Java代码

　　// start tracing to "/sdcard/yourActivityTrace.trace"

　　Debug.startMethodTracing("yourActivityTrace");

    // ... // stop tracing Debug.stopMethodTracing();

   // start tracing to "/sdcard/yourActivityTrace.trace" Debug.startMethodTracing("yourActivityTrace");

   // ... // stop tracing Debug.stopMethodTracing();

　　Google Dev Guide当中说可以在activity的onCreate()中添加Debug.startMethodTracing(), 而在onDestroy()中添加Debug.stopMethodTracing()，但是在实际的测试时发现这种方式其实并不好用，因为通常情况下我们的activity的onDestroy()是由系统决定何时调用的，因此可能等了很长时间都不会得到这个trace文件。因此决定在onStop()中来调用Debug.stopMethodTracing()。这样当我们切换到其它activity或者点击home键的时候onStop()就会被调用，我们也就可以得到完整的trace file。

　　在运行程序之前，首先要保证我们的AVD是一个带有SD card的AVD，这样才能使trace文件保存到/sdcard/...当中。运行后可以任意做一些操作，然后点击home键。这是通过DDMS file explore就可以看到/sdcard/目录下有一个trace文件，现在把这个文件copy到电脑上指定的目录，假设是C:/tracefile 目录下。

　　可以通过命令行来执行traceview，进入tools目录后，执行

　　traceview C:/tracefile/yourActivityTrace.trace

　　之后就可以看到图形了，接下来就是按照Google Dev Guide中的解释去分析图形就OK了。

 

 

下面来看如何实现以及需要注意的地方：

 

  实现的步骤分为三步：1.必须先在我们的模拟器中创建sdCard ；2.将我们的调试代码嵌入工程；3.利用TraceView来观察和分析代码情况;

 

1.对于创建模拟器的sdCard这里写出两种方式：

第一种：我们在eclipse中创建avd的时候的时候 在选择api下面有个 Sd Card 的选项，第一项填入创建sdcard的大小即可。

                                         

第二种：cmd 命令！ 打开cmd 并且cd 到android sdk tool 路径下；（或者在环境变量Path中将sdk tool路径配置上，然后重新打开cmd）

使用 mksdcard -l mycard 1024M F:/mysdcard.img 创建了一个1G的sdcard；

使用 emulator -avd my_android -sdcard F:/mysdcard.img 激活sdcard!

最后在eclipse Preferences-->Android-->Launch加入 -sdcard F:/mysdcard.img （此步骤就是在第一种创建方式中添加sdcard的支持）

 

备注1：

     如果sdcard分配的空间太小，则程序追踪文件就一直记录到sd储蓄卡容量慢为止，所以调试前，要为程序生成一个适当的SD存储卡也较为重要,因为程序运行时间越长，这个追踪文件也就越大。

备注2;

(如果第二种创建方式中的第二部激活出现 emulator: ERROR: the user data image is used by another emulator. aborting，请关闭模拟器，或者进入目录： /Documents and Settings / 用户 / .android /的AVD / *设备* / (比如我的目录是：C:/Documents and Settings/Administrator/.android/avd/android2.0.avd)

 

然后删去以.lock结尾的文件夹就行(我简单解释下为什么要删除这些文件呢，其实.lock是加锁，如果程序崩溃等原因导致无法清除这些以.lock结尾的文件夹，就会出现这个问题，也就是这个avd的锁没有被释放，导致avd　manager以为这个avd正在使用当中。))

 

 

2.将我们的调试代码嵌入工程

 正如我们百度到的说明一样，在程序运行的开端加上 　Debug.startMethodTracing("yourActivityTrace");  然后在onPause（）中调用Debug.stopMethodTracing(); 为什么要将结束写在onPause（）中而不写在onStop（），那么如果你去看api的话，你会看到，Api中介绍onPause（）会在你返回和点击home按键后触发，而onStop（）一般是由系统来触发，当该程序处于后台的时候，而且当内存紧张的时候，可能会调用，但是可能永远不会调用到！

备注：要记住当把调试代码加入项目中以后不要立即运行项目，而是必须在AndroidMainfest.xml中定义一条"写入SD卡的权限"那么添加权限的代码如下：

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

因为咱们的调试代码会在SD卡中生成一个追踪文件，也就是往SD卡中写入了数据，所以需要声明一条权限。这里必须注意哦！

[java:showcolumns] view plaincopy

·········10········20········30········40········50········60········70········80········90········100·······110·······120·······130·······140·······150

1. <?xml version="1.0" encoding="utf-8"?>  
2. <manifest xmlns:android="http://schemas.android.com/apk/res/android"  
3.       package="com.himi"  
4.       android:versionCode="1"  
5.       android:versionName="1.0">  
6.     <application android:icon="@drawable/icon" android:label="@string/app_name">  
7.         <activity android:name=".MainActivity"  
8.                   android:label="@string/app_name">  
9.             <intent-filter>  
10.                 <action android:name="android.intent.action.MAIN" />  
11.                 <category android:name="android.intent.category.LAUNCHER" />  
12.             </intent-filter>  
13.         </activity>  
14.     </application>  
15.     <uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"></uses-permission>  
16.     <uses-sdk android:minSdkVersion="4" />  
17. </manifest>   

 

 

 

3.运行项目并且退出项目从而得到的追踪文件，利用TraceView来进行分析代码运行状况：

打当正常运行了项目并且点击返回或者home按键就会在 sdcard中生成一个.trace的文件。sdcard 目录 在eclipse下，点击:

windows-show view-other-android-File explorer 

                                    

右上角的两个箭头，第一个表示从模拟器sdcard导出文件，第二个表示从PC上导入文件到sdcard中、“—”代表删除 .....

然后我们通过cmd来运行生成的追踪文件  traceview C:/name      追踪文件所在的路径放在C盘，放在C盘以外别的盘的话我这里是无法正常打开traceview的不知道什么原因。   name 表示生成的.trace文件，cmd的时候不需要输入“.trace”后缀 ;然后会出现TraceView的分析窗口;

【cmd 命令！ 打开cmd 并且cd 到android sdk tools 路径下；（或者在环境变量Path中将sdk tool路径配置上，然后重新打开cmd）】

 

注意1：如果出现一下图片这种内存溢出的问题;

 

 

解决方法：到SDK 下的tools 下 找到  traceview.bat 文件，鼠标右键-编辑（或者记事本打开），最后一行替换成这样：

 

call java -Xms128m -Xmx512m -Djava.ext.dirs=%javaextdirs% -jar %jarpath% %*

 

注意2：如果出现路径不对的问题：

例如：我的 himi.trace 放在了C盘,那么我的cmd命令是:   traceview c:/himi   然后回车！

但是这里要小心，因为 /h 这样可能被认为是转义字符！！！为了避免可以尽可能不要使用h,n,r,t,等等成为名字的头字母，当然还有一种就可以完全避免这种问题，例如还是我的C盘 himi.trace 文件，可以写cmd命令的时候写成： traceview c://himi   嘿嘿~要注意细节。 

 

下面是运行起来的TranceView：

 

 

 

最右上角表示运行程序总共用了多少时间，从traceview画面中我们看到有各种颜色，每种颜色代表不同的函数和步骤，那么同一颜色的区域越大，就代表这个步骤运行时间越长，或者看到下面的统计表，明显可以看出除了序列 0 1 是系统函数外，2. 3.函数 占用的时间比较长，那么序列4是个自定义的函数名为 “hot”这个占用了几乎与主线程 主draw的时间一样了，那么肯定有问题。当然其实这个方法是我故意写的，就是为了来演示traceview。这个hot函数的代码如下：

[java:showcolumns] view plaincopy

·········10········20········30········40········50········60········70········80········90········100·······110·······120·······130·······140·······150

1. /** 
2.  * @author Himi 
3.  * @param canvas 
4.  */  
5.     public void hot(Canvas canvas) {  
6.         for (int i = 1; i < 100; i++) {  
7.             Bitmap bmp = BitmapFactory.decodeResource(getResources(),  
8.                     R.drawable.icon);  
9.             canvas.drawBitmap(bmp, i += 2, i += 2, paint);  
10.         }  
11.     }  

 

很明显我在故意消耗内存和时间。

 

那么，在traceview的右半部统计字段中:

Exclusive: 同级函数本身运行的时间

Inclusive 就是说除统计函数本身运行的时间外再加上调用子函数所运行的时间

 

Name：列出的是所有的调用项，前面的数字是编号，展开可以看到有的有Parent 和Children子项，就是指被调用和调用。

Incl: inclusive时间占总时间的白分比

Excl: 执行占总时间的白分比。

Calls+Recur Calls/Total: 调用和重复调用的次数

Time/Call: 总的时间。(ms)

 

所以traceview是个非常好的程序监视工具，可以帮助找出程序运行缓慢时的函数，让我们的代码不断完善和改进！

 

 

 

android工具之TraceView学习笔记

 

 

| 来源：中国手机开发网 | 2010年09月02日 | [字体：小 大] | 点击推荐给好友

关键词：

　　如何分析Android应用性能，java函数调用关系。

　　1.mksdcard -l sdcard 512M /root/.android/sdcard.img

　　2.在应用程序中加入trace 的开始和结束函数(详细说明参考开发文档)

　　// start tracing to "/sdcard/calc.trace"

　　Debug . startMethodTracing ( "calc" ); --------calc是你要生成的.trace文件的名字

　　// ..

　　// stop tracing

　　Log.d("lizhenghui","NNNNNNN stop traceview debug");

　　Debug . stopMethodTracing ();

　　3 . 在eclipse 的run Configuraton-->Target 项的 Additional Emulator Command Line Options下指定Emulator启动时的sdcard目录： -sdcard /root/.android/sdcard.img

　　4.从eclipse运行android运用。

　　5. 退出运用程序， 用logcat 查看上面的log信息是否出现，确保trace文件不为空。

　　6。adb ls /sdcard/

　　会看到一个文件：calc.trace 就是我们需要的文件。

　　7。把trace文件下载到本地。

　　adb pull /sdcard/calc.trace ./

　　8。traceview calc.trace

　　打开了trace文件，用点耐心看看帮助文档，可以知道这个文件上部分为时间关系图，反映的就是在什么时间执行什么函数，下部分为函数关系图，反映的就是函数的调用关系。下部分各项的含义：

　　Name：列出的是所有的调用项，前面的数字是编号，展开可以看到有的有Parent 和Children子项，就是指被调用和调用。

　　Incl: inclusive时间占总时间的白分比

　　inclusive: 调用占用时间。(包括了所有的子方法的调用时间)

　　Excl: 执行占总时间的白分比。

　　Exclusive: 执行时间，不包含子方法的时间。

　　Calls+Recur Calls/Total: 调用和重复调用的次数

　　Time/Call: 总的时间。(ms)

　　9.生成函数调用关系图

　　A. apt-get install graphviz

　　B. dmtacedump -g aa.png calc.trace

　　C. ls 查看是否生成aa.png 图片。

　　10。用图片工具打开图片。

　　11。图片上函数显示格式 (用开发文档上的做例子，我用的是远程外网)

　　< ref > callname (< inc-ms >, < exc-ms >,< numcalls >)

　　ref -- 编号

　　callname -- 函数名

　　< inc--ms >--调用时间

　　< exc-ms > -- 执行时间

　　< numcalls > -- 被调用的次数

http://developer.android.com/guide/developing/debugging/debugging-tracing.html