共用方式為


畫布應用程式原始檔控制

製作者和開發人員會在 Power Platform 中使用 Git 整合,以便使用版本控制有效管理畫布應用程式的原始程式碼。 此功能可協助您審視製作者在 Power Apps Studio 中進行的變更,而不受雜訊頻仍的差異影響。 此外,還讓您直接在存放庫中進行極少的編輯,就能確保工作流程簡化且有效率。

如何使用 Git 整合認可畫布應用程式

您可以在發佈畫布應用程式時認可這些應用程式。 在發佈應用程式之前,沒有變更可供認可。 此行為可確保原始程式碼反映應用程式的最新發佈版本,使其準備好可與 Git 整合搭配使用。

認可畫布應用程式的步驟

  1. 開啟 Power Apps Studio,並對畫布應用程式進行變更。
  2. 發佈應用程式,使變更可用於 Git 整合。
  3. 瀏覽至 Git 存放庫並認可變更。

存取原始程式碼檔案

畫布應用程式的原始程式碼儲存在 .pa.yaml 檔案中。 這些檔案是人類看得懂且設計用於原始檔控制的檔案。 使用 Git 整合時,畫布應用程式的原始程式碼無需任何轉換,即可自動在存放庫中提供。 原始程式碼儲存在存放庫的 canvas 資料夾中。

畫布應用程式的檔案結構

擷取的原始程式碼檔案位於 \Src 資料夾中,包括:

  • App.pa.yaml:表示應用程式。
  • [screen Name].pa.yaml:每個畫面個有一個檔案,表示畫面。
  • \Component:包含每個元件各一個檔案的資料夾,表示為 [component Name].pa.yaml

僅將 \Src 資料夾中的 .pa.yaml 檔案用於原始檔控制。 不要使用其他檔案 (例如 JSON 檔案) 做為原始程式碼,因為這些檔案在儲存和載入週期之間不穩定。

編輯 .pa.yaml 檔案

您可以直接在存放庫中進行少量編輯。 將變更提取至環境時,任何變更都會隨應用程式一起還原。 修改必須將分支中的任何程式碼視為已發佈的應用程式。

編輯最佳做法

  • 避免直接在 .pa.yaml 檔案中進行大幅變更。
  • 將變更合併至主要分支之前,務必先在開發環境中測試這些變更。

已知限制

如果您的應用程式包含.pa.yaml,則無法直接在存放庫中編輯檔案。

編輯包含這些元件的檔案會造成應用程式無法執行。 如果錯誤地變更這些檔案,您可以在 Maker Portal 中載入畫布應用程式的先前版本。

疑難排解​​

本節包含常見問題和提示,可協助您更順利地使用 Git 與畫布應用程式的整合。

一般問題

  • 合併衝突:謹慎解決衝突以避免損毀 .pa.yaml 檔案。
  • 應用程式無法載入:確保沒有對 .pa.yaml 檔案進行不支援的編輯。

秘訣

  • 將 Git 用戶端與視覺效果差異工具搭配使用,以在認可前檢閱變更。
  • 定期備份存放庫以避免資料遺失。

後續步驟