使用本指南開始使用擴充性工具組建置 Microsoft Fabric 工作負載。 您可以設定環境、在 GitHub Codespaces 或本機執行 Starter-Kit，並瞭解建置和發佈所需的基本概念。
您建置的什麼
您可以在 Fabric 內執行 入門套件 、探索其資訊清單和主機 API 使用方式、進行小型 UI 變更，以及瞭解工作負載建立的專案如何像原生 Fabric 成品一樣運作。
先決條件
- 存取 Fabric 租用戶及其工作區，您可以在這些工作區中建立項目。
- GitHub 帳戶 （Codespaces 需要）
- 如果在本機開發：最近的 Node.js LTS 和套件管理器（有關確切工具，請參閱 README）
- 建立 Microsoft Entra 應用程式的存取權
- 選擇性：如果您打算在 Azure 中裝載 Web 應用程式，請使用 Azure 訂用帳戶
小提示
本地開發在 Windows、macOS 和 Linux 上獲得原生支援。 在執行安裝腳本或啟動開發伺服器之前，請檢閱並滿足 入門套件中的必要條件。
備註
你不需要向租戶部署任何東西就能試用 Starter-Kit。 在開發期間使用 DevGateway 來模擬 Fabric 主機。
這很重要
請確定您有權存取 Fabric 工作區，且您的租使用者允許開發人員功能。 您可以在測試之前啟用 Fabric 開發人員模式。
選擇你的路徑
要快速開始，請選擇以下選項之一以存取該代碼：
選項 1：從 GitHub Codespaces 開始
- 把 Starter-Kit Repository 分支到你的 GitHub 帳號。
- 在你的派生上建立一個 GitHub Codespace，以便開始使用雲端開發環境。
欲了解更多關於 GitHub Codespaces 的資訊，請參閱 GitHub Codespaces 文件。
選項 2：在本機複製和執行
- 把 Starter-Kit Repository 分支到你的 GitHub 帳號。
- 將你的 Fork 專案克隆到本地端：
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
- 安裝本地開發所需的必要條件：
所需工具：
- Node.js LTS： 下載 Node.js
- PowerShell 7 （macOS/Linux 上的 pwsh）： 安裝 PowerShell
- .NET SDK （macOS 請使用 x64 版本）： 下載 .NET
- VS Code 或類似編輯器： 下載 VS Code
- Azure CLI（僅用於 Microsoft Entra 應用程式建立）：安裝 Azure CLI
AI 輔助開發
該存儲庫與 AI 結對編程工具配合良好。 無論您是在本機還是在 GitHub Codespaces 中開發，您都可以使用 GitHub Copilot 或其他 AI 助理來加速編輯 React 元件、更新路由或產生測試腳手架等任務。
小提示
Starter-Kit 存放庫已啟用 AI，並包含 GitHub Copilot 指示，可引導您調整 Hello World 項目以符合您的需求。 其他 AI 工具（例如 Anthropic Claude）可以遵循相同指引，但必須設定為讀取資料庫的指引檔案或文件。
- 使用 AI 起草項目編輯器/視圖組件，然後適應入門套件中使用的主機 API 模式。
- 要求 AI 總結工作負載清單並提出最低權限集。
- 在 Codespaces 中，Copilot 可在瀏覽器或 VS Code 桌面中使用;保持開發伺服器運行以立即查看更改。
小提示
如果您有興趣查看其他人建置的內容，請開啟 擴充性範例 ，並將它部署至您的環境。 在那裡您可以找到可幫助您入門的豐富項目類型。
最佳做法
- 分支倉庫：分支 Starter-Kit 倉庫，並以你的分支作為專案的基礎。
- 保持同步：保持您的分支與上游同步，以獲取改進。
- 維持專案結構一致性：保留入門套件的專案結構與組織模式，以確保與未來更新相容並維持程式碼清晰度。
- 定期整合 Starter-Kit：定期將 Starter-Kit 的程式碼變更整合進專案，以獲得錯誤修正、新功能及安全更新。 建立一個流程，定期（每月或每季）審查並合併上游變更。
- 及早驗證工作清單：及早驗證你的工作量清單，並遵守最低權限權限。
- 使用開發容器：使用開發容器或 Codespaces，營造一致且可拋棄的環境。
- 使用提供的腳本：使用提供的腳本（Setup、StartDevServer、StartDevGateway）來自動化設定與日常工作流程。
後續步驟
一旦取得程式碼（無論是在 Codespaces 或本地），請繼續閱讀 詳細設定指南 ，了解以下步驟：
- 執行設定腳本
- 啟動開發環境
- 啟用 Fabric 開發者功能
- 測試你的第一個 HelloWorld 產品
- 開始寫程式
- AI 輔助開發技巧
- 疑難排解常見問題
其他資源
- 瞭解 架構 ，以及主機、應用程式和 Fabric 服務如何互動
- 閱讀 資訊清單概觀 ，以瞭解結構描述和最佳實務
- 了解 工作負載清單 的結構與配置
- 使用 DevGateway 進行本地測試
- 當你準備好廣泛分享工作量時，再發表