为什么我的 SWC 库没有代码提示？

Question

我最近将我的大部分可重用代码编译成 SWC，以便组织和易于使用。此后，我的任何文档都没有出现在 Flash Builder 提供的代码提示中。我已经搜索了项目设置，但我一直无法找到此类功能的设置，我不知道为什么它不再起作用了。

我使用 Flash Builder 的 Build Automatically 功能编译了 SWC。我还没有尝试使用 ANT 进行编译，但下次构建时可能会尝试。 asdocs 能够相对轻松地为我的所有库编译完整的文档，如果我自己使用原始 AS 文件，代码提示就可以工作，所以我认为这与我编写文档的方式没有任何关系。示例：

/**
 * <p>Batch adds variables from a generic object using name-value pairs</p>
 * @param variables A generic <code>Object</code> that contains name-value 
 * pairs that will be used as the arguments of the REST request
 */
public function addVariables( variables:Object ):void {}

知道为什么代码提示不再起作用了吗？

Answer 1

Flash Builder 使用嵌入在 SWC 中的 ASDocs 来提供代码提示 - 不幸的是，FB 在构建 SWC 时不包含这些文档。

但是，可以使用 ANT“手动”完成：

<target name="insertASDocs">
    <zip destfile="PATH_TO_YOUR_SWC" update="true">
        <zipfileset dir="ASDOCS_FOLDER/tempdita" prefix="docs">
            <include name="*.*"/>
            <exclude name="ASDoc_Config.xml"/>
            <exclude name="overviews.xml"/>
        </zipfileset>
    </zip>
</target>

PATH_TO_YOUR_SWC 是相对路径和 swc 名称（例如：myFolder/mySwc.swc）。 ASDOCS_FOLDER 是存储您生成的文档的文件夹。

ANT 脚本只是将 ASDocs 添加到 SWC - 之后，应该会出现代码提示。

更新：

忘了说生成文档时需要将keep-xml设置为true（如果将它们插入到swc中）：

<asdoc keep-xml="true" ...