Zdieľať cez

Tutoriál: Začnite s Fabric Extensibility Toolkit

Pomocou tejto príručky môžete začať vytvárať vyťaženie služby Microsoft Fabric pomocou súpravy nástrojov Extensibility Toolkit. Nastavíte svoje prostredie, spustíte Starter-Kit v GitHub Codespaces alebo lokálne a naučíte sa základy, ktoré potrebujete na zostavenie a publikovanie.

Čo vytvoríte

Spustíte štartovaciu súpravu v službe Fabric, preskúmate jej manifest a využitie rozhrania API hostiteľa, vykonáte malú zmenu používateľského rozhrania a pochopíte, ako sa položky vytvorené vašou pracovnou záťažou správajú ako natívne artefakty služby Fabric.

Požiadavky

  • Prístup k nájomníkovi služby Fabric a pracovnému priestoru, v ktorom môžete vytvárať položky
  • Konto GitHub (vyžaduje sa pre priestory kódu)
  • Ak vyvíjate lokálne: nedávny Node.js LTS a správca balíkov (presné nástroje nájdete v súbore README)
  • Prístup k vytvoreniu aplikácie Microsoft Entra
  • Voliteľné: predplatné Azure, ak plánujete hosťovať webovú aplikáciu v Azure

Prepitné

Lokálny vývoj je natívne podporovaný v systémoch Windows, macOS a Linux. Pred spustením inštalačných skriptov alebo spustením vývojárskeho servera skontrolujte a splňte predpoklady v Starter-Kit.

Poznámka

Na vyskúšanie Starter-Kitu nemusíte nič nasadzovať na svojho tenanta. Použite DevGateway počas vývoja na emuláciu hostiteľa Fabric.

Dôležité

Uistite sa, že máte prístup k pracovnému priestoru služby Fabric a váš nájomník umožňuje funkcie pre vývojárov. Pred testovaním povolíte režim vývojára štruktúry.

Vyberte si svoju cestu

Diagram Začíname s priestormi kódu.

Aby ste začali rýchlo, vyberte si jednu z nasledujúcich možností na prístup ku kódu:

Možnosť č. 1: Spustenie v priestoroch kódu GitHub

  1. Forknite Starter-Kit Repository na svoj GitHub účet.
  2. Vytvorte si GitHub Codespace na vašom forku, aby ste mohli začať s cloudovým vývojárskym prostredím.

Viac informácií o GitHub Codespaces nájdete v dokumentácii GitHub Codespaces.

Možnosť 2: Klonujte a spustite lokálne

  1. Forknite Starter-Kit Repository na svoj GitHub účet.
  2. Naklonujte vidličku na miestny stroj:
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
  1. Inštalujte potrebné predpoklady pre miestny rozvoj:

Potrebné nástroje:

Vývoj s podporou AI

Toto úložisko funguje dobre s nástrojmi na párové programovanie AI. Bez ohľadu na to, či vyvíjate lokálne alebo v GitHub Codespaces, môžete použiť GitHub Copilot alebo iných asistentov AI na urýchlenie úloh, ako je úprava komponentov React, aktualizácia trás alebo generovanie testovacieho lešenia.

Prepitné

Odkladací priestor Starter-Kit podporuje umelú inteligenciu a obsahuje pokyny GitHub Copilot, ktoré vás prevedú prispôsobením položky Hello World vašim potrebám. Iné AI nástroje (napríklad Anthropic Claude) môžu nasledovať rovnaké pokyny, ale musia byť nakonfigurované tak, aby čítali súbory alebo dokumentáciu s pokynmi v repozitári.

  • Použite AI na koncept editora/zobrazenia komponentov položiek a potom sa prispôsobte vzorom hostiteľského API použitým v Starter-Kit.
  • Požiadajte umelú inteligenciu, aby zhrnula manifest pracovného zaťaženia a navrhla minimálne množiny povolení.
  • V Codespaces je Copilot k dispozícii v prehliadači alebo na pracovnej ploche VS Code; Nechajte vývojársky server spustený, aby ste okamžite videli zmeny.

Prepitné

Ak vás zaujíma, čo vytvárajú iní, otvorte ukážky rozšíriteľnosti a nasaďte ich do svojho prostredia. Nájdete tu bohaté typy položiek, ktoré vám pomôžu začať.

Osvedčené postupy

  • Forkujte repozitár: Forkujte Starter-Kit repozitár a použite svoj fork ako základ projektu.
  • Zostaňte v súlade: Udržujte svoj fork synchronizovaný s upstreamom, aby ste mohli zachytiť vylepšenia.
  • Udržiavajte konzistentnosť štruktúry projektu: Zachovajte štruktúru projektu a organizačné vzory Starter-Kitu, aby ste zabezpečili kompatibilitu s budúcimi aktualizáciami a zachovali jasnosť kódu.
  • Pravidelná integrácia Starter-Kit: Pravidelne integrujte zmeny kódu z Starter-Kit do svojho projektu, aby ste mohli využiť opravy chýb, nové funkcie a bezpečnostné aktualizácie. Nastavte proces na pravidelné prehodnocovanie a zlučovanie zmien v upstream sektore (mesačne alebo štvrťročne).
  • Overujte manifesty včas: Overte manifest práce včas a dodržiavajte povolenia s najnižšími oprávneniami.
  • Používajte vývojové kontajnery: Používajte vývojový kontajner alebo Codespaces pre konzistentné, jednorazové prostredie.
  • Používajte poskytnuté skripty: Používajte poskytnuté skripty (Setup, StartDevServer, StartDevGateway) na automatizáciu nastavenia a každodenného pracovného postupu.

Ďalšie kroky

Keď budete mať prístup ku kódu (či už v Codespaces alebo lokálne), pokračujte v Podrobnom nastavovacom sprievodcovi pre podrobné inštrukcie k:

  • Spustenie inštalačného skriptu
  • Začiatok vývojového prostredia
  • Povolenie vývojárskych funkcií Fabric
  • Testovanie vášho prvého HelloWorld produktu
  • Začiatok s programovaním
  • Tipy na vývoj s podporou AI
  • Riešenie bežných problémov

Ďalšie zdroje informácií

  • Last updated on