ビルド操作
この記事では、プロジェクトのビルド プロセスとモデル パッケージの完全なビルドについて説明します。
モデルの要素は、アプリケーションで使用できるように構築する必要があります。 要素をプロジェクト内にビルドすることができます。 また、モデル内のすべての要素をビルドすることもできます。 ビルド操作中に次のアクションが実行されます。
- メタデータの検証
- X++ コードの検証
- 推奨チェック
- レポート RDL の生成
- コンパイル、IL 生成、および .NET アセンブリの作成
- ラベル アセンブリの生成および他のリソース ファイルの配置
- データベース同期
プロジェクトのビルド
プロジェクトを作成するときは、新規の要素か、変更された要素のみが作成されます。 プロジェクトをビルドするには、次の手順を実行します。
- ソリューション エクスプローラーで、プロジェクトを選択します。
- ビルドメニューで、ビルド<プロジェクト名>をクリックして、ビルド プロセスを開始します。 または、ソリューション エクスプローラーでプロジェクトを右クリックし、その後ビルドをクリックします。
ビルド プロセス中に、ビルドされている要素の一部がプロジェクトの一部ではないことに気付くかもしれません。 この動作は、アセンブリの作成方法のために必要です。 要素を作成するときは、実際には、要素が組み込まれる .NET モジュールを作成します。 1 つの .NET モジュールには、複数のモデル要素が含まれ、1 つのアセンブリには、複数の .NET モジュールが含まれます。 アセンブリ内のすべての .NET モジュールが構築されており、最新の状態である場合にのみ、アセンブリを作成できます。 アセンブリの .NET モジュール内の要素がビルドされていないまたは最新の状態になっていない場合は、現在のプロジェクトに含まれていない場合でもビルドされます。
メモ
プロジェクトから要素を削除する場合は、削除を有効にする前にプロジェクトを再構築するか、モデルで完全なビルドを実行する必要があります。
プロジェクトのリビルド
変更したかどうかに関係なく、プロジェクトにすべての要素を作成する場合は、再構築処理を行う必要があります。 プロジェクトをリビルドするには、次の手順を実行します。
- ソリューション エクスプローラーで、プロジェクトを選択します。
- ビルドニューで、再構築<プロジェクト名>をクリックして、再構築プロセスを開始します。 または、ソリューション エクスプローラーでプロジェクトを右クリックし、その後再構築をクリックします。
ビルドごとにデータベースを同期
プロジェクトのプロパティを使用して、プロジェクトをビルドするたびにデータベースの同期操作を実行するように指定できます。 これは、アプリケーションのテーブル構造を変更する場合に便利です。 ビルドを実行するたびに、データベースはプロジェクトで定義されているテーブルと同期されていることがわかります。 プロジェクト プロパティの設定方法については、Visual Studio の財務と運用のプロジェクトタイプを参照してください。 アプリケーションに多数のテーブルがあり、アプリケーションをまだテストしていない場合、ビルドでデータベースの同期プロパティを false に設定できます。 この変更により、プロジェクトのビルドに必要な時間が短縮されます。 次にテストを開始するときは、必ずこのプロパティを true に設定してください。 プロジェクトに含まれるテーブルを手動で同期する必要がある場合は、ソリューション エクスプローラーで、プロジェクトを右クリックし、同期 < プロジェクト名 > データベースをクリックできます。 Dynamics 365 メニューでプロセス (長いプロセスとなる可能性がある) データベース全体を同期させるには、データベースの同期 をクリックします。します。
メモ
アセンブリを完全にコンパイルする前にデータベースを同期しようとすると、Visual Studio データベース同期ツールには同期が正常に完了したことを示すメッセージが表示されますが、実際には同期は成功していません。
テーブルおよびビューは、完全にコンパイルするまでに、データベースに対して同期することはできません。 アプリケーション プラットフォーム、アプリケーション基準、およびアプリケーション スイートの完全なビルドを完了すると、Visual Studio での Dynamics 365 メニューからデータベース同期を完了することができます。
モデルのパッケージをビルドする
特定のモデル内のすべての要素を構築する場合があります。 これを行うには、モデルが属するパッケージでフル ビルドを実行する必要があります。 以下の手順を実行します。
Dynamics 365 メニューで、モデルをビルドをクリックします。
パッケージ リストで、ビルドするパッケージを選択します。
- パッケージ名がアルファベット順に一覧表示されます。
- パッケージに属するモデルはかっこ内に表示されます。
依存パッケージを最初に作成する場合は、参照パッケージのビルドを選択します。 構築する必要のある依存パッケージが一覧表示されます。
オプションタブで、ビルド プロセスのオプションを確認します。 次のオプションを使用できます。
オプション 説明 コンパイル済みのフォームをビルドする 静的 HTML は、ビルド プロセス中にフォームごとに生成されます。 これにより、実行時にフォームをより速くレンダリングできます。 ビルド レポート レポートが作成されます。 集計の測定をビルドする 集計の測定はビルドです。 ベスト プラクティス チェックを実行 推奨チェックはビルド プロセス中に実行されます。 データベースの同期 SQL データベースのスキーマは、メタデータと一致するよう、(メタデータとソース コードのコンパイル後に) ビルド プロセス中に更新されます。 相互参照データのビルド 相互参照機能のデータは、ビルド処理中に更新されます。 相互参照データを使用すると、開発時にコードやメタデータへの参照を見つけることができます。 ビルドをクリックし、ビルド プロセスを開始します。
ビルド プロセスの詳細をフォローするには、詳細タブを展開します。
ビルドの結果
ビルド操作が完了した後、Microsoft Visual Studio で結果が表示されます。 Visual Studio の 出力 ウィンドウには、ビルドのステータスが表示されます。 出力元の表示 フィールドを使用すると、標準的なビルド情報とビルド詳細を切り替えることができます。
Visual Studio の エラー一覧 ウィンドウには、ビルド プロセス中に発生したビルド エラーおよび警告が表示されます。 ビルド エラーが表示された場合は、それらを修正してから再ビルドし、アプリケーション用の有効なアセンブリを作成する必要があります。 エラー一覧ウィンドウに表示される警告の多くは、アプリケーション開発のベスト プラクティスに適合するように、アプリケーションに加える必要がある変更を通知する推奨チェックです。 原則的には、アプリケーションのすべてのベスト プラクティス警告に対処する必要があります。
ほとんどのエラーや警告をダブルクリックして、問題の原因を表示することができます。 要素デザイナーまたはコード エディターが開き、エラーまたは警告の原因となっているプロパティ設定やコードを確認できます。 Visual Studio の タスク一覧 ウィンドウには、コード内ので "TODO" とフラグが付けられたタスクが表示されます。 たとえば、次のコメントは、一部のオブジェクト参照がまだ検証を要求することを示します。
// TODO: validate object references
コードが作成されるとき、"TODO" コメントが タスク一覧 ウィンドウに表示されます。 作業一覧ウィンドウを表示するには、表示 メニューで 作業一覧 をクリックします。
解決を容易にするために、エラーまたはタスクの影響を受ける要素を現在のプロジェクトまたは新しいプロジェクトに追加できます。 エラー一覧ウィンドウまたはタスク一覧ウィンドウで、修正するエラーまたはタスクの行を選択して右クリックし、プロジェクトに追加または新しいプロジェクトに追加をクリックします。 これにより、影響を受ける要素をアプリケーションで見つける手間を省くことができます。
