在Eclipse中开发Android程序如何添加javadoc目录以及显示API的说明

    作者:课课家教育2016-04-13 09:34:54

       Eclipse 是一个开放源代码的、基于java的可扩展开发平台。而对于其本身来说,它只是一个框架和一组服务,用于通过插件组件构建开发环境。同时Eclipse 附带了一个标准的插件集,包括Java开发工具(Java Development Kit,JDk)。而API是(Application Programming Interface)的缩写,简称应用程序编程接口,其是一些预先定义的函数,目的是提供应用程序与开发人员基于某软件或硬件得以访问一组例程的能力,而又无需访问源码,或理解内部工作机制的细节。

    在Eclipse中开发Android程序如何添加javadoc目录以及显示API的说明_java_eclipse_课课家

     

           在Windows中使用Eclipse做Android应用的时候,特别烦人的是看不到Android API类与函数的声明和注释,还有传入参数的名称。

      这个一切一切都是因为没有设置好android.jar的javadoc路径,呵呵,题外一句,java有个特别好的工具就是javadoc,使用这个工具可以从源代码的标准注释中生成帮助文档。

      另外发两个可以用的android SDK帮助文档镜像:

        

      因为在Linux下面使用Eclipse的时候是可以详细显示的。。。所以在windows里面试了一下,竟然可以了,

      先来看看,这个状况,在没有设置doc路径的时候,函数说明,没有,传入参数,让人看不懂,如下:

      android.view.animation.TranslateAnimation.TranslateAnimation(int arg0, float arg1, int arg2, float arg3, int arg4, float arg5, int arg6, float arg7)

      Note: This element neither has attached source nor attached Javadoc and hence no Javadoc could be found.

      首先需要下载android的帮助文档,然后解压出来,

      然后打开eclipse右键你的工程,点属性,

      点击你的 "Java Build Path"里面的在第一位的Libraries路径,中android.jar的javadoc路径是否已经设置了,如果设置了,看下设置的是什么路径。

      现在版本,好像无法设置android.jar的javadoc路径,但是只有设置了这个路径,才会显示API的说明文档。。。

      没有办法了,如果没有设置则设置一个路径方法如下图,如果已经有路径了,直接把API文档放到那个路径中去了,一般默认的都会在sdk目录中的docs文件夹中,。

      点击"Javadoc location"在右边的地址框里面选中,你解压出来的文件夹中的"reference"目录,

      然后就可以看到效果了,

      谷歌api的安装包

      

      Android开发包

         

      许可证

      

      工具

        

      文档

       

      样例

      

      USB驱动

        

         本文主要介绍在Eclipse中开发Android程序是如何添加javadoc目录以及显示API,在这个过程我们借助了java的javadoc工具来实现这个目标。还有一些安装包网址和一些学习资料,感兴趣的朋友可以那下载或者查看。

课课家教育

未登录