在FlexBuilder3中自带了asDoc(Doc生成工具). asDoc.exe的位置在../Flex Builder 3 Plug-in/sdks/3.0.0/bin下
使用FlexBuilder3中的External Tools 运行asdoc.exe,具体配置如下:
1.点击eclise工具按钮中的 open External Tools Dialog...
2.右键点击Program 新建
3.配置asDoc路径,源代码路径,以及生成时所需要的参数.
4.点击Apply然后Run就可以在你项目中的src目录下生成 blueonlyDocs的文件夹,里面就是所生成的doc,这样就大功告成了.
需要注意的是:
1.如果你的注释中包括中文,或者其他的非英文的语言,你需要在Common中设置它的编码格式UTF8:
2.如果您的代码中引用了AIR所需的类或者接口,生成的过程会报错,你需要在参数中添加AIR的swc路径,官方的方法是:
../bin/asdoc -doc-sources C:/myApplication/myComponents/MyAirComboBox.as -library-path+=../frameworks/libs/air -main-title "My AIR API Documentation" -window-title "My AIR API Documentation" -output air-asdoc This command assumes the following:
- You run the command from the directory C:/Program Files/Adobe/Flex Builder 3/sdks/3.0.0/asdoc in your Flex Builder installation directory structure. If you are using the Flex SDK, or have installed Flex Builder on another operating system, modify the paths in this command as necessary.
-
The AIR SWC files are installed in the directory C:/Program Files/Adobe/Flex Builder 3/sdks/3.0.0/frameworks/libs/air. This is the default directory location for a Flex Builder installation. This command uses the library-path option to the ASDoc tool to specify the directory location of the AIR SWC files. The"+=" operator to the -library-path option specifies to append the AIR SWC files to the Flex SWC files.
-
The ASDoc tool writes the output to the directory C:/Program Files/Adobe/Flex Builder 3/sdks/3.0.0/asdoc/air-asdoc.
但是我怎么试也不好用,如果哪位高手会的话请告诉我,我的方法是直接把../frameworks/libs/air 下的所有文件copy到../frameworks/libs中,这样不用添加任何参数就可以编译运行.
好了,今天就写这么多了,祝您好运,以下附上我自己生成的Doc:
运用ASDoc工具
原文地址: http://livedocs.adobe.com/flex/3/html/asdoc_9.html
译者注:
ASDoc是adobe官方提供的ActionScript的API文档生成工具,现在已经集成在FlexBuilder3中
打开ASDoc工具的方法:
1.安装FlexBuilder3后,
打开 开始—>程序—>Adobe—>Adobe Flex 3 SDK Command Prompt
2.此时会进入cmd命令行界面,用cd命令进入你的工程目录下
例如我的工程目录是E:/flexwork
当前是cmd指向在C:/Program Files/Adobe/FLexBuilder3/
3.首先输入 E:进入E:/
然后 输入 cd flexwork
屏幕显示E:/flexwork/> 后即可使用asdoc命令编译API文档了
编译后的asdoc文档会在E:/flexwork/路径下输出一个asdoc-output文件夹,运行里面的index.html就是API文档主页
你可以使用以下的ASDoc命令参数来制定类文件列表
doc-classes doc-sourcess doc-namespaces
doc-classes和doc-namespaces要求用source-path指定类文件文件所在的根目录
如下是一个最基本的列子,用doc-classes参数指定类文件列表:
asdoc –source-path . –doc-classes comps.CraphingWidget comps.GraphingWidgetTwo
这个例子中,类文件必须是comps/GraphingWidget.as和comps/GraphingWidgetTwo.as,并且comps必须是位于运行asdoc命令所在位置下的一个子文件夹。doc-classes的参数中用‘.’对应类所在的包(package)名
译者注:如果类文件就在当前目录下,source-pathh参数后面的内容需要填写’.’
如果类文件没有在当前目录下,可以用source-path参数指定该目录。
下面的例子,如果两个类文件在C:/flex/class_dir/comps下,可以像这样使用asdoc命令:
asdoc –source-path C:/flex/class_dir/comps –doc-classes comps.CraphingWidget comps.GraphingWidgetTwo
如果你的程序里引用了包含有swc文件的库。
在下例中,可以使用 –library-path参数指定要包含的swc文件:
asdoc –source-path . –doc-classes myComponents.BlueButton –library-path C:/myLibs
用 doc-sources参数可以指定源文件夹。通过该参数,asdoc会递归搜寻目录。
下面的命令会生成当前目录及其子目录下所有的类:
asdoc –source-path . –doc-sources
用 doc-namespaces参数可以指定要输出的命名空间。
下面的命令会把core framework下的所有类文件输出成文档:
asdoc -source-path frameworks -namespace http://framework frameworks/core-framework-manifest.xml -doc-namespaces http://framework
排除类文件
用doc-classes, doc-sources和 doc-namespaces命令输出所有的类文件时,
会有以下三点例外:
- 用exclude-classes参数指定的类不会输出
- 类中包含了@private标签的不会被输出
- SWC中的类,不会被输出
以下的例子中,会输出当前目录及其子目录下所有类文件,除了comps/PageWidget 和 comps/ScreenWidget.as:
asdoc -source-path . -doc-sources . -exclude-classes comps.PageWidget comps.ScreenWidget
注意:
这些被排除的类,仍然会同其他类一样被编译,只是内容不会被输出
如果将exclude-dependecies参数设为true,当编译类时所依赖的相关类不会被输出。
该参数默认值是false,意味着所有与指定类相关联的类都会被正常输出成文档。
例如:你用doc-classes指定了类A,如果类A中 import了类B,那么类A和类B都会被输出。
asdoc命令参数列表:
asdoc命令参数使用方法等同于mxmlc和compc
更多的mxmlc和comp信息,参见 Using the flex Compilers
参数功能列表如下:
Option |
Description |
-doc-classes path-element [...] |
指定需要被输出成文档的类文件,这些类文件必须放在资源路径下[默认参数] 该参数使用方法等同于compc组件编译器的-include-classes参数,更多信息参见 Using compc, the component compiler
|
-doc-namespaces uri manifest |
要求被输出成文档的类文件URIs列表,这些类文件必须放在资源路径下。 必须包含至少一个URI并指出命名空间内容的明确位置 该参数使用方法等同于compc组件编译器的-include-namespaces参数,更多信息参见Using compc, the component compiler
|
-doc-sources path-element [...] |
需要被输出成文档的文件目录,并且其子目录也会被递归输出 该参数使用方法等同于compc组件编译器的-include-sources参数,更多信息参见Using compc, the component compiler
|
exclude-classes string |
不需要被输出的类文件列表,必须指定类名 或者, 该类中的ASDoc命令里包含了 @private 标签,同样也不会被输出 -exclude-dependencies true|false 决定是否所有的相关类都会输出,如果设true,与输出类相关的类不回被输出。默认值为false |
-footer string |
文档中HTML页面底部的显示信息 |
-left-frameset-width int |
控制文档左边目录宽度的整数值。你可以根据你的包名来改变这个值 默认值是210px |
-main-title "string" |
文档中HTML页面头部显示信息 默认值是"API Documentation". |
-output string |
输出文档的目录名. 默认值 "asdoc-output". |
-package name "description" |
输出文档中对应的包名。你可以指定一个以上的包 下例中,输出了两个包: asdoc -doc-sources my_dir -output myDoc -package com.my.business "Contains business classes and interfaces" -package com.my.commands "Contains command base classes and interfaces" |
-templates-path string |
ASDoc模板目录的路径. 默认值是ASDoc 安装目录下的asdoc/templates。该目录包含了用于输出成文档的所有的HTML, CSS, XSL文件image |
-window-title "string" |
文档中浏览器顶部显示信息 默认值是"API Documentation". |
以下asdoc命令适用于compc组件编译器:
- -source-path
- -library-path
- -namespace
- -load-config
- -actionscript-file-encoding
- -help
- -advanced
- -benchmark
- -strict
- -warnings
更多信息,参见 Using mxmlc, the application compiler还有很多其他程序编译参数可以使用,这里不再详加阐述,在ASDoc tool中你可以像使用mxmlc and compc一样使用同样的命令构造文件。
原文:http://www.blueidea.com/tech/multimedia/2008/6134.asp
分享到:
相关推荐
ASDoc生成ActionScript的API类文档 ASDoc生成ActionScript的API类文档 ASDoc生成ActionScript的API类文档
Flash-Builder-里利用ASDOC生成在线API文档配置.doc
NULL 博文链接:https://damoqiongqiu.iteye.com/blog/1481207
asdoc.zip flex
Flex Library AsDoc Demo 查看我的博客<Flex AsDoc 完整版>,有详细的Flex Library AsDoc说明
以flexbuilder为例,在你安装的目录下X:\Program Files\Adobe\Flex Builder 3\sdks\3.2.0\asdoc\templates。改文件夹就是控制稳定框架本地化的。你只要办里面的相关文字翻译为中文就可以了。关联文件就是xsl格式的...
sina-microblog-api-asdoc-rc.zip
咕as声一个Grunt任务插件,用于为Adobe Flex / ActionScript / MXML / FLV / etc生成文档。 Apache / Adobe Flex SDK中带有asdoc工具的应用程序。入门这个插件需要~0.4.2 如果您以前从未使用过 ,请务必查看...
此文档主要是用于讲述ASDoc中各种标签的作用,文档中附有详细的说明和插图能够让您更加容易理解。
flex3的cookbook书籍完整版dpf(包含目录),目录... 使用ASDoc和Ant生成文档 25.11节. 使用Rake编译Flex应用程序 25.12节. 使用ExpressInstall 25.13节. 使用Flex Builder 3的Memory Profiling查看内存快照 第二十六章...
API(ASDoc)文档。然而,即使他们有大量的文档,用户指南和API 文档之间的还是有一个 很大的差距。用户向导涵盖了一系列的课题,从如何开始到使用比较复杂的功能;但都停止 在这些不很复杂的功能上,比如:样式扩展...
Flex Realspace产品在sp3时上线,急需制作帮助文档,由于在开发的时候没有考虑后期的帮助文档,查了很多资料,希望通过ASDoc达成愿望,感兴趣的朋友可以了解下,或许对你有所帮助
使用 Flash Builder 可以完成的工作 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . ...
教案ASDoc标签材料.pdf
ASDoc标签知识点.pdf
asdoc :对应于API的文档,它的首页是PureMVC_AS3_2_0_4/asdoc/index.html src:对应于puremvc的的源代码, PureMVC_AS3_2_0_4/src/org/puremvc/as3 / … bin:对应于Flex / AIR的的项目中使用的swc(在Flex4中安装...
3.4 自动生成EventHandler 3.5 条件断点 第四章 Flex SDK 4 新特性 4.1 主题 4.2 布局 4.3 特效 4.4 样式 4.5 状态 4.6 双向绑定 4.7 ASDoc 4.8 SWFObject 与 HTML Template 第五章 自定义组件开发 5.1 ...
Flex 4概述 (与学习资源) MXML 2009 新增MXML标签 改进的视图状态 (1) 改进的视图状态 (2) MXML图形元素与FXG Spark组件架构 Spark容器 Spark布局模型 Spark动画和特效组件 Pixel Bender集成 Spark文本...
用于制作并生成as3 api 帮助手册chm的项目源码,把adobe官方的离线文档生成chm手册用,给有需要的朋友。