使用FlashBuilder4生成ActionScript的API文档(包括一个64位电脑会出现的错误)
请注意,我发这篇文章时使用的是Flash Builder 4.6和sdk4.6.1,所以以下很多参数中都不是定值,你在输入参数时应根据你Flash Builder具体版本来确定。
生成步骤:
1.运行 -> 外部工具 -> 外部工具配置;
2.在程序下新建一个运行程序,命名为ASDoc;
3.在位置下添加:C:\Program Files (x86)\Adobe\Adobe Flash Builder 4.6\sdks\4.6.1\bin\asdoc.exe
在工作目录下添加:${project_loc}
在自变量下添加:-source-path src
-doc-sources src
-doc-sources src
4.点击“运行”。
如果运行成功,那么你的ASDoc程序创建成功了,直接进入第5步;
如果运行失败,可能会出现错误:Error loading: F:\Java Eclipse\set up\jdk\jre\bin\server\jvm.dll
错误原因:因为flash builder是基于eclipse的,而eclipse是使用的java技术,java运行需要jre。
而flash builder需要运行在32位的jre上,如果我们安装的java是64的,那么就会出这样的错误。
当没有配置时,会优先查找JAVA_HOME路径,而我的环境中JAVA_HOME配置的是64位的JDK,
flex需要调用的是32位的jvm.dll,因此加载失败。
解决方法:将flex默认的环境中JAVA_HOME配置设定为FlashBuilder自带的jre或者其他32位的jre。
解决步骤:
1)运行 -> 外部工具 -> 外部工具配置;
2)点击外部工具配置界面的“环境”按钮,在这里配置jre;
3)点击“新建”按钮,
在名称处填写:JAVA_HOME
在值处填写:C:\Program Files (x86)\Adobe\Adobe Flash Builder 4.6\jre
4)点击“确定”,并再次运行,如果没有输错值,应该就可以成功了;
5.现在我们可以使用我们的ASDoc程序生成API文档。我以一个Ballpbk Flex库项目举例,选中此项目。
6.运行 -> 外部工具,点击ASDoc运行,这是控制台会输出一串纠结的东东,可以不用管;
7.而我们的项目文件夹下会出现一个名为asdoc-output的包,点开包中的html文件就是我们所需要的API文件.
今天下午我上网查了下生成API的方法,网上说了很多方法,但要么实现麻烦,要么语焉不详。
我走了下流程,将其发出来供大家参考使用,希望大家能少走弯路。