1

ASDoc Ant タスクを機能させようとしています。

<target name="asdoc" depends="compile">
    <mkdir dir="${dist_asdocs}"/>
    <asdoc 
    docSources="${srcdir}"
    output="${dist_asdocs}"
    executable="${FLEX_HOME}/bin/asdoc.exe" />
</target>

実行すると、ASDoc から「エラー: タイプが見つからないか、コンパイル時の定数ではありませんでした: XXX」のようなエラーが表示されます。ASDoc を手動で実行するときは、「asdoc -source-path src -doc-sources src」とします。-source-path 値を省略すると、同じエラーが発生します...では、Ant タスクを機能させるにはどうすればよいでしょうか?

4

2 に答える 2

3

うーん、Windows のみで実装されているためテストできません (asdoc.exe を実行しようとします)。

しかし、私は asdoc の ant タスクがないための独自の解決策を書きました。

<exec executable="${FLEX_HOME}/bin/asdoc" dir="${basedir}">
    <arg value="-source-path"/>
    <arg path="${basedir}/src"/>

    <arg value="-doc-sources"/>
    <arg path="${basedir}/src"/>

    <arg value="-output"/>
    <arg path="${DOC_DIR}"/>

    <arg value="-main-title"/>
    <arg path="${ant.project.name} Documentation"/>

    <arg line="-library-path+=${basedir}/libs"/>
</exec>

もちろん、Windows を使用している場合は、実行可能ファイルを asdoc.exe に変更する必要があります。すべての / を \ に置き換える必要があるかどうか、または ant がこれを行うかどうかはわかりません。ライブラリ パスにまだない .swcs を使用しない場合は、最後を省略できます。または、少なくとも正しいディレクトリを指すように変更する必要があります。

編集: asdoc-task のソース コードを確認しましたが、基本的には exec-task と同じです。コマンド ライン引数の小さなサブセットしか許可されていません。

また、source-path 引数を使用せずにソリューションをテストしましたが、驚いたことにまだ機能していました。さらにいくつかのテストを行ったところ、次のことがわかりました。

source-path が指定されていない場合は、asdoc(.exe) がsrcデフォルトとして想定されます。したがって、asdoc-task は通常、その規則を使用すると機能しますが (たとえば、Flex Builder はこれを行います)、そうしないと失敗します。

したがって、asdoc-task を使用するには、ソース ディレクトリに名前を付ける必要がありますsrc。

于 2008-10-14T00:34:47.087 に答える
1

asdoc ant タスクは、最初にリリースしてから開発していないため、使用しないことをお勧めします。サイモンが述べたように、可能なことの小さなサブセットしかサポートしていないため、おそらく exec タスクを使用する方がよいでしょう。

于 2009-02-11T16:35:16.727 に答える