apache-flex - Flash Builder 4 中的 ASDoc 编译错误

Question

我似乎无法弄清楚为什么我每次尝试在 Flash Builder 4 中编译 ASDoc 时都会继续收到此错误。

我确实成功地在 ASDoc 中创建了一个 asdoc-output 文件夹，但它是不完整的。只显示 toplevel.xml 和一个 tempdita 文件夹。

这是在我的控制台上显示的错误

Error at xsl:choose on line 46 of processHTML.xslt:  java.io.FileNotFoundException:  /Users/NEWYORK/abritez/Documents/workspaces/ate/ATE_Shell/asdoc-output/index.tmp (No such  file or directory)  at xsl:apply-templates (file:/Users/NEWYORK%5Cabritez/Documents/workspaces/ate/ATE_Shell/asdoc-output/tempdita/processHTML.xslt#25)     processing /htmlTransformation failed: Run-time errors were reported

Line 46 is in ProcessHTML.xslt is the initial <xsl:choose> in the element bellow.

<xsl:template match="html">
<xsl:copy-of select="$noLiveDocs"/>
<xsl:choose>
  <xsl:when test=".//frameset">
    <xsl:copy-of select="$frameDocType"/>
  </xsl:when>
  <xsl:otherwise>
    <xsl:copy-of select="$docType"/>
  </xsl:otherwise>
</xsl:choose>
<xsl:choose>
  <xsl:when test="$isLiveDocs"/>
  <xsl:otherwise>
    <xsl:value-of select="$markOfTheWeb"/>
  </xsl:otherwise>
</xsl:choose>
<xsl:element name="html">
  <xsl:apply-templates/>
  <xsl:copy-of select="$copyrightComment"/>
  <xsl:value-of select="$newline"/>
</xsl:element>
</xsl:template>

我去External Tool Configuration添加了asdoc的位置

/Applications/Adobe Flash Builder 4/sdks/flex_sdk_4.1/bin/asdoc

then i added my Working Directory

${workspace_loc:/ATE_Shell}

And lastly I inserted all my arguments

-lenient-source-path src
-doc-sources src-external-library-path=/Users/NEWYORK\abritez/Documents/workspaces/ate/ActivityToolkitLib/bin/ActivityToolkitLib.swc-external-library-path=/Users/NEWYORK\abritez/Documents/workspaces/ate/ATE_Template/bin/ATE_Template.swc-external-library-path=/Users/NEWYORK\abritez/Documents/workspaces/ate/AssesmentCommunicationLib/bin/AssesmentCommunicationLib.swc-external-library-path=/Users/NEWYORK\abritez/Documents/workspaces/ate/BFW_UI/bin/BFW_UI.swc-external-library-path=/Users/NEWYORK\abritez/Documents/workspaces/ate/DiagnosticReporter/bin/DiagnosticReporter.swc

UPDATE:I ended up rolling back to 3.5 and did a test application with only one method to document and got this error.

My method

package com.test
{
import mx.containers.Canvas;


public class Grouptest extends Canvas
{
    public function Grouptest()
    {
        super();
    }

    /**
     *  Hello
     * 
     * @param   value   Some string
     * */

    public function set testMe(value:String):void
    {
        trace("value " + value)
    }
}
} 

我的错误

Loading configuration file /Applications/Adobe Flash Builder 4/sdks/3.5.0/frameworks/flex-config.xml Adobe ASDoc Version 3.5.0 build 12683 Copyright (c) 2004-2007 Adobe Systems, Inc. All rights reserved. Error: '' is not a directory Use 'asdoc -help' for information about using the command line

任何帮助或指出正确的方向将不胜感激。我过去曾让 ASDoc 运行过，所以我确信我一定忽略了一些东西。

Answer 1

众所周知，ASDoc 不擅长报告错误和转移注意力。

以下适用于 Flex 3。我认为它仍然适用于 Flex 4。

要记住的主要事情是，ASDoc 只执行一次，不像编译器(至少)执行两次。这会暴露编译器为您隐藏的问题，通常如果您将某些内容声明为可绑定(bind)但不将类设为 IEventDispatcher，编译器会在第一遍时为您作弊，但 ASDoc 只会失败。

另一个常见问题是使用@see 等标签时找不到文件。如果您命名的路径错误，ASDoc 过去常常会崩溃而不生成。

根据我的经验，第三个最常见的问题是格式错误的 html 标签。忘记添加

或将 HTML 标签添加到不接受它们的 ASDoc 标签中。

可悲的是，因为 ASDoc SO 不善于报告这些错误并且没有优雅地处理错误，如果不逐行检查代码就可以找到问题所在，这是一场皇家噩梦......