如何调试跟踪Android Framework源代码

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了如何调试跟踪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(具体方法见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的上面。

    如下图:

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

参考技术A

一、准备工作

确保机器上已经安装并配置下列软件环境: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中创建工程

    File > New > Java Project

    输入项目名

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

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

    调试环境配置

    右击刚刚在#3中创建的项目;

    选择:Debug As > Debug Configurations…;

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

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

    调试 可以通过模拟器或者真机调试。无论模拟器还是真机,都要:

    先启动机器(模拟器启动,或真机打开,并通过USB与PC正常连接),也就是要在DDMS Perspective的Devices视图中看到有机器连接;

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


    假如,我们想要跟踪锁屏解锁的调用情况。
    我们知道解锁的实现是在LockScreen.java的onGrabbedStateChange()函数,运行在system_process进程中。

    那么,在onGrabbedStateChange()中要调试的地方设置断点;

    在Device View中,选中system_process,并点击小爬虫图标;


    用Section#4创建的Debug配置,Debug;

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

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

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

Play Framework Project:如何从源代码中包含插件

【中文标题】Play Framework Project:如何从源代码中包含插件【英文标题】:Play Framework Project: How to include plugin from source 【发布时间】:2015-06-01 10:46:53 【问题描述】:

背景: 我正在将 TypeScript 集成到 Play Framework (2.2.6) 中,并且我正在尝试使用 mumoshu 的插件来做到这一点。问题是,插件在 Windows 机器上运行“play dist”时出现问题。 我从 GitHub 分叉了代码,以便对源代码进行一些修改,以便我可以继续使用该插件。

问题: 我有一个传统源码结构的play框架插件:

project/build.properties
project/Build.scala
project/plugins.sbt
src/main/scala/TypeScriptPlugin
src/main/scala/TypeScriptKeys.scala
...<other code>

我想将此插件包含到另一个项目中,但我真的不知道从哪里开始以及如何连接设置。

根据之前的建议,我已经能够将模块添加到我的项目中,如下所示:

// In project/Build.scala...
object ApplicationBuild extends Build
    lazy val typeScriptModule = ProjectRef(file("../../../play2-typescript"), "play2-typescript")

    lazy val main = play.Project(<appName>, <appVersion>, <appDependencies>).settings(typescriptSettings: _*).dependsOn(typeScriptModule).aggregate(typeScriptModule)

typescriptSettings 是在另一个项目中定义的...我想,我仍然不能 100% 确定 typescriptSettings 是什么,除了添加此设置调用使插件能够工作。当我将插件包含在plugins.sbt 文件中并导入包com.github.mumoshu.play2.typescript.TypeScriptPlugin._ 时,这最初工作得很好,但现在我包含了源代码并明确包含了模块,我不能只导入包......或者至少不像我以前那样。

我还是 scala/sbt 的新手,我很难在网上找到有用的资源。任何帮助,将不胜感激。

【问题讨论】:

【参考方案1】:

假设在同一个父目录中有两个目录:

play2-typescript: 是mumoshu's play2-typescript 的克隆 play2-typescript-testapp:这是您测试更改的应用程序

您需要在play2-typescript-testappproject 目录中创建一个文件,如下所示:

play2-typescript.sbt

val metaBuild = (project in file(".")
  dependsOn ProjectRef(file("../../play2-typescript"), "play2-typescript")
)

注意:

相对路径是play2-typescript插件项目,相对于play2-typescript-testapp内的project目录。

将其更改为您的设置中正确的内容,并考虑您也可以将其定义为绝对路径。

【讨论】:

这似乎构建得很好,但我不知道如何为包含的模块设置任何设置。同样,仍然习惯于 SBT 设置。 例如我之前通过根项目设置插件设置.settings(typescriptSettings: _*) 我想我仍然需要这样做才能让它工作,但不知道如何设置它。 绝对,这只是让你的测试应用程序设置依赖于你的插件分支的来源,然后你像往常一样做所有事情:在 build.sbt 的根目录下配置你的游戏项目测试应用。 这就是令人困惑的事情。我在 Build.scala 文件中使用 .settings(typescriptSettings: _*) 但它找不到 typescriptSettings 因为它是在另一个项目中定义的。但是,我也无法导入该项目中定义的包。我将更新问题描述以更好地反映我的“测试”项目。 所以我解决了这个问题。问题是项目需要像这样加载到 plugins.sbt 文件中:lazy val root = project.in(file(".")).dependsOn(typescript) lazy val typescript = file("../modules /打字稿");鉴于此负载,我能够导入正确的外部包并在 Build.Scala 文件中配置正确的设置。感谢您的所有帮助!【参考方案2】:

有很多这样的激活器模板示例。我有一个项目,我们遵循https://typesafe.com/activator/template/play-multidomain-auth 路径。具体来说,解决您的问题;根项目 play-multidomain-auth/project/ 中的插件可在模块(play-multidomain-auth/modules/admin/、.../common 和 .../web)中访问。

这个例子是我在使用多项目设计时见过的最干净的例子,但是这种观点非常主观。

我希望这会有所帮助。

【讨论】:

以上是关于如何调试跟踪Android Framework源代码的主要内容,如果未能解决你的问题,请参考以下文章

开发和调试Android系统源码,开发环境如何搭建!

了解一下Android调试

举例说明android源代码调试中加入的log方法

如何通过Androidxref在线查看Android Framework源代码

在 Visual Studio 2012 中调试 .NET Framework 源代码?

Android 不会在运行时崩溃时转储错误跟踪