Apache Ant のセットアップ
Apache Ant を使用する前に、次のセットアップを実行する必要があります。
- Windows の場合、Apache Ant バージョン 1.7.1 以降をダウンロードしてインストールする必要があります。Apache Ant 1.10.2 をダウンロードするには、次の手順を実行します。
- Click
here, in the left pane click
Binary Distributions.
- Click
apache-ant-1.10.2-bin.zip to download.
- Extract the content of the zip file to a new folder.
Apache Ant をインストールしたら、環境を構成する必要があります。
- ANT_HOME 環境変数を、配布された Apache Ant のルート ディレクトリに設定します。
Windows:
SET ANT_HOME=<ant_path>
UNIX:
EXPORT ANT_HOME=<ant_path>
- 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 Components を使用してリモート マシン上で開発されたプロジェクトの 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
制約事項: プロジェクト内のソースの複数プロセッサによるコンパイルは、ネイティブ COBOL に対してのみサポートされます。ネイティブのオブジェクト指向 COBOL アプリケーションでの使用はお勧めしません。
増分ビルドを実行する場合は次のとおりです。
- Windows コマンド プロンプトの場合:
-
ant -lib %ProgramFiles(x86)%\Micro Focus\Enterprise Developer\bin\mfant.jar -f .cobolBuild -DforceCompile=false
- UNIX コマンド プロンプトの場合:
-
ant -lib $COBDIR/lib/mfant.jar -f .cobolBuild -DforceCompile=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 パラメーターと
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 の場合:
-
- Ant ビルドのたびに事前に Eclipse ビルドが開始されないようにする場合は、[Window > Preferences > Run/Debug > Launching] をクリックし、[Build (if required) before launching] オプションをオフにします。
- COBOL エクスプローラーで、.cobolBuild ファイルを右クリックし、[Run As > Ant Build] をクリックします。
独自のシェル スクリプトをビルド前およびビルド後のイベントとして設定し、コンパイルの前または後に .cobolBuild Ant スクリプトの一環として実行できます。
ビルド前およびビルド後のイベントを設定するには、次の手順を実行します。
- COBOL エクスプローラー ビューでプロジェクトを右クリックし、[Properties] をクリックします。
- [Micro Focus > Build Configurations] を展開して、目的の構成の [Events] をクリックします。
- [Pre-build event command line] フィールドまたは [Post-build event command line] フィールドにスクリプトのコードを入力します。
- [Apply and Close] をクリックします。
注:
[Events] フィールドで変数を参照する場合は、リンク リソースのパス変数の前に ${pathVar. を付け、変数を } で閉じる必要があります。たとえば、PROJECT_LOC という変数は ${pathVar.PROJECT_LOC} としてコーディングする必要があります。
リンク リソースのパス変数は、プロジェクトのプロパティで次のように定義されます。
- COBOL エクスプローラーでプロジェクトを右クリックし、[Properties > Resource > Linked Resources] をクリックします。
- [Path Variables] タブで変数のリストを確認します。