作成者や開発者は、Power Platform で Git 統合を使用して、バージョン管理でキャンバス アプリのソースコードを効率的に管理しています。 この機能により、差分のノイズに悩まされることなく、作成者の変更を Power Apps Studio で確認することができます。 さらに、リポジトリで直接行う編集が最小限に抑えられるため、合理化された効率的なワークフローが保証されます。
Git 統合を使用して キャンバス アプリをコミットする方法
キャンバス アプリは、公開時にコミットできます。 アプリを公開するまで、変更をコミットすることはできません。 この動作により、ソース コードにアプリの最新の公開バージョンが反映され、Git 統合で使用できるようになります。
キャンバス アプリをコミットする手順
- Power Apps Studio を開いてキャンバス アプリを変更します。
- アプリを公開して、変更を Git 統合で使用できるようにします。
- Git リポジトリに移動し、変更をコミットします。
ソースコード ファイルへのアクセス
キャンバス アプリのソースコードは .pa.yaml ファイルに格納されています。 これらのファイルは人間が判読でき、ソース管理で使用するように設計されています。 Git 統合を使用すると、キャンバス アプリのソース コードは、変換を必要とせずにリポジトリで自動的に利用可能になります。 ソースコードはリポジトリの canvas フォルダに格納されています。
キャンバス アプリのファイル構造
抽出されたソース コード ファイルは \Src フォルダにあり、次のものが含まれます:
-
App.pa.yaml: アプリを表わします。 -
[screen Name].pa.yaml: 画面ごとに 1 つのファイルで画面を表します。 -
\Component: 各コンポーネントのファイルが 1 つずつ入ったフォルダ。[component Name].pa.yamlとして表されます。
ソース管理では、.pa.yaml フォルダ内の \Src ファイルのみを使用します。 JSONフ ァイルなどの他のファイルは、保存とロードのサイクルの間で安定していないため、ソースコードとして使用しないでください。
.pa.yaml ファイルの編集
軽微な編集は、リポジトリで直接行うことができます。 環境に変更をプルすると、すべての変更がアプリと共に復元されます。 ブランチ内のすべてのコードを公開済みアプリと見なす必要があります。
編集のベスト プラクティス
-
.pa.yamlファイル内で直接大幅な変更を加えることは避けてください。 - 変更をメイン ブランチにマージする前に、必ず開発環境でテストしてください。
既知の制限
アプリに.pa.yamlが含まれている場合、リポジトリ内の ファイルを直接編集することはできません。
これらのコンポーネントを含むファイルを編集すると、アプリが実行されなくなります。 これらのファイルを誤って変更した場合、Maker Portal で以前のバージョンの キャンバス アプリ を読み込むことができます。
トラブルシューティング
このセクションでは、Git と キャンバス アプリの統合をより成功に導くための一般的な問題とヒントを紹介します。
一般的な問題
-
競合のマージ: 競合の解決は、
.pa.yamlファイルの破損を避けるため、慎重に解決してください。 -
アプリの読み込みに失敗する:
.pa.yamlファイルにサポートされていない編集が行われていないことを確認します。
ヒント
- Git クライアントとビジュアル差分ツールを使用して、コミットする前に変更を確認します。
- データの損失を防ぐために、リポジトリを定期的にバックアップしてください。