用IntelliJ代替Eclipse，调试AndroidSourcecodes

    本文所说的调试Android Source Code&＃xff0c;是指区别于一般的Android App&＃xff0c;是对Android系统源代码&＃xff0c;包括自带的Apps&＃xff0c;比如Mms, Contacts, Dialer等的开发和调试&＃xff0c;需要对IDE做特殊的配置。

    其实整个配置的目的&＃xff0c;是2个方面&＃xff1a;

    1&＃xff0c;在调试的时候&＃xff0c;可以看到相关代码的引用&＃xff0c;即看到符号表&＃xff0c;这样才可以step into进去debug。

    2&＃xff0c;要能用remote debug的方式&＃xff0c;attach到手机上运行的那些app的process上&＃xff0c;比如com.android.mms。这就是区别于一般Android app调试的方面。

    用Eclipse调试Android Source Code&＃xff0c;可以说是标准的Android开发的做法&＃xff0c;如何配置&＃xff0c;参考&＃xff1a;http://source.android.com/source/using-eclipse.html。

    但是Eclipse太慢了&＃xff0c;在编辑输入的时候&＃xff0c;那个一个字符一个字符蹦出来的感觉&＃xff0c;真的是无法忍受。所以开始转向IntelliJ。Eclipse和IntelliJ的对比&＃xff0c;可以Google下&＃xff0c;有很多文章可以参考&＃xff0c;而实际使用的体验&＃xff0c;差别也是比较明显的。总的来说&＃xff0c;Eclipse有点大&＃xff0c;对于Android/Java的开发来说&＃xff0c;不如IntelliJ专一&＃xff0c;性能也是比后者差一截。如果我们想开发Android App&＃xff0c;进行Java、或者Scala这样的JVM Lanauge&＃xff08;如何用Scala开发Android App是另一个话题&＃xff09;&＃xff0c;的开发&＃xff0c;用IntelliJ是明智的。

    其实在Android的Source Code Tree中&＃xff0c;有一些IDE的配置文件&＃xff0c;在它的相对路径development\ide下&＃xff0c;其中有Eclipse&＃xff0c;IntelliJ, emacs 和 xcode的配置。在上面用eclipse的链接中&＃xff0c;就提到了这个目录&＃xff0c;用到了eclipse目录下的.classpath文件。

    而对于IntelliJ来说&＃xff0c;则不需要这个.classpath文件&＃xff0c;只需要参考。而那个intellij子目录中的内容&＃xff0c;我完全不知道如何用&＃xff0c;本文的做法没有用到它们。

    虽然IntelliJ没有那个.classpath文件可以用&＃xff0c;但是实际配置起来&＃xff0c;也是不费事的。而且&＃xff0c;它对android source code的那个编译输出目录out的依赖&＃xff0c;也比eclipse的配置低多了。下面&＃xff0c;直接上steps&＃xff0c;在步骤中&＃xff0c;我会说到和Eclipse的不同&＃xff0c;以及一些tips&＃xff1a;

    1&＃xff0c;拿到整个Android Source Code&＃xff0c;首先要编译成功&＃xff0c;这会产生Android/out这个目录&＃xff0c;IntelliJ和Eclipse相比&＃xff0c;只需要其中的一个目录out\target\common\R。其实这个目录不是固定的&＃xff0c;许多oem厂商&＃xff0c;可以根据不同的configration&＃xff0c;配置这个输出目录&＃xff0c;这样实际的路径可能会是&＃xff1a;out\xxxxx\target\common\R&＃xff0c;总是&＃xff0c;我们需要这个R。实际上IntelliJ可以自动扫描出来&＃xff0c;我们到时候要勾选相应的这个路径。对比配置eclipse需要的那个.classpath&＃xff0c;intellij降低了对out目录的依赖&＃xff0c;这样的好处在于&＃xff0c;由于out目录是会多变的&＃xff0c;有时甚至需要删除它重新来过&＃xff0c;所以还是尽量不依赖为好。

    2&＃xff0c;启动IntelliJ 11.1.4&＃xff0c;我们用Create New Project的方式。有一种情况&＃xff0c;即用Open Project的方式&＃xff0c;去打开一个已经存在的Eclipse项目。比如我们已经用那个.classpath文件&＃xff0c;按照开头的链接&＃xff0c;配置了Eclipse的环境&＃xff0c;所以我们想用IntelliJ中兼容Eclipse项目的方式打开这个已经配置好的项目。不幸&＃xff0c;这种方式是不行的&＃xff0c;试验下来&＃xff0c;intellij在open的过程最后&＃xff0c;实际无法打开已有的eclipse项目。

[Update]在IntelliJ 12中&＃xff0c;这个方式变化了&＃xff1a;

    要用Import Project&＃xff0c;然后直接选定android source codes的根目录&＃xff1a;

    然后是&＃xff1a;

    选择"Create project from existing sources"&＃xff0c;然后点Next。

    这里不用再选择IntelliJ Project的文件格式&＃xff0c;然后Next&＃xff0c;下面就接着第5步&＃xff0c;开始扫描Sources。后面的截图就不更新了&＃xff0c;类似的。

    3&＃xff0c;好吧&＃xff0c;即使之前已经按照eclipse的方式&＃xff0c;配置了Android Source Code&＃xff0c;没关系&＃xff0c;IntelliJ的配置与之不冲突。现在点击Create New Project&＃xff0c;开始下一步。

    这里&＃xff0c;我们仍然不能选择第二项&＃xff1a;“Import project form external model”&＃xff0c;试图从已有的Eclipse项目中去创建。要选择第三项。next。

    4&＃xff0c;选择好你的Android Source Code的根目录android所在的路径&＃xff0c;已经起一个项目名称。这里好像intellij的project files location是可以和源代码分开放置的&＃xff0c;实际上不行&＃xff0c;第二项一定要设置为源代码所在的路径&＃xff0c;后面会自动扫描其中的source files。第三项是intellij项目的文件格式&＃xff0c;默认的就好。喜欢统一管理的&＃xff0c;可以换成.idea子目录的形式。next。

    5&＃xff0c;然后IntelliJ开始searching for soruces&＃xff0c;耐心等待吧&＃xff0c;可以去做下别的事情了&＃xff0c;要等大约半个小时呢(当然这个也要机器的硬件配置)。其实如果熟练了&＃xff0c;可以在这一步stop&＃xff0c;然后自己选择要加入的module目录。

    6&＃xff0c;自动扫描完成后&＃xff0c;就会跳出来&＃xff1a;

    默认是Mark All的&＃xff0c;其实我们不需要这么多。所以先Unmark All&＃xff0c;然后勾选我们需要的。这时&＃xff0c;我们就可以参考那个.classpath文件了。

    打开这个文件&＃xff0c;我们可以看到其中有2大部分&＃xff0c; src和lib&＃xff0c;其中src&＃xff1a;packages/app, packages/providers, frameworks/base, frameworks/ex, frameworks/opt, frameworks/supports, development, libcore, external, 还有out下的那些&＃xff1b;lib&＃xff1a;主要就是out中的了&＃xff0c;以及一个package中的lib。

    在这一步&＃xff0c;我们只看src的部分&＃xff0c;后面还要看lib的部分。

    所以根据我们的需要&＃xff0c;packages/app中只需要部分勾选&＃xff0c;development就全部不要选了&＃xff0c;还有out中的内容&＃xff0c;除了那个out/target/common/R要勾&＃xff0c;其它的都不用&＃xff0c;剩下的&＃xff0c;我建议都勾上&＃xff0c;因为基本都是公共的部分。记得一点&＃xff0c;对于intellij的project来说&＃xff0c;module越多&＃xff0c;运行起来越慢&＃xff0c;所以还是按需来选。将来也可以根据需要增减。

    请注意这个out/target/common/R&＃xff0c;上面已经提到&＃xff0c;这个路径有可能会由于oem修改了编译脚本而变化&＃xff0c;请根据具体out的路径选择&＃xff0c;但是intellij已经扫描出来了&＃xff0c;只要辨识出来即可。

    另外&＃xff0c;这个.classpath文件的内容&＃xff0c;是随着android的升级&＃xff0c;有可能变化的&＃xff0c;请根据实际内容未准。

    再有&＃xff0c;如果你还需要调试这个.classpath上没有列出的module&＃xff0c;也可以在此时额外勾选相应的内容。

    比如&＃xff0c;packages/apps/下&＃xff0c;只选择了Mms和Phone。

    勾选好之后&＃xff0c;next。

    7&＃xff0c;开始searing library&＃xff0c;又要等待了。

    8&＃xff0c;自动扫描完成后&＃xff0c;自动切换到如下界面&＃xff1a;

    这里没有UnMark All的勾选&＃xff0c;直接点选第一条&＃xff0c;然后按shift&＃xff0c;再点选最后一条(或者Ctrl &＃43;A&＃xff0c;但IntelliJ响应很慢&＃xff0c;因为条目很多)&＃xff0c;然后按下空格(这里要等待&＃xff0c;IntelliJ的性能还要继续改进)&＃xff0c;来UnMark All。然后根据.classpath来勾选&＃xff1a;

    然后next。

    9&＃xff0c;开始searching for modules。还是需要等待一段时间&＃xff0c;不过相比之前的2步&＃xff0c;就短多了&＃xff0c;因为我们之前勾选的sources不多。

    10&＃xff0c;自动完成后&＃xff0c;确定我们想创建的IntelliJ Modules。

    这一步里&＃xff0c;就是上面我们勾选的sources&＃xff0c;intellij根据source建立module&＃xff0c;你也可以去掉某些source&＃xff0c;这样也就无法在intelliJ中调试它们了。勾选的含义&＃xff0c;intelliJ会在对应的目录下建立module文件.iml。

    如上图&＃xff0c;common和common1&＃xff0c;我们最好进行适当的改名操作。

    另外&＃xff0c;我们需要去掉Base的勾选&＃xff0c;因为我们只需要具体的base中的内容&＃xff0c;比如base/core。

把刚才的那个Common修改成R。这是一个Tip。将来如果out被删除&＃xff0c;要重新创建一个Module时&＃xff0c;同样的路径&＃xff0c;IntelliJ会命名为R&＃xff0c;不再是Common了&＃xff0c;所以这里事先修改为R&＃xff0c;方便将来。

    另外&＃xff0c;注意到这里R的实际路径是有变化的&＃xff0c;多了一个caet2ur_qpl就是因为oem修改了编译的脚本所致。

    完成后&＃xff0c;next。

    11&＃xff0c;接下来&＃xff0c;searching for frameworks。这一步也要等待一段时间。

    12&＃xff0c;自动完成后&＃xff0c;切换界面&＃xff0c;intelliJ会显示出检测到的framework&＃xff0c;这里都是Android类型的modules。我们只要看下&＃xff0c;就可以点finish结束了。

    接下来&＃xff0c;intelliJ会建立项目的索引&＃xff0c;这同样耗时。等索引结束后&＃xff0c;还需要做后面的配置修改工作。

    13&＃xff0c;如果源代码中已经受vcs工具管理&＃xff0c;比如git&＃xff0c;就会出现这样的界面&＃xff1a;

    我们就需要修改一些配置&＃xff0c;去掉这些烦人的提示。

    在等待索引完成的时候&＃xff0c;进一步的配置前&＃xff0c;我们看看上面的操作对Android的代码树有什么影响&＃xff1a;

    上面内容不是全部&＃xff0c;简单的说&＃xff0c;IntelliJ建立了项目文件.ipr和.iws&＃xff0c;以及在我们勾选的module下建立了.iml文件。

    与eclipse相比&＃xff0c;我觉得这是IntelliJ的缺点。eclipse除了使用那个.classpath文件之外&＃xff0c;就没有再额外创建多余的文件了&＃xff0c;intelliJ创建了多余的module文件&＃xff0c;如果哪个module的代码混乱&＃xff0c;从而被删除重新获取的话&＃xff0c;那在intellij的项目里&＃xff0c;就需要通过创建一个新的module的方式&＃xff0c;来重新加入这个module。

    14&＃xff0c;intelliJ索引完成后&＃xff0c;我们先去掉刚才vcs工具的提示&＃xff1a;

    左侧有一个Version Control&＃xff0c;然后拖动右侧的滚动条到最下&＃xff0c;去掉“Notify about VCS root errors”的勾选&＃xff0c;然后点Apply。然后点击OK&＃xff0c;关闭这个Settings界面。

    15&＃xff0c;在左侧的Project Panel中点选任意一个&＃xff0c;然后按F4&＃xff0c;启动Project Structure界面&＃xff0c;开始后面的配置。

    首先解决这个循环依赖的问题。鼠标移动过去&＃xff0c;会有hints。

    1) 点选左侧的luni的main(可能已经被改名)&＃xff0c;右侧的dependencies中去掉对xml和davik的依赖。

    2) 点选左侧的core&＃xff0c;右侧的dependencies中去掉对keystore, location, opengl, wifi, telephony, media, graphics, drm等的依赖&＃xff0c;只保留libcore和R就行了。

    3) 点选左侧的opengl&＃xff0c;去掉对graphics的依赖。

    4) 点选左侧的Filterfw&＃xff0c;去掉对Filterpacks的依赖。

    5) 分别点选左侧的Wifi&＃xff0c;Voip, Location, Media&＃xff0c;去掉对Telephony的依赖(若存在的话)。

    经过上面的操作&＃xff0c;Project Structure界面上的循环依赖的错误就没有了。

    16&＃xff0c;修改依赖的顺序。注意到中间那些前面有&＃43;号的模块&＃xff0c;它们是有AndroidManifest.xml的android模块(实际上&＃xff0c;有的带&＃43;号的模块确实没有这个文件)。而没有&＃43;号的&＃xff0c;实际上是Java模块&＃xff0c;依赖的是Java的SDK。

    比如上图中的Calendar模块&＃xff0c;它是一个android模块&＃xff0c;所以它默认依赖的对象中&＃xff0c;Android Framework是第一个&＃xff0c;我们需要用最后侧的向下按钮&＃xff0c;把对Android Framework的依赖降低到最后&＃xff1a;

对每一个android模块&＃xff0c;都要做这个动作。有点繁琐&＃xff0c;呵呵。为什么要做这个呢&＃xff1f;因为对于Android Source Code来说&＃xff0c;它本身就有所有Android Framework的Source&＃xff0c;所以对于已近安装好的Android SDK的依赖要降低优先级&＃xff0c;这样Android Source Codes中会首先去找本身就带的实现&＃xff0c;而不是Android SDK中的实现了。

    额外说一点&＃xff0c;Core这个android模块&＃xff0c;是核心的基础模块&＃xff0c;也应该把它的顺序升高&＃xff0c;放到最上面。而R模块应该仅次于Core模块。Core依赖的libcore&＃xff0c;可以放到比Core还高的位置上。

    17&＃xff0c;修改android模块的gen目录。IntelliJ会在每个android模块下创建一个多余的gen目录&＃xff0c;这会导致Android Source Code的编译会有问题&＃xff0c;我们可以把它们统一设置到out目录中。

    先看下多出来的gen目录&＃xff0c;跟每个android模块的.iml是放在同一个目录下的。

    上面的内容不是全部。那在Project Structure界面中要做的修改&＃xff08;以上面的Calendar为例&＃xff09;&＃xff1a;

    去掉默认的勾选&＃xff0c;选择下面那个“Use module compile output path”:

    然后点击Apply&＃xff0c;再拷贝"Output path:"后的路径&＃xff0c;打开Android的设置&＃xff0c;切换到Compiler标签页&＃xff1a;

    将AIDL Compiler和AAPT Compiler的Destination directory的路径&＃xff0c;除了最后的gen&＃xff0c;前面的路径改为上面Output path中的路径&＃xff0c;如下&＃xff1a;

    然后点击Apply。若有提示不存在AndroidManifest.xml的警告&＃xff0c;直接OK。

    后面对每一个Android模块都做同样的操作。

    全部做完后&＃xff0c;关掉Project Structure界面&＃xff0c;然后使用Linux的Shell命令清理掉已经存在的那些与.iml同目录下的gen目录。同时&＃xff0c;查看out下的目录&＃xff0c;会发现新设置的gen目录。

    18&＃xff0c;现在&＃xff0c;所有的配置都完成了&＃xff0c;我们首先看看某一个模块中的代码能够是否能够找到相应的reference code。

    比如我们打开SmsManager.java这个文件&＃xff0c;右侧都是蓝色或者黄色的颜色标示&＃xff0c;这说明IntelliJ找到了这支源代码文件中调用了的其它API的实现&＃xff0c;否则就会是红色标示&＃xff0c;鼠标可以点击这些颜色标示&＃xff0c;跳转到相应的地方。

    说明一点&＃xff0c;Android Source Code中有一些只有lib的库&＃xff0c;可能是看不到源代码的&＃xff0c;所以无论你如何添加module&＃xff0c;也是找不到的。

    19&＃xff0c;下面&＃xff0c;我们配置remote debug&＃xff0c;然后&＃xff0c;我们就可以调试Android System App或者Frameworks了。

    如上图&＃xff0c;intellij已经自动建立好了2个debug的配置项&＃xff0c;但是对于Android System App来说&＃xff0c;是不需要的&＃xff0c;可以删除它们。点击Edit Configurations进入debug的设置界面。右上那个按钮&＃xff0c;就是attach到手机里的process进行debug时用的&＃xff0c;前提是我们要先配置好debug的设置。

    在这个界面&＃xff0c;首先删除IntelliJ自动建立的那几个配置项&＃xff0c;然后点击&＃43;按钮&＃xff0c;选择Remote&＃xff1a;

    如上图&＃xff0c;修改2个地方&＃xff0c;1个是name&＃xff0c;是一个port。为什么是8700&＃xff1f;请看本文开头的链接中的内容。然后OK&＃xff0c;退出。

    这时toolbar上的debug项也随着有了变化。接下来&＃xff0c;打开android手机的usb调试&＃xff0c;连接上pc&＃xff0c;点击那个attach debug的按钮。首先是出现一个waiting for adb的进度条对话框&＃xff0c;然后出现Choose Process的界面&＃xff1a;

    上图表现的是手机没有连接上pc时的情况&＃xff0c;连接上之后会自动刷新&＃xff0c;如下&＃xff1a;

    这里选择com.android.mms&＃xff0c;表示想要调试android的系统自带的app Mms。点击Mms上的创建新消息的按钮&＃xff0c;会挺在设置在onCreate的断点&＃xff1a;

    OK&＃xff0c;接下来&＃xff0c;开始尝试step over, step into等调试操作。

    经过几步F8&＃xff08;step over&＃xff09;&＃xff0c;到达initResourceRefs()处&＃xff0c;接下来&＃xff0c;step into:

    intellij正常跳转到initResourceRefs()的实现处的第一行。

    OK&＃xff0c;经过这个简单的示例&＃xff0c;说明已经完全建立成功了在intellij上调试Android Source Code的环境。

    本文到此结束&＃xff0c;最后来一些总结&＃xff1a;

1. IntelliJ比Eclipse的性能要高一个层次。在Eclipse上输入&＃xff0c;以及Code Compelete都很痛苦。
2. IntelliJ比Eclipse的配置要繁琐很多。
3. IntelliJ比Eclipse要“智能” 不少&＃xff0c;用用就知道了。
4. IntelliJ打开那些已有git管理的代码&＃xff0c;自动支持git在ide里的操作&＃xff0c;而Eclipse的git管理方式大不一样&＃xff0c;比较繁琐。
5. 稍微分析下IntelliJ建立项目的后的动作&＃xff0c;它使用一个indexing的功能&＃xff0c;可能是它的性能比Eclipse好的一个原因。