Megosztás a következőn keresztül:

Megvalósítási útmutató

Kezdje a Starter-Kit adattárral a hatékony munkavégzés érdekében. Az adattár elágaztatása ajánlott eljárás – megtarthatja a testreszabást az elágaztatásban, és használhatja saját projektjének alapjaként. A projekt előre konfigurálva van, így azonnal futtathat helyileg, és a szkriptek mindent beállíthatnak Önnek.

Előfeltételek

A helyi fejlesztés Windows, macOS és Linux rendszeren támogatott. Telepítse vagy hozzáféréssel rendelkezzen a következőhöz:

Opcionális

  • Dev container / GitHub Codespaces. Ha Codespace-eket használ, válasszon legalább egy 8 magos gépet, és nyissa meg a kódteret helyileg a VS Code-ban. Ezután kövesse a beállítási útmutatót az adattárban.

Ágazzon le a Starter-Kit saját GitHub-fiókjába, hogy nyomon követhesse és karbantarthassa a módosításokat.

git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit

2. A fejlesztési környezet elindítása

Futtassa a telepítőszkriptet az előfeltételek konfigurálásához (például Microsoft Entra-alkalmazás, alapértelmezett beállítások). MacOS/Linux rendszeren használható pwsh .

# From the repo root
pwsh ./scripts/Setup/Setup.ps1 -WorkloadName "Org.MyWorkload"

Ezután indítsa el a helyi fejlesztési környezetet és a DevGatewayt:

# Terminal 1: start the local dev server (frontend + APIs)
pwsh ./scripts/Run/StartDevServer.ps1

# Terminal 2: register your local instance with Fabric
pwsh ./scripts/Run/StartDevGateway.ps1

3. A beállítás tesztelése

A Fabric portálon

  • Győződjön meg arról, hogy a szükséges bérlői fejlesztői beállítások engedélyezve vannak a felügyeleti portálon.
  • Kapcsolja be a Fabric Fejlesztői módot a fiókjához.
  • Nyissa meg a Workload Hubot, keresse meg a számítási feladatot (például Org.MyWorkload), és hozzon létre egy Hello World-elemet a fejlesztési munkaterületen.
  • Megnyílik a szerkesztő – ellenőrizze, hogy az elem a várt módon működik-e, és natív összetevőként jelenik-e meg a munkaterületen.

4. A kód testreszabása az igényeinek megfelelően

Először végezze el a kisebb módosításokat, és ellenőrizze az elejétől a végéig.

  • Frissítse a szerkesztő összetevőt (például): Workload/app/items/HelloWorldItem/HelloWorldItemEditor.tsx
  • Vagy egy új elemtípust a következőkkel lehet létrehozni: ./scripts/Setup/CreateNewItem.ps1
  • Szükség szerint frissítse a jegyzékfájlt, és futtassa újra helyileg a viselkedés ellenőrzéséhez

AI által támogatott fejlesztés

Ez az adattár jól működik az AI-párok programozási eszközeivel. Akár helyileg, akár a GitHub Codespace-ben fejleszt, a GitHub Copilot vagy más AI-asszisztensek segítségével felgyorsíthatja a feladatokat, például a React-összetevők szerkesztését, az útvonalak frissítését vagy a tesztállványok generálását.

Jótanács

A Starter-Kit adattár AI-kompatibilis, és gitHub Copilot-utasításokat tartalmaz, amelyek végigvezetik a Hello World elem igényeihez való igazításán. Más AI-eszközök (például antropikus Claude) is követhetik ugyanezt az útmutatást, de konfigurálva kell lenniük az adattár útmutató fájljainak vagy dokumentumainak olvasásához.

  • Az AI használatával vázlatot készít az elemszerkesztő/-nézet összetevőiről, majd alkalmazkodik a Starter-Kitben használt gazdagép API-mintákhoz.
  • Kérje meg az AI-t, hogy foglalja össze a számítási feladatjegyzéket, és tegyen javaslatot minimális engedélykészletekre.
  • A Codespacesben a Copilot elérhető a böngészőben vagy a VS Code asztali verziójában; futtassa a fejlesztői kiszolgálót a módosítások azonnali megtekintéséhez.

Jótanács

Ha érdekli, hogy mások mit építenek ki, nyissa meg a Bővíthetőségi mintákat , és telepítse azt a környezetében. Itt olyan gazdag elemtípusokat találhat, amelyek segítenek az első lépésekben.

Gyors iteráció és hibakeresés a Fabricben

A bővíthetőségi keretrendszert gyors fejlesztésre tervezték.

  • A dev server és a DevGateway futtatásakor a kódmódosítások azonnal megjelennek az alkalmazásban, amikor megnyitja az elemet a Fabricben.
  • A hibakeresést a böngésző fejlesztői eszközeivel végezheti el, miközben a számítási feladat a Fabric iFrame-ben van üzemeltetve.
  • Gyorsan iterálja a felhasználói felületet, az útvonalakat és a jegyzékkonfigurációt, és ellenőrizze a végpontok közötti viselkedést a Fabric-munkaterületen.

Ajánlott eljárások

  • Az Starter-Kit adattár fork-olása, és a fork használata a projekt alapjaként.
  • A fejlesztésekhez tartsa szinkronban az elágazást a felsőbb réteggel.
  • A munkaterhelési jegyzék korai ellenőrzése és a minimális jogosultsági engedélyek követése.
  • Használjon dev tárolót vagy codespace-t egy konzisztens, eldobható környezethez.
  • A megadott szkriptekkel (Setup, StartDevServer, StartDevGateway) automatizálhatja a beállítási és a napi munkafolyamatokat.
  • Last updated on