AS3 asdoc继承问题
我有一个继承 flash.display.Sprite 的 API。当我尝试为该 API 生成 ASDocs 时,ASdoc 显示我的类继承自 flash.display.Sprite,但没有链接或没有可点击的链接Sprite 的 ASDoc。谁能告诉我我缺少什么。
我在 ant 脚本中使用的命令是
<java jar="${asdoc.jar}" dir="${FlexSDK.dir}/frameworks" fork="true" maxmemory="256m" failonerror="true">
<arg line='-load-config "${flex-config.xml}"'/>
<arg line='-source-path ${src.dir}'/>
<arg line='-doc-sources ${src.dir}/com'/>
<arg line='-output ${docs.dir}'/>
<arg value='-library-path+=${FlexSDK.dir}/frameworks'/>
提前感谢您的帮助。
I have an API that inherits flash.display.Sprite .When I try to generate the ASDocs for the API, The ASdoc shows that my class inherits from flash.display.Sprite, but doesnt link or there is no click-able link to the Sprite's ASDoc. Can anyone tell me what I am missing.
The command I am using in my ant script is
<java jar="${asdoc.jar}" dir="${FlexSDK.dir}/frameworks" fork="true" maxmemory="256m" failonerror="true">
<arg line='-load-config "${flex-config.xml}"'/>
<arg line='-source-path ${src.dir}'/>
<arg line='-doc-sources ${src.dir}/com'/>
<arg line='-output ${docs.dir}'/>
<arg value='-library-path+=${FlexSDK.dir}/frameworks'/>
Thanks in advance for your help.
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(3)
ASDoc 为您的类生成文档,而不是为 Flash 的默认类生成文档。
ASDoc generates documentation for your classes, not for the Flash's default classes.
您可以包含 Flash 和 Flex 文档,只要您可以在构建的本地访问它们即可。默认情况下,它们不包含在内,但如果您有权访问,则只需包含另一个库路径。有关更多详细信息,请参阅此帖子:
http://unitedmindset。 com/jonbcampos/2010/01/28/building-asdocs-with-ant/
You can include the Flash and Flex docs as long as you have access to them locally to your build. By default they aren't included, but if you have access you just need to include another library path. See this post for more details:
http://unitedmindset.com/jonbcampos/2010/01/28/building-asdocs-with-ant/
短的:
不可能,因为我们无权访问 flash.* 的注释源。
长的:
AFAICT、ASDoc 从源开始工作,并且仅从源开始工作。虽然 Flex 框架类是开源的,但核心 Flash 框架类不是开源的。它们以二进制形式在 Flex SDK 中提供:[flex_sdk]/frameworks/libs/player/10.1/playerglobal.swc。您可以解压缩它,但它只包含catalog.xml 和二进制library.swf。
相关查询:
http://www.ultrashock.com/forum/viewthread/87106/
(注意对于其他希望在其 ASDoc 中包含 Flex SDK 类的人:请参阅 [flex_sdk]/asdoc/build.xml 以快速开始配置 asdoc。)
Short:
Not possible because we don't have access to the commented source for flash.*.
Long:
AFAICT, ASDoc works from source, and source only. While the Flex framework classes are open source, the core Flash framework classes are not. They are delivered as a binary in the Flex SDK: [flex_sdk]/frameworks/libs/player/10.1/playerglobal.swc. You can unzip this, but it just contains the catalog.xml and binary library.swf.
Related query:
http://www.ultrashock.com/forum/viewthread/87106/
(Note to others looking to include the Flex SDK classes in their ASDocs: see [flex_sdk]/asdoc/build.xml to get a jump start configuring asdoc.)