使用 Microsoft Fabric 開發伺服器

DevServer 是您在開發 Fabric 工作負載時執行的本機 Web 伺服器。 它會在 localhost 上提供前端 （SPA），並提供一組 HTTP 端點，Fabric 會在開發期間呼叫這些端點，以擷取您的產品和專案資訊清單。 與 DevGateway 結合使用時，Fabric 可以在 iFrame 中載入工作負載 UI，並讀取清單資料而無需將任何內容發佈至租戶。

DevServer 的用途

• 透過 HTTP 在 localhost 上裝載工作負載前端 （例如， http://localhost:60006），讓 Fabric 可以在 iFrame 中載入它。
• 提供清單所參考的靜態資產（圖示、當地語系化字串、圖像）。
• 公開 Fabric 在開發期間用於存取您的資訊清單的本機 JSON 端點。
• 在大多數設定中啟用快速編輯-重新整理週期，並具有熱重新載入功能。

Fabric 呼叫 DevServer 的位置

當您啟用開發模式並啟動 DevGateway 和 DevServer 時：

• Fabric 會透過工作負載資訊清單所定義的前端端點流覽至您的前端 （請參閱 工作負載資訊清單）。 在開發中，這通常指向 DevServer 公開的 localhost URL。
• Fabric 會查詢 DevServer 以取得針對產品的中繼資料，以便轉譯為導覽、磁貼及其他使用者體驗元素，以支援您的工作負載。 這可讓您逐一查看 Product.json 項目資訊清單，而無需重建和上傳套件。

DevServer 提供的本機端點

確切的路由可能會因範本而異，但範例存放庫會公開一小部分可預測的端點：

• GET / — 傳回您的 Web 應用程式 （UI Fabric 載入至 iFrame）。
• GET /manifests — 傳回 JSON 承載，以彙總前端所使用的產品資訊清單和項目資訊清單。 這會反映 Fabric 在發佈時預期的結構 （請參閱 產品資訊清單 和 專案資訊清單） 。
• GET /assets/... — 提供清單所參考的圖示、影像和本地化字串。

一般開發流程

1. 從範例存放庫啟動 DevServer，以在 localhost 上裝載前端。
2. 啟動 DevGateway 以向 Fabric 註冊本機工作負載。
3. 開啟 Fabric 工作區並啟動工作負載進入點;Fabric 會在 iFrame 中載入您的應用程式，並呼叫您的 DevServer 端點來讀取資訊清單資料。
4. 編輯 UI 或資訊清單檔案並重新整理;變更會立即生效，而不需要重新包裝。

關於如何啟動每個流程，請參閱入 門教學 和 設定指南。

與已發佈的Manifest之間的關係

在生產環境中，你的工作負載的清單會打包並上傳，作為工作負載的 NuGet 套件的一部分（詳見 Manifest 概述）。 開發期間，DevServer 的本地端點會作為這些封裝檔案的輕量級替代品，讓你能快速迭代：

• 模式和規則與已發佈的清單相同。
• DevServer 僅影響本地開發;這不會改變出版的運作方式。

疑難解答秘訣

• 如果 iFrame 顯示空白頁面，請確認 DevServer 正在執行，且資訊清單中的前端端點指向正確的 localhost URL。
• 如果缺少圖示或字串，請檢查 assets 路徑，並確認 DevServer 是否在 /assets 下提供這些檔案。
• 如果 Fabric 找不到你的清單，請確認 /manifests 該路由是否存在於你的範本中且回傳有效的 JSON。

另請參閱

• DevGateway
• 工作負載資訊清單
• 產品資訊清單
• 項目資訊清單
• 檔案清單概覽