教你方便使用ASDoc《双击轻松生成API文档》

2009

6-13

用过ASDoc的同学都知道，使用ASDoc需要先去打开Adobe放在开始菜单中的Adobe Flex 3 SDK Command Prompt文件
然后在打开的cmd窗口中输入命令
比如这样：

d:
cd item\fireas\
asdoc -source-path src code -doc-classes ExportASDoc

每次都这样输入一下，是挺烦的有没有办法咱们做个bat文件，运行一下他就自动生成呢？
　
方法：（第一次弄先按照下面的步骤来）
看上去写了很多东西，其实很简单的！如果对dos命令很熟悉，那么下面的步骤太好弄了！下次在弄的时候，就不需要下面的操作了！
1、找到要生成API文档的目录，在下面创建一个bat文件，用记事本编辑打开它；
　
2、找到Adobe放在开始菜单栏中的Adobe Flex 3 SDK Command Prompt文件，打开他的属性面板，找到目标和起始位置；

图片地址：uploads/200906/13_123319_1.jpg

　
3、接下来在我们自己创建的bat文件中的最上面加入：
（下面这段dos命令是根据我的起始位置加的，因此实际情况以你自己的起始位置为准）

d:
cd Program Files\Adobe\Flex Builder 3

　
4、接下来把目标中的文字复制出来吧，在那么小的窗口看怪可怜的，里面东西又多！于是得到

C:\Windows\System32\cmd.exe /k FlexFrameworkCmdPrompt.bat "d:\Program Files\Adobe\Flex Builder 3\sdks\3.1.0" "d:\Program Files\Adobe\Flex Builder 3\jre"

"FlexFrameworkCmdPrompt.bat"的后面都是bat运行时的参数："d:\Program Files\Adobe\Flex Builder 3\sdks\3.1.0" "d:\Program Files\Adobe\Flex Builder 3\jre"，暂时记住这个步骤，接下来进行下面的工作
　
5、在你的起始位置中找到FlexFrameworkCmdPrompt.bat文件，然后用记事本编辑打开它，将FlexFrameworkCmdPrompt.bat中的内容都复制到你创建的bat中；
现在咱们创建的bat文件应该已经是下面这样了

d:
cd Program Files\Adobe\Flex Builder 3

@rem
@echo Setting environment for using the Flex SDK.
@rem

@set PATH=%1\bin;%1\frameworks;%2\bin;%2\lib;%PATH%;
@set JAVA_HOME=%CD%\jre

java -version
compc -version

　
6、把第四步中所说的两个参数拿出来，将上面这一段是%1的地方替换成第一个参数，是%2的地方替换成第二个参数，这样现在的文件就已经是一个正常的可以使用asdoc的bat文件了；

d:
cd Program Files\Adobe\Flex Builder 3

@rem
@echo Setting environment for using the Flex SDK.
@rem

@set PATH=d:\Program Files\Adobe\Flex Builder 3\sdks\3.1.0\bin;d:\Program Files\Adobe\Flex Builder 3\sdks\3.1.0\frameworks;d:\Program Files\Adobe\Flex \bin;d:\Program Files\Adobe\Flex \lib;%PATH%;
@set JAVA_HOME=%CD%\jre

java -version
compc -version

　
7、接下来把我们自己的ASDoc命令放进去吧！最后的结果就是：

d:
cd Program Files\Adobe\Flex Builder 3

@rem
@echo Setting environment for using the Flex SDK.
@rem

java -version
compc -version

d:
cd item\fireas\

asdoc -source-path src code -doc-classes ExportASDoc

保存成bat，每次只需要双击这个文件就可以生成文档了，具体有什么关于ASDoc的要求也可以写在命令中

图片名称：Documentation was created

图片地址：uploads/200906/13_123906_2.jpg

　
结尾：
以后在弄的时候，就方便多了，只需要把asdoc的命令改掉就行了，而上面东西都不用弄的，或者是说你的安装路径跟我一样，那么你也可以直接把我的复制过去，或者改改路径，而不用按上面的步骤一步一步的做！
　
完结，感谢你看完该文章，如果有什么问题，可以跟帖问！
　
另外下面这个是Flash Builder 4的版本

cd\
d:
cd Program Files\Adobe\Flex Builder 3

@set PATH=d:\Program Files\Adobe\Flex Builder 3\sdks\3.1.0\bin;d:\Program Files\Adobe\Flex Builder 3\sdks\3.1.0\frameworks;d:\Program Files\Adobe\Flex Builder 3\jre\bin;d:\Program Files\Adobe\Flex Builder 3\jre\lib;%PATH%;
@set JAVA_HOME=%CD%\jre

cd\
d:
cd item\fireas\

asdoc -source-path src code -doc-classes ExportASDoc

pause

小贴士：下面加个pause可以暂停cmd让他不关闭，这样就可以看看运行的结果，是否输出文档成功

[最后修改由 sunbright, 于 2009-06-15 10:51:36]