Android Eclipse 源码工程 调试

一、搭建Eclipse源码工程

1、 进入源码目录下的development/ide/eclipse，把android-formatting.xml ，android.importorder ， .classpath拷贝到源码目录

Eclipse需要一个目录列表来搜索Java文件，称作"Java Build Path”，保存在.classpath文件中【eclipse工程的配置文件，方便我们直接把android源码相应的文件和JAVA包导入工程】

导入development/ide/eclipse下的文件，让Eclipse遵从Android的编码风格：

2、 chmod +x .classpath 赋予执行权限

3、在eclipse工程菜单 window-->preferences-->java-->Code Style-->Formatter 导入android-  formatting.xml文件，organize imports导入android.importorder文件

4、 新建一个java工程，导入android源码

必须注意两点：

　　1)、新建的工程必须是java project，不能是android project，否则会破坏android源码（一般是多添加文件/文件夹）。

　　2)、导入前最好检查.classpath里的文件在android源码中是否有相应的文件（文件夹），否则也会破坏android源码（一般是多添加文件/文件夹）。

总的来说：

　　1、用eclipse来编辑代码、检查错误。

　　2、不在eclipse上编译、运行android源码程序，只能在命令行通过make(或mm或mmm)编译android源码。

　　3、可以在eclipse上调试android源码程序（原理：eclipse通过ddms服务器在emulator上进行调试），并可以单步调试、断点调试。

5、 修改eclipse配置，eclipse目录下的eclipse.ini文件，修改-Xms,-Xmx为128和512
        -Xms128m
        -Xmx512m

Android工程很大，在编译时可能造成Eclipse的Java虚拟机内存耗光。我们可以通过修改eclipse.ini避免这一问题，在ubuntu下，eclipse.ini位于eclipse所在目录

二、调试android源码

1. 退出Eclipse工程
2. 在android源码目录执行  . build/envsetup.sh ，初始化环境变量  【lunch 1   # to build the emulator】
3. 启动模拟器 emulator &【 you should see a GUI picture of a phone】
4. 等模拟器启动成功后，启动ddms   ddms & 【 you should get a splufty debugging console】

5. 在ddms上选择你需要调试的进程，一般如果是调试系统自带的应用，比如联系人，选中下面进程

6. 打开Eclipse工程，设置调试端口

    选择你的工程，右键打开菜单选择 Debug AS—Debug configuration 弹出窗口，选择Remote JAVA Application，右键在菜单选择NEW，弹出下面的视图，修改Port为8700

7.debug后在选择的进程上面如果出现了 ，则表示成功进入调试了。

8、比如：调试拨打电话的功能

在DDMS上选择com.android.phone这个进程

找到frameworks/base/telephoney/java目录下的com.android.internal.telephony包，然后找到RIL.java文件。

在函数 public void dial(String address, int clirMode, UUSInfo uusInfo, Message result)中设置断点

然后在模拟器中拨打电话，便可以在设置的断点处停下，进行查看变量等操作。

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

出现的问题：

Project 'gingerbread' is missing required library: 'out/target/common/obj/JAVA_LIBRARIES/google-common_intermediates/javalib.jar'
Project 'gingerbread' is missing required library: 'out/target/common/obj/JAVA_LIBRARIES/gsf-client_intermediates/javalib.jar'

解决：
删除.classpath中的这两行路径
<classpathentry kind="lib" path="out/target/common/obj/JAVA_LIBRARIES/google-common_intermediates/javalib.jar"/>
<classpathentry kind="lib" path="out/target/common/obj/JAVA_LIBRARIES/gsf-client_intermediates/javalib.jar"/>
添加
<classpathentry kind="lib" path="out/target/common/obj/JAVA_LIBRARIES/android-common_intermediates/javalib.jar"/>

<classpathentry kind="lib" path="out/target/common/obj/JAVA_LIBRARIES/filterfw_intermediates/classes-jarjar.jar"/>

<classpathentry kind="lib" path="out/target/common/obj/JAVA_LIBRARIES/android-support-v13_intermediates/classes-jarjar.jar"/>

简要说明：

在以往的调试经验中，读者习惯于使用Eclipse命令菜单run/debug来调试一个独立的Android应用程序，而Framework并不是一个应用程序，那么如何调试呢？下面做几点说明：

      1、Android的Framework虽然是Android的内核，但其内部也包含一个应用程序，其名称为：system_process,其对应的TCP端口地址一般为：8600，因此也可以对该程序进行调试。

      2、Framework中包含的SDK源码在程序空间中只有一份副本，但是每个应用程序都会调用这部分程序，调用时，该代码是在应用程序所在的用户进程中运行的。

      基于以上2点，理论上可以对普通应用程序进行调试，并将Android SDK中的源码附属到调试程序中，那么就可以单步调试到Framework的源码了。另一方面，也可以单独对system_process进行调试。

下面描述3个调试实例：

一、普通应用程序调试：

      使用菜单命令run/debug，当调试到需要调用Framework代码的地方，eclipse会提示找不到所需的代码，此时，可以在提示页面上单击“Attach Source...”按钮，并指到我们Android源码目录，其作用就是将Android中的源文件作为SDK中android.jar的源码，从而就可以单步运行到相应的Framework源码中了。

二、系统应用程序调试：

      以packages/app/Contacts项目为例，该项目中引用了Framework中的一些特别类，这些类在默认情况下并没有被包含到SDK中的android.jar包中，因此Eclipse下无法直接编译该项目并生成Contacts.apk。要生成Contacts.apk可以有2种方法：1、把Contacts项目中所需要的特别文件打包成一个jar包，并把该jar包包含到Contacts项目中，从而就可以直接在Eclipse中编译出Contacts.apk，另一种方法是直接在Terminal中使用make Contacts命令编译出Contacts.apk，一般多采用后一种方法。

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

1、android 的文件系统结构是怎样的？我们安装的程序放在哪里？

编译android源码之后，在out/target/product/generic目录下有一些文件，ramdisk.img 、system.img 、userdata.img 、system、 data、root
其中， system.img是由 system打包压缩得到的， userdata.img是由 data打包压缩得到的。ramdisk.img是模拟器的文件系统，把ramdisk.img解压出来可知道，ramdisk.img里的文件跟root文件夹的文件基本一样。
模拟器装载ramdisk.img并解压到内存，接着分别把system.img和userdata.img挂载到 ramdisk下的system和data目录。我们编译出来的应用程序就是放在system/app下的。用户安装的程序则是放在data/app下。

2、android SDK 和 android源码能为我们提供什么工具？

android SDK提供有很多工具，如adb,ddms,emulator,aapt等，并提供kernel-qemu、ramdisk.img、 system.img、userdata.img。因此，只要有android SDK，我们就可以在模拟器上把android跑起来。
android源码可以编译出android SDK、adb等工具、android文件系统，以及ADT插件，也就是说，我们可以从android源码编译出所有android相关的东西。

3、eclipse上调试android里的程序。
为了不让其它版本的android工具和android文件系统影响下面的编译和调试，需要从环境变量中去除android工具和android文件系统的路径：
vim ~/.bashrc
看看有没有在PATH变量中加入android工具和android文件系统的路径，如果加有，则注释它。通过下面的方法，我们是不需要在.bashrc中添加android工具和android文件系统的路径的
执行：
cd android源码目录
. build/envsetup.sh #设了环境变量之后，会多出mmm等命令，可以通过输入help来查看
lunch 1   # 把emulator等工具和ramdisk.img等文件的路径对应起来，就可以直接调用emulator等工具，也解决了第3个问题
emulator &
ddms &
注意，先启动ddms，再启动eclipse，这样eclipse中就不会说端口冲突
然后在eclipse中配置调试类型和端口：
在Run->Debug Configurations->Remote java application上双击，然后，”Host:”设为localhost，”Port:”设为8800，”Connection Type”为Standard(Socket Attach)
然后“Apply”
注意，上面设置的端口要与DDMS中设置的端口一致，ADT插件使用了8700端口，因此上面设置的端口是8800。如果出现连不到VM的错误时，请注意，要先在DDMS中选中某一进程（对应某一应用程序），才能在eclipse执行 Debug。
在eclipse调试时，可以设断点、单步调试。估计google团队也是这样开发、调试android应用程序的
4、编译android源码
执行：
cd android源码目录
. build/envsetup.sh
那 么就会多出mm/mmm等命令，mm/mmm用来编译模块（包括C、C＋＋、JAVA程序）。我们也可以直接在 android源码根目录下执行“make 模块名”来编译模块（模块名可以在.mk文件中找到）。模块编译后会在out/target/product/generic/system/app下生成对应的.apk包。但是，用mm/mmm来编译生成的.apk并不会打包到system.img中，需要我们手动通过make snod把 system文件夹打包为system.img，不过这就得重新运行模拟器了，这也是很麻烦了。对于我们开发者来说，我们可以这样做：
1）把需要修改、调试的模块（比如AlarmClock.apk）从/system/app下移除，然后make snod，这样system.img就没有AlarmClock.apk了。
2）运行模拟器，就看不到AlarmClock了
3）修改AlarmClock源码并用mm/mmm来编译，在/system/app下生成AlarmClock.apk
4）通过adb把AlarmClock.apk安装到android文件系统中，安装方法有两个：
    A、通过adb install xxx/AlarmClock.apk
    B、通过adb push xxx/AlarmClock.apk /data/app
两 种方法都可以把 AlarmClock安装到/data/app下，android会自动把它显示在主菜单中（只要AlarmClock.apk中有一Activity包 含android.intent.category.LAUNCHER属性），不过A方法在/data/app生成com.android.alarmclock.apk，B方法则是 AlarmClock.apk。用A方法时，如果原来已经安装了 AlarmClock，你还得先adb uninstall 它，而B方法则不用。推荐使用B方法。同样，卸载可以通过adb uninstall或adb shell rm xxx/xxx.apk来，也推荐用删除的方法来卸载

5、如何开发自己的工程
前面主要是讲如何在eclipse上开发android原有的工程。对于自己的工程，我们可以这样做：
1）新建一个android工程。
建android工程的好处就是可以充分使用ADT的功能。
2）导入需要的包
3）编译、运行、调试
4）加入到android源码相应的目录下，应用程序一般放在packages/apps下
我们观察packages/apps原有的工程就会发现，它们的代码是很“干净”的，没有ADT自动生成的assets、bin等文件夹和R.java，当然也没有.classpath和.project
5）编写Makefile文件xxx.mk
用android源码提供的专用Makefile文件xxx.mk，它的格式比较简单
6）把刚加入的工程添加到eclipse的android工程中
可以在eclipse中添加，也可以在.classpath中直接加入相应路径。如在.classpath中添加：
<classpathentry kind="src" path="packages/apps/HelloWorld/src"/>
R.java 中编译时自动生成的，其实所有工程用到“资源”的，都会用到R.java，这些R.java是放在out/target/common/R下。我们在源码 根目录下make全部代码时，才会对每个模块生成R.java；在make时，已经编译过并生成有.apk文件的模块是不会被编译的。因此，如果新加入的 工程已经(用mm/mmm)编译过的话，我们先对该工程的“资源”改动一下（必须是改动“资源”，因为R.java是由“资源”生成的），再make，就 在会out/target/common/R对应的包路径下看到你的工程的R.java。刷新在eclipse的out/target/common/R 子工程，再在你用到R类的地方加入它的包，如
import com.android.example.test.inside.helloworld.R;这样就不会出现找不到R定义的错误。
其实，这个错误对我们是没有任何影响的，因为我们是在shell中编译。
7）在android源码目录下编译刚加入的工程
可以用mm/mmm或make 模块名
8）用版本控件工具(svn或git或其它)把该工程上传到服务器