打造你的第一個 Fabric 應用程式

Fabric 應用程式透過提供現成的驗證、資料持久化及靜態主機架構,幫助您更快建置並交付後端服務。 這個快速入門指南教你如何在 Fabric 上建立你的第一個應用程式。

先決條件

  • 可存取 Fabric 或具有 Power BI Pro 授權的 Microsoft 帳戶。
  • 一個您擁有貢獻者或管理員權限的工作空間。
  • Node.js 最新版本

從無到成為一個運行中的應用程式

建立並執行一個包含四個指令的 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.

在部署應用程式前,先檢查產生的檔案和指令輸出。

從入口網站建立應用程式

開啟適用於您授權選項的入口網站並登入:

選取工作區

選擇您擁有貢獻者或管理員權限的工作區。 若要使用 Power BI Pro 體驗,請使用 Pro 工作區;若要使用由容量支援的應用程式,請使用已指派給 Fabric 容量的工作區,或使用啟用中的 Fabric 試用版。

如果您沒有現有的工作區,請建立一個:

  1. 在左側導覽中選擇 工作區 。
  2. 選擇 新工作區。
  3. 輸入工作區的名稱。
  4. 為您的部署選擇工作空間授權模式:選擇 Pro 以享受 Power BI Pro 體驗,或為容量支援應用程式選擇適當的容量選項。

Pro 選項不需要指定 Fabric 容量。 在建立應用程式前,請先查看 Power BI Pro 的限制。 對於任一選項,請繼續執行以下應用程式建立步驟。

建立一個新的 Fabric 應用程式

  1. 在工作區檢視中,選擇 新項目。
  2. 在物品類型列表中搜尋 「App 」或捲動尋找。
  3. 選擇 應用程式 項目以開啟建立對話框。
  4. 輸入你的Fabric應用程式名稱(例如my-rayfin-app)。
  5. 選取 ,創建。

開啟、編輯並部署你的應用程式

你可以用 Rayfin CLI 在本地開發。

  1. 開啟你選擇的終端機。

  2. 請使用入口網站中顯示的 CLI 指令腳本,並在終端機執行,本地下載應用程式。

    範例

    npm create @microsoft/rayfin@latest -- "<appitemname>" --template todoapp --workspace <workspacename>
    
  3. 去專案目錄看看。

    cd <your project directory>
    
  4. 您可以直接編輯程式碼,或在 GitHub Copilot 的協助下自訂您的應用程式。

  5. 用 Fabric 後端的指令測試本地變更。

    npm run dev
    
  6. 發佈你的變更時,請用以下方式:

    npx rayfin up 
    

    要部署到另一個工作區,你可以提供參數 --workspace 。

    npx rayfin up --workspace <workspacename>
    

    要在這兩個工作區間切換,執行 npx rayfin switch --workspace <workspace>。

下一步