如何调试跟踪Android Framework源代码

如何使用Eclipse调试Sonatype Nexus源代码~

1. 正确安装部署Nexus并修改Nexus目录下的\bin\jsw\conf文件夹下的wrapper.conf文件
找到以下几行，全部取消注释。这里的8000表示的是Eclipse远程调试监听的端口。默认是8000。
#wrapper.java.additional.1=-Xdebug
#wrapper.java.additional.2=-Xnoagent
#wrapper.java.additional.3=-Djava.compiler=NONE
#wrapper.java.additional.4=-Xrunjdwp:transport=dt_socket,server=y,suspend=y,address=8000
#wrapper.java.additional.5=-XX:+HeapDumpOnOutOfMemoryError


2. 启动Nexus，这时Nexus会停在启动界面


3. 启动Eclipse，并配置远程调试的监听，


4. 点击Debug即可。注意，这时Eclipse的debug界面可以看到线程不断增多，而cmd的控制台打印启动信息，稍等片刻即启动成功。：

线程会逐渐增多


命令行打印启动信息


启动完成！！

5. 试验一下，给MavenCoordinatesSearcher类的public boolean canHandle( final Map terms )打个断点，然后页面使用GAV搜索junit，进断点了！！

在要调试进程的合适位置打上断点
跟踪代码（Stepin/out/over等等）
在展开讲述这两方面之前，有必要先简单了解下调试的基础知识。
Java平台的调试是有一个规范化的标准的，那就是JPDA（JavaPlatformDebuggerArchitecture）；
通过JPDA提供的API，开发人员可以方便灵活的搭建Java调试应用程序。
JPDA主要由三个部分组成：Java虚拟机工具接口（JVMTI），Java调试线协议（JDWP），以及Java调试接口（JDI）。

本文讲解如何在Eclipse中导入Android源代码（包括Framework和Application的代码），然后通过模拟器或真机跟踪/调试Android的Java代码，区别于一般基于Android SDK的纯应用开发，这里可以跟踪/调试Framework中的代码。

一、准备工作

确保机器上已经安装并配置下列软件环境：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文件，更改下列内容：

[plain] view plaincopy

• -Xms40m  

• -Xmx384m  

改为：

[java] view plaincopy

• -Xms128m  

• -Xmx512m  

这里增大最小Java堆大小到128MB，增大最大Java堆大小到512MB。

三、Eclipse中创建工程

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中无法使用。在知道了原因之后，我们有几种解决方案（建议使用方法二）：


1. 自己将源代码中的@hide去掉，然后编译一个sdk来替换默认的sdk。
在linux上使用  make PRODUCT-sdk-sdk 命令，编译一个新的sdk出来,注意编译后其实我们不需要整个sdk，只需要android.jar这个文件替换掉sdk里的android.jar,例如：笔者的sdk里的jar对应的目录为:
F:/Program Files/Android/android-sdk-windows/platforms/android-8/android.jar
具体编译sdk的方法是，在linux编译环境下用命令 make PRODUCT-sdk-sdk ，成功后，会有如下提示: 
Package SDK: out/host/linux-x86/sdk/android-sdk_eng.stevewang_linux-x86.zip
我们进入到 linux编译环境的 out/host/linux-x86/sdk/android-sdk_eng.stevewang_linux-x86/platforms/android-2.2/目录下可以看到android.jar 文件。使用此文件替换   F:/Program Files/Android/android-sdk-windows/platforms/android-8/android.jar 即可。替换前记得备份
此方法较为麻烦，建议使用方法二


2. 添加framework 编译出来的class.jar文件到 eclipse的build path
其实在编译android的时候，我们将framework 编译到一个临时的jar包中了，这个jar包的路径一般为: 
out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes.jar
[font='dejavu]我们只需要在linux上android源代码目录下使用make 命令即可生成此文件。
[font='dejavu]
[font='dejavu]由于这个jar文件中的api 还没有重新打包，里面被@hide掉的api并没有被去掉。所以我们依然能够引用里面
[font='dejavu]被@hide的api 。而sdk 中的android.jar文件时重新打包生成的，其里标记有@hide的api已经被去掉了。
[font='dejavu]所以我们把 out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes.jar 拷贝到本地pc上。
然后在工程中添加此jar包。
具体方法: 
1 . 拷贝linux编译生成的  out/target/common/obj/JAVA_LIBRARIES/framework_intermediates/classes.jar到本机PC。
2，在eclipse的Android项目中，选择项目属性->Java Build Path->Libraries->Add Library->User Library->Next-> UserLibraries进入到User Libraries管理界面，点击New新建一个User Library，比如android_framework，点击Add Jars把Jar包加入到建立的User Library中，最后点击OK。
3.选择项目属性->Java Build Path->Order and Export，把所建立的User Libraries移到Android SDK的上面。

如下图:

之后我们的工程错误消失了：

一、准备工作

确保机器上已经安装并配置下列软件环境：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

2. 修改Eclipse的设置

修改eclipse.ini文件，更改下列内容：

-Xms40m      -Xmx384m  

改为：

-Xms128m      -Xmx512m  

这里增大最小Java堆大小到128MB，增大最大Java堆大小到512MB。

三、Eclipse中创建工程

1. File > New > Java Project

3. 输入项目名

4. 取消Use default location，并在Location中输入或选择Android源码路径<Android_ROOT>

5. 选择Next > Finish。会有一个漫长的等待过程
   新建的工程可能会有错误，根据错误提示，加入或者删除项目中配置的程序包。

6. 调试环境配置

7. 右击刚刚在#3中创建的项目；

8. 选择：Debug As > Debug Configurations…；

9. 右击“Remote Java Application”，选择New。或者直接双击“Remote Java Application”创建一个新的Remote Application。

11. 填入Name；Project选择刚刚创建的项目Android2.3.7；端口填写8700（不一定是8700，到DDMS Perspective下的Device View中看所需的端口号）。
    5. Apply保存，然后退出。

12. 调试 可以通过模拟器或者真机调试。无论模拟器还是真机，都要：
    
    

13. 先启动机器（模拟器启动，或真机打开，并通过USB与PC正常连接），也就是要在DDMS Perspective的Devices视图中看到有机器连接；

14. 确保运行中的代码与你要调试的代码是一样的。



15. 假如，我们想要跟踪锁屏解锁的调用情况。


16. 我们知道解锁的实现是在LockScreen.java的onGrabbedStateChange()函数，运行在system_process进程中。



17. 那么，在onGrabbedStateChange()中要调试的地方设置断点；

18. 在Device View中，选中system_process，并点击小爬虫图标；



19. 用Section#4创建的Debug配置，Debug；



20. 在模拟器或真机上，执行到解锁操作时，代码就会停在断点处；

22. 这样你就可以，把鼠标放在某个变量上，看它的值。也可以Eclipse中的各种调试手段调试你的代码。

23. 通过Step Into / Step Over / Resume / Suspend / Terminate等在Debug View中控制程序的执行。

---

薛城区15716749640： 如何调试跟踪Android Framework源代码 - ？
澄吴联邦： 1. 首先,得到Android 源代码(可参考之前的文章--如何获取Android源代码并编译.doc),并且编译,得到output file,在(Android source)/out目录下,也可通过别的途径获取Android source code (以androidsrc.tgz为例) 和别人编译好的 ...

薛城区15716749640： 如何调试Android Framework - ？
澄吴联邦： 其实整个调试过程非常简单:在你要调试进程的合适位置打上断点 跟踪代码(Step in/out/over等等) 在展开讲述这两方面之前,有必要先简单了解下调试的基础知识.Java平台的调试是有一个规范化的标准的,那就是JPDA(Java Platform ...

薛城区15716749640： android studio 怎么跟踪一个变量 - ？
澄吴联邦： 有Log输出和debug 这2种方式:1. Log输出. Log.i(＂tag＂,＂this is you log info＂);2. debug模式. 在需要跟踪变量的地方设置断点,用调试模式(DEBUG)打开,然后F5可以单独调试,非常方便,推荐使用!

薛城区15716749640： android studio怎么debug调试 - ？
澄吴联邦： Android Studio有两种调试模式可供参考,一个是直接进入调试模式,另一个是进程调试(以下均是android studio的截图) 一、调试模式 二、进程调试 经验:一般来说,当程序一启动等等不好一个界面一个步骤的跟踪的时候,可以采用第一个方式,当只需要调试某一个界面/某一个执行步骤的时候,可以采用第二种方式,当然也可以加上Log日志来配合调试.

薛城区15716749640： android studio 怎么用debug调试 - ？
澄吴联邦： 1. 【Ctrl+Shift+B】:在当前行设置断点或取消设置的断点. 2. 【F11】:调试最后一次执行的程序. 3. 【Ctrl+F11】:运行最后一次执行的程序. 4. 【F5】:跟踪到方法中,当程序执行到某方法时,可以按【F5】键跟踪到方法中. 5. 【F6】:单步执行程序. 6. 【F7】:执行完方法,返回到调用此方法的后一条语句. 7. 【F8】:继续执行,到下一个断点或程序结束.

薛城区15716749640： 哪里查看android framework code - ？
澄吴联邦： Android平台代码很多,关系也很复杂,通常我们调试程序的时候是无法跟踪到Android framework code里的,如果能调试跟踪Android source code将给我们这些初学者带来很多便利,本文将给出一个调试跟踪Android source code 的方法. 1. ...

薛城区15716749640： 如何通过wifi调试android程序 - ？
澄吴联邦： 1.首先让android手机来监听指定的端口:这一步需要使用shell,因此手机上要有终端模拟器,不过网上很多,随便找个就行了,依次敲入下列几行:su//获取root权限 setprop service.adb.tcp.port 5555//设置监听的端口,端口可以自定义,如5554,5555是默认的 stop adbd//关闭adbd start adbd//重新启动adbd2.手机连接wifi并确保手机和电脑连接同一个网络 ,记下手机的ip地址,假设为a.b.c.d3.电脑上打开命令提示符,敲入以下命令:

薛城区15716749640： eclipse怎样使用logcat日志调试安卓程序 - ？
澄吴联邦： 方法/步骤 首先我们在需要调试的地方使用Log函数.点击菜单Window->Show View->Other....双击展开“Android”,点击“LogCat”,再点击“OK”.点击绿色的加号.输入Filter Name和By Log Tag.注:By Log Tag一定要和之前Log函数输入的一致,Filter Name可以随便起.6启动调试,点击“TestLog”就可以查看输出日志了.

薛城区15716749640： android中如何debug程序? - ？
澄吴联邦： eclipse 运行的时候选择项目 右键 》 debug as 》android Application 然后你就在你想跟踪的地方点吧!

薛城区15716749640： android 怎么进入debug调试 - ？
澄吴联邦： 看你的IDE了,不管是Eclipse还是Android Studio在run菜单里都有个Debug XXX(你的project/module)的选项.