如何使用文档构建SWC

时间:2013-10-18 18:41:39

标签: actionscript-3 flex ant swc asdoc

更新

  1. 已解决:使用swc
  2. 嵌入doc
  3. 解决了:奇怪的参数名称:param0,param1等

  4. 我使用swc创建了compc lib。

    然后我用asdoc创建了lib doc。

    但是我不知道如何将它们绑定在一起,因为当我在另一个项目中使用.swc时,params名称很奇怪(如myMethod(param0:Number))并且没有文档描述。

    我正在使用Ant,这是我的配置文件:

    <?xml version="1.0" encoding="utf-8" ?>
    <project name="uil" default="compile" basedir=".">
    
        <property name="flexsdk" location="C:/sdks/flex_sdk_4.6/bin"/>
    
        <property name="compc" location="${flexsdk}/compc.exe"/>
        <property name="asdoc" location="${flexsdk}/asdoc.exe"/>
    
        <property name="src" location="../src"/>
        <property name="bin" location="../bin"/>
    
        <target name="compile" depends="doc">
            <exec executable="${compc}" failonerror="true">
                <arg line="-debug=false" />
                <arg line="-optimize=true" />
                <arg line="-strict=true" />
                <arg line="-locale=en_US" />
                <arg line="-include-sources=${src}" />
                <arg line="-output=${bin}/uil.swc" />
            </exec>
        </target>
    
        <target name="doc">
            <exec executable="${asdoc}" failonerror="true">
                <arg line="-main-title 'UIL API Documentation'" />
                <arg line="-window-title 'UIL API Documentation'" />
                <arg line="-source-path ${src} -doc-sources ${src}" />
                <arg line="-output ${bin}/uil-asdoc" />
            </exec>
        </target>
    
    </project>
    

    编辑:如何解决

    创造所有魔力的界限是:

    <taskdef resource="flexTasks.tasks" classpath="${FLEX_HOME}/ant/lib/flexTasks.jar" />
    

    然后我将所有<exec>代码替换为<compc><asdoc>,一切正常。您可以看到整个代码here.

1 个答案:

答案 0 :(得分:1)

尝试在zip框架的build.xml中使用Starling ant目标:

<!-- call asdoc to generate dita xml files -->
<asdoc output="${temp.dir}" lenient="true" failonerror="true" keep-xml="true" skip-xsl="true" fork="true">
  <compiler.source-path path-element="${basedir}/src" />
  <doc-sources path-element="${basedir}/src" />
</asdoc>
<!-- update swc with asdoc xml -->
<zip destfile="${deploy.dir}/${ant.project.name}.swc" update="true">
  <zipfileset dir="${temp.dir}/tempdita" prefix="docs">
    <include name="*.*"/>
    <exclude name="ASDoc_Config.xml" />
    <exclude name="overviews.xml" />
  </zipfileset>
</zip>