キャンバス (プレビュー)
キャンバス アプリのソース ファイルを操作するためのコマンドです。 VS Code や GitHub などのツールを使用して、Power Apps Studio 外のアプリで編集、管理、共同作業します。
[このトピックはプレリリース ドキュメントであり、変更されることがあります。]]
重要
- キャンバス コマンドはパブリック プレビュー中です。
- プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。
パラメーター
| プロパティ名 | 説明 | 例 |
|---|---|---|
| パック | 以前にアンパックされたソースファイルから .msapp ファイルを作成します。 ファイル > 開く > ブラウズ へとナビゲートすることで、この結果は Power Apps Studio で開くことができます。 アンパック後、このソースファイルは、Visual Studio Code や GitHub などの外部ツールを使用して編集および管理できます。 |
pac canvas pack --sources MyHelloWorldFiles --msapp HelloWorld.msapp |
| unpack | .msapp ソース ファイルをアンパックします。ファイル > 名前を付けて保存 > このコンピュータ の順にナビゲートして、Power Apps Studio から .msapp ファイルをダウンロードします。sources パラメータが指定されていない場合は、 .msapp ファイルと同じ名前と場所のディレクトリは _src 接尾辞で使用されます。 |
pac canvas unpack --msapp HelloWorld.msapp --sources MyHelloWorldFilespac canvas unpack --msapp HelloWorld.msappデフォルト HelloWorld_src ディレクトリへのアンパック |
フォルダー構造
アンパックとパックの機能には、次のフォルダー構造を使用します。
- \ src - 制御ファイルとコンポーネント ファイル。 これにはソースが含まれています。
- *.fx.yaml -
control.jsonファイルから抽出された式。注意
これは、数式を編集する場所です。
- CanvasManifest.json - ヘッダー、プロパティ、publishInfo に通常存在する情報を含むマニフェスト ファイル。
- *.json - 生
control.jsonファイル。 - \EditorState*.editorstate.json - Power Apps Studio を使用するためのキャッシュされた情報。
- *.fx.yaml -
- \DataSources - アプリが使用するすべてのデータ ソース。
- \Connections - アプリで保存され、Power Apps Studio にリロードするときに使用される接続インスタンス。
- \Assets - アプリに埋め込まれたメディア ファイル。
- \pkgs - テンプレート、API 定義ファイル、コンポーネント ライブラリなどの外部参照のダウンロードされたコピー。 これらは NuGet/NPM 参照に似ています。
- \other -
.msappを再作成するために必要なすべてのその他のファイル。- entropy.json - 揮発性要素 (タイム スタンプなど) がこのファイルに抽出されます。 これにより、他のファイルのノイズの違いを減らしながら、往復できるようになります。
- \references の内容などの msapp からのその他のファイルを保持します。
ファイル形式
.fx.yaml ファイルは YAML のサブセットを使用します。 Excel と同様に、すべての式は = 等号で始まる必要があります。 詳細: Power FxYAML 式の文法
Power Apps Studio での変更のマージ
変更をマージする場合、それは 2 つの異なる Power Apps Studio セッションで行われます。
- すべてのコントロール名が一意であることを確認してください。 たとえば、2 つの異なるセッションにボタンを挿入すると、
Button1コントロールにある 2 つのセッションになる可能性があります。 コントロールを作成したらすぐに名前を付けることをお勧めします。 このツールは、同じ名前の 2 つのコントロールを受け入れません。 - これらのファイルについては、通常どおりにマージします。
- \src*.fx.yaml
- 競合またはエラーがある場合は、次のファイルを削除できます。
- \src\editorstate*.json - これらのファイルには、Power Apps Studio スタジオのオプション情報が含まれています。
- \other\entropy.json
- これらのファイルで競合が発生した場合は、最新バージョンを受け入れてもかまいません。
- \checksum.json
- これらのパスの下にマージの競合がある場合、マージするのは安全ではありません。 これが頻繁に発生する場合はお知らせください。競合を回避するためにファイル形式の再構築に取り組みます。
- \Connections*
- \DataSources*
- \pkgs*
- CanvasManifest.json
オープンソース
Microsoft Power Platform CLI のキャンバス コマンドはオープンソースです。 改善について話し合い、問題を提起し、Power Apps 言語ツールリポジトリ からコードにアクセスします。
関連項目
フィードバック
フィードバックの送信と表示