Dela via

Självstudie: Kom igång med Fabric Extensibility Toolkit

Använd den här guiden för att komma igång med att skapa en Microsoft Fabric-arbetsbelastning med Verktyget för utökningsbarhet. Du konfigurerar din miljö, kör Starter-Kit i GitHub Codespaces eller lokalt och lär dig grunderna du behöver för att skapa och publicera.

Det här skapar du

Du kör Starter-Kit i Fabric, utforskar dess manifest och användning av värd-API, gör en liten UI-förändring och förstår hur objekt som din arbetsbörda skapar fungerar som inhemska Fabric-artefakter.

Förutsättningar

  • Åtkomst till en Fabric-klient och en arbetsyta där du kan skapa objekt
  • Ett GitHub-konto (krävs för Codespaces)
  • Om du utvecklar lokalt: en nyligen Node.js LTS och en pakethanterare (se README för exakta verktyg)
  • Åtkomst till att skapa ett Microsoft Entra-program
  • Valfritt: en Azure-prenumeration om du planerar att vara värd för din webbapp i Azure

Tips/Råd

Lokal utveckling stöds internt i Windows, macOS och Linux. Innan du kör installationsskript eller startar utvecklingsservern bör du granska och uppfylla kraven i Starter-Kit.

Anmärkning

Du behöver inte distribuera något till din klientorganisation för att prova Starter-Kit. Använd DevGateway under utveckling för att emulera värden för Fabric.

Viktigt!

Se till att du har åtkomst till en Fabric-arbetsyta och att din hyresgäst tillåter utvecklarfunktioner. Du aktiverar Fabric Developer Mode innan du testar.

Välj sökväg

Diagram över Kom igång med Codespaces.

Kom igång snabbt genom att välja något av följande alternativ för att komma åt koden:

Alternativ 1: Starta i GitHub Codespaces

  1. Förgrena Starter-Kit-lagringsplatsen till ditt GitHub-konto.
  2. Skapa ett GitHub Codespace på din förgrening för att komma igång med en molnbaserad utvecklingsmiljö.

Mer information om GitHub Codespaces finns i Dokumentation om GitHub Codespaces.

Alternativ 2: Klona och köra lokalt

  1. Förgrena Starter-Kit-lagringsplatsen till ditt GitHub-konto.
  2. Klona din fork till din lokala dator:
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
  1. Installera nödvändiga förutsättningar för lokal utveckling:

Nödvändiga verktyg:

AI-assisterad utveckling

Den här lagringsplatsen fungerar bra med AI-parprogrammeringsverktyg. Oavsett om du utvecklar lokalt eller i GitHub Codespaces kan du använda GitHub Copilot eller andra AI-assistenter för att påskynda uppgifter som att redigera React-komponenter, uppdatera vägar eller generera testställningar.

Tips/Råd

Den Starter-Kit lagringsplatsen är AI-aktiverad och innehåller GitHub Copilot-instruktioner som hjälper dig att anpassa Hello World-objektet efter dina behov. Andra AI-verktyg (till exempel Anthropic Claude) kan följa samma vägledning, men måste konfigureras för att läsa lagringsplatsens vägledningsfiler eller dokument.

  • Använd AI för att skapa itemredigerare/visningskomponenter och sedan anpassa dessa till värd-API:ns mönster som används i Starter-Kit.
  • Be AI sammanfatta arbetsbelastningsmanifestet och föreslå minimala behörighetsuppsättningar.
  • I Codespaces är Copilot tillgängligt i webbläsaren eller VS Code-skrivbordet. se till att utvecklingsservern körs för att se ändringar direkt.

Tips/Råd

Om du är intresserad av att se vad andra skapar öppnar du Extensibility Samples och distribuerar det till din miljö. Där hittar du omfattande objekttyper som hjälper dig att komma igång.

Metodtips

  • Förgrena lagringsplatsen: Förgrena Starter-Kit-lagringsplatsen och använd din förgrening som bas för projektet.
  • Håll dig synkroniserad: Håll din fork synkroniserad med uppströms för att få förbättringar.
  • Underhåll projektstrukturkonsekvens: Bevara Starter-Kits projektstruktur och organisationsmönster för att säkerställa kompatibilitet med framtida uppdateringar och upprätthålla kodskärpa.
  • Regelbunden Starter-Kit integrering: Integrera regelbundet kodändringar från Starter-Kit i projektet för att dra nytta av felkorrigeringar, nya funktioner och säkerhetsuppdateringar. Konfigurera en process för att granska och slå samman överordnade ändringar regelbundet (månadsvis eller kvartalsvis).
  • Verifiera manifest tidigt: Verifiera arbetsbelastningsmanifestet tidigt och följ behörigheter med lägsta behörighet.
  • Använd dev-containrar: Använd en utvecklingscontainer eller codespaces för en konsekvent, disponibel miljö.
  • Använd angivna skript: Använd de angivna skripten (Installation, StartDevServer, StartDevGateway) för att automatisera installationen och det dagliga arbetsflödet.

Nästa steg

När du har åtkomst till koden (antingen i Codespaces eller lokalt) fortsätter du med den detaljerade installationsguiden för stegvisa instruktioner om:

  • Köra installationsskriptet
  • Starta utvecklingsmiljön
  • Aktivera Fabric-utvecklarfunktioner
  • Testa ditt första HelloWorld-objekt
  • Komma igång med kodning
  • TIPS för AI-assisterad utveckling
  • Felsökning av vanliga problem

Ytterligare resurser

  • Last updated on