コード アプリ用の Power Apps クライアント ライブラリ バージョン 1.0.4 以降、クライアント ライブラリにはコード アプリ用の npm ベースの CLI が含まれています。 この新しい CLI は、コード アプリを構築するための前提条件を減らし、将来のリリースで非推奨となる Power Platform CLI の pac code コマンドに代わるものです。
この記事では、新しい npm ベースの CLI コマンドを使用して、コード アプリ用の Power Apps クライアント ライブラリをインストールし、Vite から空のアプリを設定し、Power Apps コード アプリに変換する方法について説明します。
[前提条件]
コマンド
コード アプリの npm CLI には、次の 3 つのコマンドがあります。
| コマンド | Description |
|---|---|
init |
コードアプリを初期化します。 |
run |
ローカル開発サーバーを起動します。 |
push |
新しいバージョンのアプリケーションを環境にデプロイします。 |
この記事の手順に従って、これらのコマンドを使用する方法について説明します。
手順 1: projectを初期化する
ターミナルを開き、次のコマンドを実行します。
npx degit github:microsoft/PowerAppsCodeApps/templates/vite my-app
cd my-app
degit コマンドの詳細を確認します。
手順 2: 依存関係をインストールし、コード アプリを初期化する
コード アプリ用のプロジェクトの依存関係とPower Apps クライアント ライブラリをインストールします。
npm install
コードアプリを初期化します。 オプションを直接指定することも、対話型プロンプトを使用することもできます。
オプション A: 対話型モード (CLI によって必要な情報の入力が求められます):
npx power-apps init
オプション B: オプションを直接渡す:
npx power-apps init --displayName "App From Scratch" --environmentId <Your environment ID>
init コマンドを実行すると、CLI によって自動的に認証されます。 メッセージが表示されたら、Power Platform アカウントを使用してサインインします。
手順 3: ローカルでテストする
開発のためにコード アプリをローカルで実行します。
npm run dev
これにより、ローカル開発サーバーが起動します。 [Local Play] というラベルの付いた URL を開きます。
Important
Power Platform テナントと同じブラウザー プロファイルで URL を開きます。
注
ローカル ネットワーク のアクセス制限
2025 年 12 月以降、Chrome および Microsoft Edge ブラウザーでは、パブリック配信元からローカル エンドポイントへの要求が既定でブロックされます。
- コード アプリは開発中に localhost に接続するため、ブラウザーのアクセス許可を付与するか、エンタープライズ ポリシーを構成することが必要になる場合があります。
- 埋め込みシナリオの場合は、iframe タグに
allow="local-network-access"を含めます。 - 詳細については、「Microsoft Edge のローカル ネットワークへの Web サイトのアクセスを制御する」および「 Chrome を使用したローカル ネットワーク アクセスの新しいアクセス許可プロンプトを制御する」を参照してください。
次のようなアプリが開いていることがわかります。
ビルドしてPower Appsにデプロイする
アプリをビルドし、Power Apps環境にプッシュします。
npm run build
npx power-apps push
コマンドの詳細:
-
npm run build-package.jsonからスクリプトを実行します。tsc -b && vite buildを実行します。 -
npx power-apps push- 新しいバージョンのコード アプリを環境に発行します。
コマンドが正常に完了すると、アプリを実行するためのPower Apps URL が返されます。
必要に応じて、Power Apps に移動して、アプリの詳細を表示、再生、共有、または確認します。