企业手机网站建设资讯,wordpress开发ide,seo网站优化经理,电脑做服务器发布网站吗最近一直在做android开发#xff0c;昨天经理让我写个接口SDK做个接口文档#xff0c;以便后面的开发。这让我很焦灼#xff0c;SDK怎么做#xff1f;要是只有敲代码还好。可是那个接口文档#xff01;#xff01;#xff01;文档这东西最讨厌了#xff0c;头都大了后来…最近一直在做android开发昨天经理让我写个接口SDK做个接口文档以便后面的开发。这让我很焦灼SDK怎么做要是只有敲代码还好。可是那个接口文档文档这东西最讨厌了头都大了后来查了下资料JDK有个自带的Javadoc可以根据代码中的注释自动生成文档。一下子世界变亮了有木有文档可以自动生成那生成文档我依据是什么查下资料发现只要在类、变量、方法上加注释就能自动生成文档了。这些注释有自己的规范可以先看看下面这篇博文文档的事情搞定了接下来就是SDK了。还没开始制作就遇到一个问题我是要新建Android工程、还是Java工程考虑到我只要实现网络数据的请求不需要提供任何界面这里就选择了Java工程。(需要提供界面的会遇到解决资源文件不能打包的问题这里有篇博文需要的同学可以去看看首先学会怎么将工程打包成一个jar包(记得学java的第一节课上过)1、在Eclipse中右击需要打包的工程,选择export2 在export中展开java,选择JAR file点击next3 选择需要导出的工程、导出路径以及jar包的名字点击finish这样就能在改路径下找到我们生成的jar包了jar包搞定了接下来就轮到文档了根据文章开头的Javadoc语法编辑工程后就可以生成文档了步骤如下1 右击工程选择export2 在export中展开java 选择Javadoc点击next3 在接下来的页面中Javadoc command 中选择jdk安装路径下的javadoc.exeSelect types for which Javadoc will begenerated 选择生成doc的工程User standard doclet 选择doc的路径点击next4 使用默认设置点击next5 点击finish就能在对应的目录下找到生成的doc打开对应的文件夹能看到打开 index就能在浏览器中看到刚刚生成的文档了是不是很眼熟似曾相识。。。跟api文档好像在生成文档的时候可能会看到这样的提示“错误 编码 GBK 的不可映射字符”说明注释中有中文。解决方法在生成文档的最后一步Vm options中输入 -encodingutf-8 -charset utf-8 就可以了就这样搞定了。知道做法以后生活是不是一下子就美好了乖乖做SDK去。。。参考博文
