アプリケーションのビルドはアプリケーションビルドウィンドウで行います。このウィンドウを開くには4Dのデザインメニューからアプリケーションビルド...を選択します。
ビルドを行う前にアプリケーションがコンパイルされていなければなりません。まだコンパイルされていないアプリケーションでこのメニューコマンドを選択する、あるいはコンパイルした後にコードが変更されていると、データベースを (再) コンパイルしなければならない旨の警告ダイアログが表示されます。
アプリケーションビルドウィンドウには複数のページがあり、タブを使用してページを移動できます:
![](../../picture/515253/pict515253.ja.png)
同時に異なるビルドパラメーター (シングルユーザーとクライアント/サーバー) の設定を行うことができます。これを行うためには各ページで対応するチェックボックスを選択しなければなりません。
ビルド ボタンをクリックすると選択したターゲットアプリケーションがビルドされます。このボタンがクリックされると4Dは実行中のフェーズを表示する進捗バーを表示します。有効な設定が行われれば、設定内容はアプリケーションプロジェクトに保存されます (参照)。
設定保存 ボタンをクリックすれば、アプリケーションビルドを実行しなくてもビルドパラメーターを保存できます。
エラーが発生すると生成されたファイルは削除され、中断の理由を提供する警告ダイアログが表示されます。
アプリケーションビルドウィンドウの上部では、生成するアプリケーションの名前と保存先を指定します。
アプリケーション名 エリアにはデフォルトでストラクチャーファイル名が入力されています。この欄の名前が生成されるファイル (コンパイル済みストラクチャー、コンポーネント、シングルユーザーアプリケーション、クライアント/サーバーアプリケーション) で使用されます。ビルドされるアプリケーションに基づき4Dは自動で必要な拡張子 (.4dc、.exe、server等) を付加します。
デフォルト名から変更を行わない限り、ストラクチャーファイル名を変更すればそれがアプリケーション名に反映されます。アプリケーション名を変更すると、そのアプリケーションのビルド時には指定した名前がデフォルトで使用されるようになります。入力する名前に拡張子を付けてはいけません。さらにOSがパス名として禁止する文字を含めてもいけません (Windowsでは".?!"、Mac OSでは":")。
保存先フォルダー エリアでは生成されるファイルの保存先を指定します。4Dはデフォルトでカレントデータベースフォルダー (Mac OSの場合パッケージ) と同階層の“StructureName_Build”を指定します。
保存先フォルダーを変更するにはこのエリアの右にある選択ボタン[...]をクリックします。フォルダー選択ダイアログボックスが表示されるので、新しい保存先を選択します。このダイアログボックスを受け入れると、フォルダーの完全パス名が入力されます。このアプリケーションのビルド時には以降このパスがデフォルトで使用されます。
ビルド実行時に4Dは自動で中間フォルダー (要求されたビルドリクエストに応じて"Compiled Database"、"Components"、"Final Application"、"Client Application"、"Server Application") を作成します。このため同時に複数タイプのアプリケーションをビルドすることができます。
このウィンドウで設定された各パラメーターは"BuildApp.XML"という名称のアプリケーションプロジェクトファイルに格納されます。このファイルはデータベースのPreferences内、BuildAppサブフォルダーに配置されます。
ダイアログボックスが初めて表示されるときにはデフォルトパラメーターが使用されます。ビルドや設定保存ボタンをクリックすると、プロジェクトファイルの内容が更新されます。
あるデータベースについて内容の異なる複数のXMLプロジェクトファイルを定義し、BUILD APPLICATIONコマンドでそれらを使い分けることができます。
XMLキーを使用すると、アプリケーションビルドダイアログに表示される以上の設定を行うことができます。例えば:
- サーバーのIPアドレスやポート番号
- クライアントアプリケーションとサーバーアプリケーションのバージョン番号互換性 (例えばクライアントバージョン1.1から1.3がサーバーバージョン1.3に接続可能など)
- データファイルのパス名 (これにより、ユーザーマシン上でデータファイルの場所を指定する必要がなくなります)
- Windows 環境下において権限を引き上げることによって、組み込みアプリの保護されたシステムロケーションへの自動インストールを可能にします。
詳細は専用のドキュメント 4D XML Keys-BuildApplication を参照してください。
アプリケーションを最初にビルドする際、4DはXML形式のログファイルを生成します。ログファイルは各アプリケーションプロジェクトごとに生成されます。
ログファイルは"ProjectName.log.xml" (ProjectName はアプリケーションプロジェクト名、デフォルトでBuildApp) という名称で、アプリケーションPreferencesフォルダー内BuildAppサブフォルダーに配置されます。
ログファイルには各ビルド毎に以下の情報が書き込まれます:
- ターゲットビルドの開始と終了
- 生成されたファイルの名称とフルパス
- ビルドの日付と時刻
- 発生したエラー