debugsdk源码（Debug Code）
本文目录一览：
- 1、网站源代码如何在线进行调试?
- 2、如何调试跟踪Android Framework源代码
- 3、如何使用Android Studio开发/调试Android源码
- 4、如何把android framework源代码加入SDK
- 5、IDEA调试android程序
网站源代码如何在线进行调试?
开发调试环境: Ubuntu 14.10，openJdk 1.7，Android Studio 1.0.2，android-5.0.1_r1源码
由于AS是基于IntelliJ IDEA开发的，所以本文也适用于IntelliJ IDEA
一、修改Android Studio(以下简称AS)的内存配置
因为在导入源码时需要消耗大量内存，所以先修改IDEA_HOME/bin/studio64.vmoptions(x86的机器修改studio.vmoptions)中-Xms和-Xmx的值。文档中使用的是748m, 可自行修改。
二、配置AS的JDK、SDK
在IDE中添加一个没有classpath的JDK, 这样可以确保使用源码里的库文件
并将其作为要使用的SDK的Java SDK。如下图
三、生成导入AS所需配置文件(*.ipr)
①编译源码(为了确保生成了.java文件，如R.java；如果编译过，则无需再次编译)
②检查out/host/linux-x86/framework/目录下是否有idegen.jar
如果idegen.jar不存在，执行:
mmm development/tools/idegen/
在5.0.1的源码中会生成res.java的文件夹，导致idegen.jar运行时抛FileNotFoundException，这是idegen的代码不够严谨造成的。
我的分享里有修改这个bug的patch，或者直接使用我分享的idegen.jar。
③执行
development/tools/idegen/idegen.sh
等待出现类似下面的结果:
Read excludes: 5ms
Traversed tree: 44078ms
这时会在源码的根目录下生成android.ipr和android.iml两个IntelliJ IDEA(AS是基于IntelliJ IDEA社区版开发的)的配置文件
Tips：
AS在导入代码时比较慢，建议先修改android.iml，将自己用不到的代码exclude出去.可以仿照过滤.repo文件夹的语法,如:
excludeFolder url="" /
excludeFolder url="" /
excludeFolder url="" /
这样在导入时就会跳过abi和art文件夹.过滤的越多，AS的处理速度就会越快.
④在AS中打开源码根目录下新生成的android.ipr
如果在导入时AS出现
则建议按照其给定的解决方法来解决(网址:)，具体内容如下图:
四、解决源码中跳转错误问题
①为当前工程设置正确的SDK和JDK
②设置'Modules'的依赖
先将所有依赖删掉，只留下上图'1'所指向的两个(注意:这里删除全部只是为了方便。如果确实用到了.jar,在将它们的路径添加进来就可以了.
如:5.0.1的ContactsCommon用到了geocoder-2.9.jar和libphonenumber-6.2.jar)
点击上图中'2'指向的'+'并选择上图'3'指向的'Jars or directories'选项，依次将frameworks和external文件夹添加进来.如:
其它版本的代码在添加frameworks时可能会显示成:
没有关系，只是显示问题，点击OK还是会把frameworks路径添加进去的.
如果还有代码跳转错误，请仿照上面的步骤将相应代码的路径或jar文件添加到其Dependencies标签页中即可.
五、DEBUG源码
我们可以通过给刚导入的工程在'Modules'中添加'Android Framework'来让AS将它作为一个Android工程，从而方便我们调试代码.
可以按照上图中'1'和'2'来添加Android Framework支持.
在代码中加断点，然后选择'Run'-'Attach debugger to Android process'或者直接点击下图所示的图标
在弹出的选择进程(Choose Process)对话框中，勾选显示所有进程，选择要DEBUG的代码所在的进程，点击OK即可.
六、其它
代码中很多地方提示Call requires API Level x.... 出现这个问题是因为AS将我们的工程当做安卓应用程序工程了，且源码中没有指定minSdkVersion.
我们只需在源码根目录加一个声明minSdkVersion的AndroidManifest.xml文件即可(分享了一个AndroidManifest.xml)。
也可以考虑使用build.gradle来解决该问题。
如何调试跟踪Android Framework源代码
本文讲解如何在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(具体方法见)
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的上面。
如下图:
之后我们的工程错误消失了：
如何使用Android Studio开发/调试Android源码
本文是以源码中development/tools/idegen/README作为指导文档.
环境: Ubuntu 14.10，openJdk 1.7，Android Studio 1.0.2，android-5.0.1_r1源码
由于AS是基于IntelliJ IDEA开发的，所以本文也适用于IntelliJ IDEA
一、修改Android Studio(以下简称AS)的内存配置
因为在导入源码时需要消耗大量内存，所以先修改IDEA_HOME/bin/studio.vmoptions中-Xms和-Xmx的值。文档中使用的是748m, 可自行修改。
二、配置AS的JDK、SDK
在IDE中添加一个没有classpath的JDK, 这样可以确保使用源码里的库文件
三、生成导入AS所需配置文件(*.ipr)
①编译源码(为了确保生成了.java文件，如R.java；如果编译过，则无需再次编译)
②检查out/host/linux-x86/framework/目录下是否有idegen.jar
如果idegen.jar不存在，执行:
mmm development/tools/idegen/
在5.0.1的源码中会生成res.java的文件夹，导致idegen.jar运行时抛FileNotFoundException，这是idegen的代码不够严谨造成的。
我的分享里有修改这个bug的patch，或者直接使用我分享的idegen.jar。
③执行
development/tools/idegen/idegen.sh
等待出现类似下面的结果:
Read excludes: 5ms
Traversed tree: 44078ms
这时会在源码的根目录下生成android.ipr和android.iml两个IntelliJ IDEA(AS是基于IntelliJ
IDEA社区版开发的)的配置文件
④在AS中打开源码根目录下新生成的android.ipr
如果在导入时AS出现
则建议按照其给定的解决方法来解决
四、解决源码中跳转错误问题
①为当前工程设置正确的SDK和JDK
②设置'Modules'的依赖
先将所有依赖删掉，只留下上图'1'所指向的两个(注意:这里删除全部只是为了方便。如果确实用到了.jar,在将它们的路径添加进来就可以了.
如:5.0.1的ContactsCommon用到了geocoder-2.9.jar和libphonenumber-6.2.jar)
点击上图中'2'指向的'+'并选择上图'3'指向的'Jars or
directories'选项，依次将frameworks和external文件夹添加进来.如:
其它版本的代码在添加frameworks时可能会显示成:
没有关系，只是显示问题，点击OK还是会把frameworks路径添加进去的.
如果还有代码跳转错误，请仿照上面的步骤将相应代码的路径或jar文件添加到其Dependencies标签页中即可.
五、DEBUG源码
我们可以通过给刚导入的工程在'Modules'中添加'Android
Framework'来让AS将它作为一个Android工程，从而方便我们调试代码.
可以按照上图中'1'和'2'来添加Android Framework支持.
在代码中加断点，然后选择'Run'-'Attach debugger to Android process'或者直接点击下图所示的图标
在弹出的选择进程(Choose Process)对话框中，勾选显示所有进程，选择要DEBUG的代码所在的进程，点击OK即可.
六、其它
代码中很多地方提示Call requires API Level x.... 出现这个问题是因为AS将我们的工程当做安卓应用程序工程了，且源码中没有指定minSdkVersion.
我们只需在源码根目录加一个声明minSdkVersion的AndroidManifest.xml文件即可(分享了一个AndroidManifest.xml)。
也可以考虑使用build.gradle来解决该问题。
如何把android framework源代码加入SDK
Android Eclipse plugin (ADT)不允许我们在项目属性中attach源代码到android.jar上。好在Eric Burke找到了把source加入到SDK中的办法 ，通过分析ADT的源代码我们知道ADT是从SDK目录下的“sources” 目录来查找class对应的源代码，这样我们只要把源代码放到sources目录中ADT就可以自动找到对应的源代码了。 下载源代码后，在/android-sdk-windows/platforms/android-xx下新建一个sources目录，将源文件放在sources目录下，然后在编写的android的class中就可以看到引用文件的源代码了, 如下所示：SDK_PATH | android.jar +--docs/... +--samples/... +--sources +--android | ...accounts, annotation, app, bluetooth, etc... +--com/android/etc... +--dalvik/... +--java/... +--javax/... 其实我们并不需要所有Android的源代码。比方说我们把Binder相关的文件copy到sources/android/os目录下。我们使用ADT调试的时候就可以直接看到Binder的源代码.
增加sources目录后记得重新启动Eclipse! 有时通过某个项目点右键，运行debug as/android application，调试APP时，可查看framework class的源码。
IDEA调试android程序
一、修改AndroidStudio(以下简称AS)的内存配置因为在导入源码时需要消耗大量内存，所以先修改IDEA_HOME/bin/studio64.vmoptions(x86的机器修改studio.vmoptions)中-Xms和-Xmx的值。文档中使用的是748m,可自行修改。二、配置AS的JDK、SDK在IDE中添加一个没有classpath的JDK,这样可以确保使用源码里的库文件并将其作为要使用的SDK的JavaSDK。三、生成导入AS所需配置文件(*.ipr)①编译源码(为了确保生成了.java文件，如R.java；如果编译过，则无需再次编译)②检查out/host/linux-x86/framework/目录下是否有idegen.jar如果idegen.jar不存在，执行:mmmdevelopment/tools/idegen/在5.0.1的源码中会生成res.java的文件夹，导致idegen.jar运行时抛FileNotFoundException，这是idegen的代码不够严谨造成的。我的分享里有修改这个bug的patch，或者直接使用我分享的idegen.jar。③执行development/tools/idegen/idegen.sh等待出现类似下面的结果:Readexcludes:5msTraversedtree:44078ms这时会在源码的根目录下生成android.ipr和android.iml两个IntelliJIDEA(AS是基于IntelliJIDEA社区版开发的)的配置文件Tips：AS在导入代码时比较慢，建议先修改android.iml，将自己用不到的代码exclude出去.可以仿照过滤.repo文件夹的语法,如:删除掉所有不需要的module-library项这样在导入时就会跳过abi和art文件夹.过滤的越多，AS的处理速度就会越快.④在AS中打开源码根目录下新生成的android.ipr如果在导入时AS出现则建议按照其给定的解决方法来解决(网址:/display/IDEADEV/Inotify+Watches+Limit)四、解决源码中跳转错误问题①为当前工程设置正确的SDK和JDK②设置'Modules'的依赖先将所有依赖删掉(注意:这里删除全部只是为了方便。如果确实用到了.jar,在将它们的路径添加进来就可以了.如:5.0.1的ContactsCommon用到了geocoder-2.9.jar和libphonenumber-6.2.jar)点击指向的'Jarsordirectories'选项，依次将frameworks和external文件夹添加进来.如:注：推荐把frameworks和external这两个移到最上面，这样在代码跳转时会优先从这两个文件夹下查找，而不是在Android.jar中查找。其它版本的代码在添加frameworks时可能会显示成:没有关系，只是显示问题，点击OK还是会把frameworks路径添加进去的.如果还有代码跳转错误，请仿照上面的步骤将相应代码的路径或jar文件添加到其Dependencies标签页中即可.五、DEBUG源码可以通过给刚导入的工程在'Modules'中添加'AndroidFramework'来让AS将它作为一个Android工程，从而方便调试代码.可以来添加AndroidFramework支持.在代码中加断点，然后选择'Run'-'AttachdebuggertoAndroidprocess'在弹出的选择进程(ChooseProcess)对话框中，勾选显示所有进程，选择要DEBUG的代码所在的进程，点击OK即可.六、其它代码中很多地方提示CallrequiresAPILevelx.出现这个问题是因为AS将工程当做安卓应用程序工程了，且源码中没有指定minSdkVersion.只需在源码根目录加一个声明minSdkVersion的AndroidManifest.xml文件即可(分享了一个AndroidManifest.xml)。也可以考虑使用build.gradle来解决该问题。
