Del via

Tutorial: Kom i gang med Fabric Extensibility Toolkit

Brug denne vejledning til at komme i gang med at oprette en Microsoft Fabric-arbejdsbelastning med Extensibility Toolkit. Du konfigurerer dit miljø, kører Starter-Kit i GitHub Codespaces eller lokalt og lærer det grundlæggende, du skal bruge for at bygge og publicere.

Hvad du bygger

Du kører startpakken i Fabric, udforsker brugen af manifestet og værts-API'en, foretager en lille ændring af brugergrænsefladen og forstår, hvordan elementer, som din arbejdsbelastning opretter, fungerer som oprindelige Fabric-artefakter.

Forudsætninger

  • Adgang til en Fabric-lejer og et arbejdsområde, hvor du kan oprette elementer
  • En GitHub-konto (påkrævet til Codespaces)
  • Hvis du udvikler lokalt: en nyere Node.js LTS og en pakkehåndtering (se README for nøjagtige værktøjer)
  • Adgang til at oprette en Microsoft Entra-applikation
  • Valgfrit: et Azure-abonnement, hvis du planlægger at hoste din webapp i Azure

Tips

Lokal udvikling understøttes indbygget på Windows, macOS og Linux. Før du kører installationsscripts eller starter udviklerserveren, skal du gennemgå og opfylde forudsætningerne i startpakken.

Notat

Du behøver ikke at udrulle noget til din lejer for at prøve Starter-Kit. Brug DevGateway under udviklingen til at emulere Fabric-værten.

Vigtigt

Sørg for, at du har adgang til et Fabric-arbejdsområde, og at din lejer tillader udviklerfunktioner. Du aktiverer Fabric Developer Mode før test.

Vælg din vej

Diagram over Introduktion til Codespaces.

For at komme hurtigt i gang, vælg en af følgende muligheder for at få adgang til koden:

Mulighed 1: Start i GitHub Codespaces

  1. Forgren Starter-Kit Repository til din GitHub-konto.
  2. Opret et GitHub-kodeområde på din fork for at komme i gang med et cloud-baseret udviklingsmiljø.

For mere information om GitHub Codespaces, se GitHub Codespaces-dokumentationen.

Mulighed 2: Klon og kør lokalt

  1. Forgren Starter-Kit Repository til din GitHub-konto.
  2. Klon din fork til din lokale maskine:
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
  1. Installer de nødvendige forudsætninger for lokal udvikling:

Nødvendige værktøjer:

AI-støttet udvikling

Dette lager fungerer godt med AI-parprogrammeringsværktøjer. Uanset om du udvikler lokalt eller i GitHub Codespaces, kan du bruge GitHub Copilot eller andre AI-assistenter til at fremskynde opgaver som redigering af React-komponenter, opdatere ruter eller generere teststilladser.

Tips

Det Starter-Kit lager er AI-aktiveret og indeholder GitHub Copilot-instruktioner, der guider dig gennem tilpasning af Hello World-elementet til dine behov. Andre AI-værktøjer (for eksempel Anthropic Claude) kan følge samme vejledning, men skal konfigureres til at læse arkivets vejledningsfiler eller dokumentation.

  • Brug AI til at udarbejde elementeditor/visningskomponenter og derefter tilpasse til værts-API-mønstrene, der bruges i startpakken.
  • Bed AI om at opsummere arbejdsbelastningsmanifestet og foreslå minimale tilladelsessæt.
  • I Codespaces er Copilot tilgængelig i browseren eller VS Code-skrivebordet; Hold udviklerserveren kørende for at se ændringer med det samme.

Tips

Hvis du er interesseret i at se, hvad andre bygger, skal du åbne udvidelseseksemplerne og installere dem i dit miljø. Der kan du finde detaljerede varetyper, der hjælper dig med at komme i gang.

Bedste praksis

  • Forgren repositoriet: Forgren Starter-Kit repositoriet og brug din forgrening som base for dit projekt.
  • Hold dig synkroniseret: Hold din fork synkroniseret med upstream for at opdage forbedringer.
  • Bevar konsistens i projektstrukturen: Bevar Starter-Kit'ens projektstruktur og organisationsmønstre for at sikre kompatibilitet med fremtidige opdateringer og bevare kodeklarhed.
  • Regelmæssig Starter-Kit integration: Integrer regelmæssigt kodeændringer fra Starter-Kit i dit projekt for at drage fordel af fejlrettelser, nye funktioner og sikkerhedsopdateringer. Etabler en proces til at gennemgå og sammenflette ændringer opstrøms regelmæssigt (månedligt eller kvartalsvis).
  • Valider manifest tidligt: Valider din arbejdsbelastningsmanifest tidligt og følg mindst privilegier-tilladelser.
  • Brug dev containers: Brug en dev container eller Codespaces for et ensartet, engangs miljø.
  • Brug de medfølgende scripts: Brug de medfølgende scripts (Setup, StartDevServer, StartDevGateway) til at automatisere opsætning og daglig arbejdsgang.

Næste trin

Når du har adgang til koden (enten i Codespaces eller lokalt), fortsæt med den detaljerede opsætningsguide for trin-for-trin instruktioner om:

  • Kørsel af setup-scriptet
  • Opstart af udviklingsmiljøet
  • Aktivering af Fabric-udviklerfunktioner
  • Test af dit første HelloWorld-produkt
  • At komme i gang med kodning
  • AI-assisteret udviklingstips
  • Fejlfinding af almindelige problemer

Yderligere ressourcer

  • Last updated on