コードコンポーネントソリューションパッケージを作成する

15 分

Power Apps や Power Pages でコードコンポーネントを使用するには、Microsoft Dataverse 環境にコードコンポーネントを展開する必要があります。コンポーネントを展開するための最初のタスクは、コードコンポーネントをソリューションファイルにパッケージ化し、それを環境にインポートできるようにすることです。これは 2 つの方法で実行できます。 CLI Push コマンドを使用して一時的なソリューションを作成すると、コンポーネントを環境にプッシュしてテストを容易に実行できます。この方法は、コンポーネントの開発時にとても役立ちます。もう 1 つの方法は、コンポーネントのソリューションを作成し、それを別々に Dataverse 環境にインポートする方法です。この方法は、ビルドパイプラインや、開発環境以外への手動展開で役立ちます。両方の方法を詳しく見てみましょう。

次の手順では、前回のトピックで作成したコードコンポーネント、または利用可能なサンプルコンポーネントの 1 つを使用して、両方の方法を練習します。

前提条件

ビルド済みの既存のコードコンポーネントプロジェクトが必要です。以下の手順は、サンプルコンポーネントなど、他のすべてのコードコンポーネントプロジェクトに対しても実行できます。

開発中にコンポーネントを Dataverse 環境にプッシュする

Power Platform CLI を使用してコードコンポーネントをプッシュするには、次の手順を実行します。

Visual Studio Code を開始し、エクスプローラー を選択します。
フォルダーを開く を選択します。
前のラボで作成した editable-pcf プロジェクトフォルダーを選択し、フォルダーを選択 を選択します。
Power Platform タブを選択し、認証プロファイルの追加 を選択します
アカウントにサインインする のポップアップを探して、使用するアカウントを選択します。適切なユーザー名を入力し、[次へ] を選択して、パスワードを入力します。テナントで MFA が設定されている場合は、認証要素の提供が必要です。
追加したプロファイルは、関連付けられている 環境およびソリューション と一緒に、認証プロファイル に表示されます。 [環境およびソリューション] で適切な環境を選択してください。選択できる星印が表示されます。選択した環境について、Power Platform 管理センターの [環境の機能] セクションで Component Framework も有効になっていることを確認してください。
ターミナル、新しいターミナルの順に選択します。
次のコマンドを実行してプロジェクトをビルドし、正常にビルドされたことを確認します。
```
npm run build
```
次のコマンドを実行してカスタムコントロールを環境にプッシュします。
```
pac pcf push --publisher-prefix msl
```
この画像の中で、[Connected as] セクションと [Connected to] セクションを赤いボックスで示しています。これらが、前の手順の認証プロファイルと選択した環境に一致していることを確認してください。
ソリューションが環境にインポートされて公開されます。

黄色の警告メッセージが表示されても、無視して構いません。
Power Apps Maker Portal に移動して、正しい環境にいることを確認します。
ソリューション を選択します。
PowerAppsTools_msl ソリューションが表示されるはずです。ソリューションを選択して開きます。
作成したカスタムコントロールが表示されるはずです。

Power Platform CLI を使用してソリューションファイルを作成する

Power Platform CLI を使用してソリューションファイルを作成するには、次の手順を実行します。

Visual Studio Code に戻り、EDITABLE-PCF プロジェクトが開いていることを確認します。
ターミナルに移動し、コマンドプロンプトに移動します。
次のコマンドを実行して、新しいフォルダーを作成します。
```
md Solution
```
現在のディレクトリを、作成した Solution フォルダーに変更します。次のコマンドを実行します。
```
cd Solution
```
次のコマンドを使用して、Dataverse ソリューションプロジェクトを初期化します。
```
pac solution init --publisher-name mslearn --publisher-prefix msl
```
ビルド時にそのコンポーネントが追加されることをソリューションプロジェクトに通知します。このタスクを実行するには、次のコマンドを使用します。
```
pac solution add-reference --path ..
```
ソリューションの zip ファイルを生成するには、Microsoft Build Engine または msbuild (略称) を使用します。 /restore フラグを使用する必要があるのは、ソリューションプロジェクトが初めてビルドされるときだけです。それ以降のすべてのビルドでは、msbuild を実行するだけで済みます。 MSBuild.exe へのパスは、コンピューターにインストールしている Visual Studio のバージョンによって異なる場合があります。
```
"C:\Program Files (x86)\Microsoft Visual Studio\2022\BuildTools\MSBuild\Current\Bin\MSBuild.exe\" /t:build /restore
```
ビルドが成功します。
作成したソリューション フォルダーを見つけて展開します。
bin\debug フォルダーを展開します。
次のように solution.zip ファイルが表示されます。

メモ

MSBuild を実行するには、Visual Studio または Visual Studio Build Tools のいずれかがインストールされている必要があります。ビルドツールは、Visual Studio ダウンロードからインストールできます。 MSBuild にアクセスするには、Windows 環境変数のパスディレクトリに MSBuild を追加することが必要な場合があります。たとえば、Visual Studio 2022 では、MSBuild が C:\Program Files (x86)\Microsoft Visual Studio\2022\Enterprise\MSBuild\Current\Bin に格納されます。 Visual Studio 開発者コマンドプロンプトを使用して MSBuild にアクセスするか、完全修飾パス ("C:\Program Files (x86)\Microsoft Visual Studio\2022\Enterprise\MSBuild\Current\Bin\MSBuild.exe"/t:build /restore) を使用して MSBuild を実行することもできます。

既定のパッケージタイプは、管理ソリューションです。管理されていないソリューション (または両方) としてエクスポートする場合は、Solutions.cdsproj の次のセクションにあるコメントを消去 (またはコメント解除) し、それに応じて SolutionPackageType ノードを編集します。

   <!-- Solution Packager overrides un-comment to use: SolutionPackagerType Managed, Unmanaged, Both)-->
        <PropertyGroup>
        <SolutionPackageType>Unmanaged</SolutionPackageType>
        </PropertyGroup>

msbuild の構成を Release に設定すると、実稼働ビルドを発行できます。たとえば msbuild /p:configuration=Release のようにします。

リリースの構成に応じて、これを含んだ bin\Debug または bin\Release 内の zip ファイルを手動でインポートできます。 Power Platform CLI を使用して、プログラムによってコードコンポーネントを展開することもできます。詳細については、「コードコンポーネントをパッケージ化する」ドキュメントで、環境への接続とコードコンポーネントの展開に関するセクションを参照してください。

続行

コード コンポーネント ソリューション パッケージを作成する

前提条件

開発中にコンポーネントを Dataverse 環境にプッシュする

Power Platform CLI を使用してソリューション ファイルを作成する

フィードバック

Power Platform CLI を使用してソリューションファイルを作成する