关于怎样使用eclipse来开发android源码的官方文档

关于怎样使用eclipse来开发android源码的官方文档：

　　https://sites.google.com/a/android.com/opensource/using-eclipse

　　从该文档和实践可以总结出几点：

　　1、可以使用eclipse来编辑JAVA程序、检查错误（主要是类库包含和语法方面），但是不能在eclipse上编译运行android源码，还是得在shell中make(或mm或mmm)

　　2、android源码文件夹里提供有一些eclipse配置文件，

　　.claapath：eclipse工程的配置文件，方便我们直接把android源码相应的文件和JAVA包导入工程

　　android-formatting.xml和android.importorder：这个很重要，主要是用来规范我们的编码风格，更容易使我们的代码风格一致

　　3、把android源码作为一个工程导入eclipse时，必须注意两点

　　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上进行调试），并可以单步调试、断点调试。

　　下面，从官方文档总结出具体怎样用eclipse来开发android源码

　　1、建立基本的android开发环境

　　请参考官方文档或＜android模拟器在ubuntu8.10的安装＞

　　2、编译android源码

　　android源码根目录下通过make进行编译，请注意一些配置，具体可参考＜android源码的编译＞

　　3、把eclipse工程配置文件复制到android源码根目录下

　　cp development/ide/eclipse/.classpath ./

　　chmod u+w .classpath  # Make the copy writable

　　4、修改eclipse程序的配置

　　1）、修改eclipse缓存设置

　　把eclipse.ini（在eclipse软件的安装目录下）的3个值改为下面的值：

　　-Xms128m

　　-Xmx512m

　　-XX:MaxPermSize=256m

　　2）、把android-formatting.xml和android.importorder导入eclipse

　　android-formatting.xml、.classpath和android.importorder都放在development/ide/eclipse/下

　　android-formatting.xml用来配置eclipse编辑器的代码风格；android.importorder用来配置eclipse的import的顺序和结构。

　　在window->preferences->java->Code style->Formatter中导入android-formatting.xml

　　在window->preferences->java->Code style->Organize Imports中导入android.importorder

　　3）、安装anyedit插件（可选）

　　在http://andrei.gmxhome.de/anyedit/下载并导入eclipse中

　　5、把android源码作为一个工程导入eclipse

　　导入前先检查.classpath里的文件在android源码中是否有相应的文件（文件夹），否则也会破坏android源码（一般是多添加文件/文件夹），.classpath里多余的路径可删除

　　新建Java Project（不是android project，否则会破坏android源码），选择从已存在的工程导入，工程名任意，完成。

　　导入时，eclipse要build工程，比较慢。导完后，一般都没有错误。

　　6、eclipse上调试android里的程序。

　　先执行：

　　cd android源码目录

　　. build/envsetup.sh

　　lunch 1   # to build the emulator

　　emulator &  # you should see a GUI picture of a phone

　　ddms &     # you should get a splufty debugging console

　　然后在eclipse中配置调试类型和端口：

　　在Run->Debug Configurations->Remote java application上双击，然后，”Host:”设为localhost，”Port:”设为8700，”Connection Type”为Standard(Socket Attach)

　　然后“Apply”

　　注意，在点击”Debug”时苦出错，说8700端口被占用，那么把DDMS程序关掉，重新打开DDMS就OK了。如果提供连不到VM错误时，请注意，要先在DDMS中选中某一进程（对应某一应用程序），才能在eclipse执行 Debug。

　　在eclipse调试时，可以设断点、单步调试。估计google团队也是这样开发、调试android应用程序的

　　7、编译android源码

　　执行：

　　cd android源码目录

　　. build/envsetup.sh

　　那么就会多出mm/mmm等命令，mm/mmm用来编译模块（包括C、C＋＋、JAVA程序）。我们也可以直接在 android源码根目录下执行“make 模块名”来编译模块。

adm 16:40:49
  　1.JAVA_HOME：我们可以发现，其实这就是我们jdk的安装目录，我们设置path，classpath的时候前边都加了%JAVA_HOME%吧，它代表的就是JDk的 安装目录。其实我们也可以在设置path，classpath的时候在前边直接加上jdk安装目录的绝对路径，比如把path设置为C：\Program Files\Java\jdk1.6.0\bin.但是这样并不好，下面我说说用JAVA_HOME的好处。首先，为了方便引用，比如，我们的JDK 安装在 C：\Program Files\Java\jdk1.6.0 目录里，则设置 JAVA_HOME 为该目录路径， 那么以后我们要使用这个路径的时候， 只需输入%JAVA_HOME%即可， 避免每次引用都输入很长的路径串。其次，归一原则， 当我们jdk路径被迫改变的时候， 我们只需更改JAVA_HOME的变量值即可， 而不用逐个更改所有引用了jdk绝对路径的地方，那样会很麻烦，而且很容易出错。另外，一些第三方软件会引用约定好的JAVA_HOME变量。

　　2.CLASSPATH：这个一看名字就能大概看出意思了，他就是我们编译java文件后生成的class文件所存放的路径，我们一般设置为“。”表示当前路径。

　　3.PATH：举个例子吧，我们可以在控制台用javac命令来编译java文件（比如：我们用javac a.java来编译a.java这个文件），而javac.exe在%JAVA_HOME%\bin目录下，我们并不需要把java文件拷贝到这个目录下去，就可以直接编译。这就是因为我们把这个目录设置成了系统的path环境变量。当我们在控制台执行一个命令或程序的时候，系统首先 会在当前目录下找，如果找不到的话，系统就会到PATH环境变量所指的路径下去找。这样设置了以后，我们使用javac编译java文件的时候就不用把 java文件拷到%JAVA_HOME%\bin目录下去，而是直接进入到当前目录下使用javac进行编译。