Fabric 應用程式透過提供現成的驗證、資料持久化及靜態主機架構，幫助您更快建置並交付後端服務。 這個快速入門指南教你如何在 Fabric 上建立你的第一個應用程式。
先決條件
- 可存取 Fabric 的 Microsoft 帳戶。
- 一個 Fabric 工作區，你擁有貢獻者或管理員權限。
- Fabric 應用程式由租戶管理員在設定中啟用。 請參見租戶管理員設定中的 啟用Fabric應用程式。
- Node.js 20 或更新版本。
在租戶管理員設定中啟用 Fabric 應用程式
Fabric 租戶管理員必須先啟用 Fabric 應用程式的工作負載，使用者才能建立 Rayfin 項目。 如果您不是租戶管理員，請聯絡您組織的 Fabric 管理員以完成此步驟。
- 登入 Fabric 管理入口網站。
- 進入 租戶設定。
- 在 Fabric 應用程式（預覽），切換設定為 Enabled。
- 你可以選擇是對整個組織啟用，還是針對特定安全群組啟用。
- 選擇 「申請」。
變更可能需要幾分鐘才能生效。 啟用設定後，允許範圍內的使用者可以在工作區建立 Fabric 應用程式。
從無到成為一個運行中的應用程式
建立並執行一個包含四個指令的 Fabric 應用程式。 Rayfin 會把你的後端部署到 Microsoft Fabric，然後你在本地針對它執行前端。 你不會在本地執行後端。
npm create @microsoft/rayfin@latest my-app
cd my-app
npx rayfin up
npm run dev
執行 npx rayfin up status 以確認後端部署。
讓代理人來建立應用程式
請將以下提示複製到 GitHub Copilot 或其他有存取終端機權限的程式代理程式中：
Set up a new Rayfin app for me, end to end.
Rayfin is a backend platform for TypeScript developers on Microsoft Fabric. Before writing
any code, read https://rayfin.ai/docs/reference/agent-rules.md. Every page on that site is
available as raw Markdown by appending .md to its URL.
Then do the work yourself rather than printing steps for me:
1. Scaffold a project with `npm create @microsoft/rayfin@latest my-app` and install dependencies.
2. Sign in with `npx rayfin login`.
3. Deploy with `npx rayfin up` and confirm it with `npx rayfin up status`.
4. Start the frontend with `npm run dev` and tell me the URL to open.
在部署應用程式前，先檢查產生的檔案和指令輸出。
從入口網站建立應用程式
在瀏覽器中開啟 Fabric，並用你的 Microsoft 帳戶 登入。
選取工作區
登入後，從左側導覽面板選擇工作區。 如果你沒有現有的工作區，請建立一個：
- 在左側導覽中選擇 工作區 。
- 選擇 新工作區。
- 輸入工作區的名稱，並選取 Fabric 容量。
建立一個新的 Fabric 應用程式
- 在工作區檢視中，選擇 新項目。
- 在物品類型列表中搜尋 「App 」或捲動尋找。
- 選擇 應用程式 項目以開啟建立對話框。
- 輸入你的Fabric應用程式名稱（例如
my-rayfin-app）。 - 選取 ，創建。
開啟、編輯並部署你的應用程式
你可以用 Rayfin CLI 在本地開發。
開啟你選擇的終端機。
請使用入口網站中顯示的 CLI 指令腳本，並在終端機執行，本地下載應用程式。
Example
npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>去專案目錄看看。
cd <your project directory>您可以直接編輯程式碼，或在 GitHub Copilot 的協助下自訂您的應用程式。
用 Fabric 後端的指令測試本地變更。
npm run dev發佈你的變更時，請用以下方式：
npx rayfin up要部署到另一個工作區，你可以提供參數
--workspace。npx rayfin up --workspace <workspacename>要在這兩個工作區間切換，執行
npx rayfin switch --workspace <workspace>。
下一步
- 探索 資料模型與裝飾工具 ，定義你的後端架構。
- 學習如何用 GraphQL 指南連接前端。
- 使用 Authentication 設定驗證。