Apache Ant を使用したプロジェクトのビルド

Apache Ant のセットアップ

Apache Ant を使用する前に、次のセットアップを実行する必要があります。

  • Windows の場合、Apache Ant バージョン 1.10.12 以降をダウンロードしてインストールする必要があります。
    1. Apache Ant プロジェクトの「Welcome」ページにアクセスし、左側のペインで [Binary Distributions] をクリックします。
    2. apache-ant-1.10.12-bin.zip をクリックしてダウンロードします。
    3. zip ファイルの内容を新しいフォルダーに展開します。

Apache Ant をインストールしたら、環境を構成する必要があります。

  1. ANT_HOME 環境変数を、配布された Apache Ant のルート ディレクトリに設定します。

    Windows：

    SET ANT_HOME=<ant_path>

    UNIX：

    EXPORT ANT_HOME=<ant_path>
  2. Ant バイナリ ディレクトリを PATH 環境変数に追加します。

    Windows：

    SET PATH=%PATH%;<ant_path>\bin

    UNIX：

    EXPORT PATH=$PATH:<ant_path>/bin

Apache Ant を使用したビルド

Enterprise Developer は、Apache Ant スクリプト .cobolBuild を使用して COBOL プロジェクトをビルドします。このスクリプトは .cobolProj プロジェクト ファイルから自動的に生成されます。

makefile、MSBuild、シェル スクリプトなどの既存の外部ビルド スクリプトでは、.cobolBuild を Ant ビルド ファイルとして使用して COBOL アプリケーションをビルドできます。

Micro Focus Enterprise Developer UNIX コンポーネント を使用してリモート マシン上で開発されたプロジェクトの Ant ファイルを使用する場合、アプリケーションは Ant が稼働するマシン上でビルドされます。

.cobolBuild を使用してプロジェクトの完全なビルドを実行する方法を次に示します。
Windows コマンド プロンプトの場合：
ヒント: -lib で指定するパスに空白文字が含まれている場合は引用符で囲みます。 
ant -lib "%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\bin\mfant.jar" -f .cobolBuild
UNIX コマンド プロンプトの場合： 
ant -lib $COBDIR/lib/mfant.jar -f .cobolBuild

並列コンパイルを使用すると、マルチ CPU マシンでソース コードをより短時間でコンパイルできます。これを行うには、mf.buildThreadCount=nn パラメーターを追加する必要があります。nn は使用する CPU スレッドの数です。

Windows コマンド プロンプトの場合： 
ant -lib "%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\bin\mfant.jar" -f .cobolBuild -Dmf.buildThreadCount=2
UNIX コマンド プロンプトの場合： 
ant -lib $COBDIR/lib/mfant.jar -f .cobolBuild -Dmf.buildThreadCount=2
制約事項: Multi-processor compilation of the sources in a project is only supported for native COBOL. It is not recommended to use with native Object-Oriented COBOL applications.
増分ビルドを実行する場合は次のとおりです。
Windows コマンド プロンプトの場合： 
ant -lib "%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\bin\mfant.jar" -f .cobolBuild -Dmf.forceCompile=false
UNIX コマンド プロンプトの場合： 
ant -lib $COBDIR/lib/mfant.jar -f .cobolBuild -Dmf.forceCompile=false
注: mfant.jar を CLASSPATH に追加すると、-lib オプションを指定せずに済みます。

UNIX の場合：

export CLASSPATH=$CLASSPATH:$COBDIR/lib/mfant.jar

Windows の場合：

SET CLASSPATH=%CLASSPATH%;%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\bin\mfant.jar
mf.buildThreadCount パラメーターと mf.forceCompile パラメーターを組み合わせると、増分ビルドをより短時間で実行できます。
注: コマンド ラインから複数の実行可能ファイルにコンパイルする場合は、正しいログがコンソールに出力されるように -logger パラメーターを指定する必要があります。また、このパラメーターにより、ビルドの成功または失敗を示すようにビルドの終了コードが正しく設定されます。
-logger com.microfocus.ant.CommandLineLogger
-logger オプションは、次のように環境変数としても指定できます。

Windows の場合：

set ANT_ARGS=-logger com.microfocus.ant.CommandLineLogger

UNIX の場合：

export ANT_ARGS=-logger com.microfocus.ant.CommandLineLogger

-DfilesList パラメーターを使用すると、プロジェクト全体ではなく、特定のファイルをビルドできます。

Windows コマンド プロンプトの場合： 
ant -lib "%ProgramFiles(x86)%\Micro Focus\Enterprise Developer\bin\mfant.jar" -f .cobolBuild -DfilesList="<list-of-files>" <build-config-name>.FileCompile
UNIX コマンド プロンプトの場合： 
ant -lib $COBDIR/lib/mfant.jar -f .cobolBuild -DfilesList="<list-of-files>" <build-config-name>.FileCompile

<list-of-files> は、プログラム名 (該当する場合、プロジェクト ディレクトリからの相対パスも含む) をカンマで区切ったリストです。<build-config-name> は、[Project Properties > Micro Focus > ビルド構成] で設定されているプロジェクトのアクティブなビルド構成の名前です。(注：アクティブなビルド構成の名前にスペースが含まれている場合、<build-config-name> では、スペースをアンダースコアに置き換えたビルド構成の名前になります)。

Eclipse IDE の場合：
  1. Ant ビルドのたびに事前に Eclipse ビルドが開始されないようにする場合は、[Window > Preferences > Run/Debug > Launching] をクリックし、[Build (if required) before launching] オプションをオフにします。
  2. COBOL エクスプローラーで、.cobolBuild ファイルを右クリックし、[Run As > Ant Build] をクリックします。

独自のシェル スクリプトをビルド前またはビルド後のイベントとして設定し、コンパイルの前または後に .cobolBuild Ant スクリプトの一環として実行できます。

ビルド前またはビルド後のイベントを設定するには、次の手順を実行します。

  1. COBOL エクスプローラー ビューでプロジェクトを右クリックし、[Properties] をクリックします。
  2. [Micro Focus > Build Configurations] を展開して、目的の構成の [Events] をクリックします。
  3. [Pre-build event command line] フィールドまたは [Post-build event command line] フィールドにスクリプトのコードを入力します。
  4. [Apply and Close] をクリックします。
注:

[Events] フィールドで変数を参照する場合は、リンク リソースのパス変数の前に ${pathVar. を付け、変数を } で閉じる必要があります。たとえば、PROJECT_LOC という変数は ${pathVar.PROJECT_LOC} としてコーディングする必要があります。

リンク リソースのパス変数は、プロジェクトのプロパティで次のように定義されます。

  1. COBOL エクスプローラーでプロジェクトを右クリックし、[Properties > Resource > Linked Resources] をクリックします。
  2. [Path Variables] タブで変数のリストを確認します。
上位ヘルプ： COBOL アプリケーションのコンパイル