製作者和開發人員會在 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:每個畫面個有一個檔案,表示畫面。 -
\Component:包含每個元件各一個檔案的資料夾,表示為[component Name].pa.yaml。
僅將 \Src 資料夾中的 .pa.yaml 檔案用於原始檔控制。 不要使用其他檔案 (例如 JSON 檔案) 做為原始程式碼,因為這些檔案在儲存和載入週期之間不穩定。
編輯 .pa.yaml 檔案
您可以直接在存放庫中進行少量編輯。 將變更提取至環境時,任何變更都會隨應用程式一起還原。 修改必須將分支中的任何程式碼視為已發佈的應用程式。
編輯最佳做法
- 避免直接在
.pa.yaml檔案中進行大幅變更。 - 將變更合併至主要分支之前,務必先在開發環境中測試這些變更。
已知限制
如果您的應用程式包含.pa.yaml,則無法直接在存放庫中編輯檔案。
編輯包含這些元件的檔案會造成應用程式無法執行。 如果錯誤地變更這些檔案,您可以在 Maker Portal 中載入畫布應用程式的先前版本。
疑難排解
本節包含常見問題和提示,可協助您更順利地使用 Git 與畫布應用程式的整合。
一般問題
-
合併衝突:謹慎解決衝突以避免損毀
.pa.yaml檔案。 -
應用程式無法載入:確保沒有對
.pa.yaml檔案進行不支援的編輯。
秘訣
- 將 Git 用戶端與視覺效果差異工具搭配使用,以在認可前檢閱變更。
- 定期備份存放庫以避免資料遺失。