一、准备工作
确保机器上已经安装并配置下列软件环境:JDK/ Eclipse / Android SDK / ADT
即,机器上已经安装了Eclipse下Android应用开发所需的环境。如果还未配置,移步《搭建Windows下Android应用开发环境——Eclipse/Android/ADT》。
另外,为了跟踪调试Android源码,你还需要有Android源码,并有源码的编译环境,可以是:
- 虚拟机环境 虚拟机中安装Linux,Linux下编译Android源码。此环境下,如果要在宿主机的Eclipse中调试,还需要把Android的源码路径共享出来,宿主机可访问到;
- 有单独的可编译Android的网络环境 在你的客户端的机器上访问服务器共享出来的Android的源码路径;
- Linux环境下直接通过Eclipse跟踪调试本机上的Android源码。
注意:不管哪种工作方式,Android源码要都是已经编译过的,且编译时采用的是Eng模式(vs User mode)。编译Android Platform和Kernel的过程,可参考《Ubuntu10.10下编译Android2.2平台》及《Ubuntu10.10下编译Android2.2内核》。
准备工作完毕之后,现在做一些基本的设置。
1. 把Android源码路径<Android_ROOT>下的development\ide\eclipse中的.classpath文件复 制到<Android_ROOT>下;如果需要在模拟器中进行调试的话,需要复制三个img(具体方法见http://wenku.baidu.com/view/26d9063c87c24028915fc366.html)
2. 修改Eclipse的设置
修改eclipse.ini文件,更改下列内容:
- -Xms40m
- -Xmx384m
改为:
- -Xms128m
- -Xmx512m
这里增大最小Java堆大小到128MB,增大最大Java堆大小到512MB。
1. File > New > Java Project
2. 输入项目名
3. 取消Use default location,并在Location中输入或选择Android源码路径<Android_ROOT>
4. 选择Next > Finish。会有一个漫长的等待过程
新建的工程可能会有错误,根据错误提示,加入或者删除项目中配置的程序包。
1. 右击刚刚在#3中创建的项目;
2. 选择:Debug As > Debug Configurations…;
3. 右击“Remote Java Application”,选择New。或者直接双击“Remote Java Application”创建一个新的Remote Application。
4. 填入Name;Project选择刚刚创建的项目Android2.3.7;端口填写8700(不一定是8700,到DDMS Perspective下的Device View中看所需的端口号)。
5. Apply保存,然后退出。
可以通过模拟器或者真机调试。
无论模拟器还是真机,都要:
- 先启动机器(模拟器启动,或真机打开,并通过USB与PC正常连接),也就是要在DDMS Perspective的Devices视图中看到有机器连接;
- 确保运行中的代码与你要调试的代码是一样的。
假如,我们想要跟踪锁屏解锁的调用情况。
我们知道解锁的实现是在LockScreen.java的onGrabbedStateChange()函数,运行在system_process进程中。
那么,
1. 在onGrabbedStateChange()中要调试的地方设置断点;
2. 在Device View中,选中system_process,并点击小爬虫图标;
3. 用Section#4创建的Debug配置,Debug;
4. 在模拟器或真机上,执行到解锁操作时,代码就会停在断点处;
这样你就可以,
- 把鼠标放在某个变量上,看它的值。也可以Eclipse中的各种调试手段调试你的代码。
- 通过Step Into / Step Over / Resume / Suspend / Terminate等在Debug View中控制程序的执行。
通过本文可以:
- 本文讲解是基于Windows环境的,但是不仅适用于Windows环境,同样适用于Mac OS和Linux系统,只是一些路径和使用方式有差别;
- 可以跟踪/调试所有Android中Java的源码(无论Framework的代码,还是App中的代码),并不能Debug Framework中的c/c++ code;
- 为了使整个项目在Eclipse中都能编译过,.classpath中也包含了out/里编译生成的内容,所以必须保证Android源码是已经编译过的。
- 跟踪/调试的前提是要在所要调试代码处设置断点,并知道该处代码执行在哪个进程中。
如果导入的工程有错误,可以参照下面方法操作。
===================================================================================================================
我们导入一个android自带应用的工程时,往往有很多错误。以自带的 AlarmClock 为例,导入eclipse后,往往出现很多错误,如下图所示:
例如,上图中的Intent.ACTION_ALARM_CHANGED 无法访问,下面我们就找到源代码看看原因何在?
根据java 编程规范,我们知道这个api (静态变量)被隐藏掉了,所以在sdk中无法使用。在知道了原因之后,我们有几种解决方案(建议使用方法二):
如下图:
之后我们的工程错误消失了:
到此问题基本解决。
按网上某位大侠所说的方法,在eclipse里导入android源码后,执行右键“debug as - debug configurations..”,在弹出来的窗口中设置了远程端口(8700)等相关设置。在java中设置断点后,打开模拟器,发现并没有进入debug状态,打开ddms窗口,可以看到正在连接的device和下面的相关进程,选择某个程序包,手动点击工具栏上的虫子图标,却提示"No open project found for ..... debug session failed"。经过反复测试,终于发现,按照下面的方式操作,一般是没有问题的:
操作方法:
1.先打开模拟器,并打开要调试的程序(这样ddms中才能看到该程序包)
2.启动ddms,选中需要调试的程序(切记)
3.切换到java界面,在项目上单击右键,执行debug config(设置端口8700和相关参数),然后再执行debug,此时如果切换到ddms窗口,可以看到选中要调试的程序包前面自动有一个小虫子的图标:) 这时候,再在模拟器上操作,一般都是可以成功进入debug窗口跟踪调试的。
注:每次只能调试一个程序。如果要调试另一个程序,重新执行第2和第3步。