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

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

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

Visual COBOL Development Hub を使用してリモート マシン上で開発されたプロジェクトの Ant ファイルを使用する場合、アプリケーションは Ant が稼働するマシン上でビルドされます。.cobolBuild を使用してプロジェクトの完全なビルドを実行する方法を次に示します。
Windows コマンド プロンプトの場合:
ant -lib %ProgramFiles(x86)%\Micro Focus\Visual COBOL\bin\mfant.jar -f .cobolBuild
UNIX コマンド プロンプトの場合:
ant -lib $COBDIR/lib/mfant.jar -f .cobolBuild

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

Windows コマンド プロンプトの場合:
ant -lib %ProgramFiles(x86)%\Micro Focus\Visual COBOL\bin\mfant.jar -f .cobolBuild -DthreadCount=2
UNIX コマンド プロンプトの場合:
ant -lib $COBDIR/lib/mfant.jar -f .cobolBuild -DthreadCount=2
制約事項: プロジェクト内のソースの複数プロセッサによるコンパイルは、ネイティブ COBOL に対してのみサポートされます。ネイティブのオブジェクト指向 COBOL アプリケーションでの使用はお奨めしません。
増分ビルドを実行する場合は次のとおりです。
Windows コマンド プロンプトの場合:
ant -lib %ProgramFiles(x86)%\Micro Focus\Visual COBOL\bin\mfant.jar -f .cobolBuild -DforceCompile=false
UNIX コマンド プロンプトの場合:
ant -lib $COBDIR/lib/mfant.jar -f .cobolBuild -DforceCompile=false
threadCount パラメーターと 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
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]、[OK] の順にクリックします。
注:

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

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

  1. COBOL エクスプローラーでプロジェクトを右クリックし、[Properties > Resource > Linked Resources] をクリックします。
  2. [Path Variables] タブで変数のリストを確認します。