Del via

Veiledning: Kom i gang med Fabric Extensibility Toolkit

Bruk denne veiledningen til å komme i gang med å bygge en Microsoft Fabric-arbeidsbelastning med utvidelsesverktøysettet. Du konfigurerer miljøet, kjører Starter-Kit i GitHub Codespaces eller lokalt, og lærer det grunnleggende du trenger for å bygge og publisere.

Hva du bygger

Du kjører startpakken i Fabric, utforsker manifest- og verts-API-bruken, gjør en liten endring i brukergrensesnittet og forstår hvordan elementer arbeidsbelastningen oppretter, fungerer som opprinnelige Fabric-artefakter.

Forutsetninger

  • Tilgang til en Fabric-leier og et arbeidsområde der du kan opprette elementer
  • En GitHub-konto (kreves for Codespaces)
  • Hvis du utvikler lokalt: en nylig Node.js LTS og en pakkebehandler (se README for nøyaktig verktøy)
  • Tilgang til å opprette en Microsoft Entra-applikasjon
  • Valgfritt: et Azure-abonnement hvis du planlegger å drifte nettappen din i Azure

Tips

Lokal utvikling støttes opprinnelig på Windows, macOS og Linux. Før du kjører installasjonsskript eller starter utviklerserveren, må du se gjennom og oppfylle forutsetningene i startpakken.

Note

Du trenger ikke å distribuere noe til leietakeren din for å prøve Starter-Kit. Bruk DevGateway under utvikling for å emulere Fabric-verten.

Viktig!

Sørg for at du har tilgang til et Fabric-arbeidsområde, og at leieren tillater utviklerfunksjoner. Du aktiverer Fabric Developer Mode før du tester.

Velg din vei

Diagram over Komme i gang med kodeområder.

For å komme raskt i gang, velg ett av følgende alternativer for å få tilgang til koden:

Alternativ 1: Start i GitHub Codespaces

  1. Fork Starter-Kit Repository til din GitHub-konto.
  2. Lag et GitHub-kodeområde på forken din for å komme i gang med et skybasert utviklingsmiljø.

For mer informasjon om GitHub Codespaces, se GitHub Codespaces-dokumentasjon.

Alternativ 2: Klon og kjør lokalt

  1. Fork Starter-Kit Repository til din GitHub-konto.
  2. Klon gaffelen din til din lokale maskin:
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
  1. Installer de nødvendige forutsetningene for lokal utvikling:

Nødvendige verktøy:

AI-assistert utvikling

Dette depotet fungerer bra med AI-parprogrammeringsverktøy. Enten du utvikler lokalt eller i GitHub Codespaces, kan du bruke GitHub Copilot eller andre AI-assistenter til å akselerere oppgaver som redigering av React-komponenter, oppdatere ruter eller generere teststillas.

Tips

Starter-Kit-repositoriet er AI-aktivert og inkluderer GitHub Copilot-instruksjoner som veileder deg gjennom å tilpasse Hello World-elementet til dine behov. Andre AI-verktøy (for eksempel Anthropic Claude) kan følge samme veiledning, men må konfigureres til å lese repositoriets veiledningsfiler eller dokumentasjoner.

  • Bruk AI til å lage utkast til elementredigerings-/visningskomponenter og deretter tilpasse deg verts-API-mønstrene som brukes i startpakken.
  • Be AI om å oppsummere arbeidsbelastningsmanifestet og foreslå minimale tillatelsessett.
  • I Codespaces er Copilot tilgjengelig i nettleseren eller VS Code-skrivebordet; Hold utviklerserveren i gang for å se endringer umiddelbart.

Tips

Hvis du er interessert i å se hva andre bygger, åpner du utvidelseseksemplene og distribuerer dem til miljøet ditt. Der kan du finne rike varetyper som hjelper deg med å komme i gang.

Beste fremgangsmåter

  • Fork repositoriet: Fork Starter-Kit-repositoriet og bruk forken din som base for prosjektet ditt.
  • Hold deg synkronisert: Hold forken din synkronisert med upstream for å oppdage forbedringer.
  • Oppretthold konsistens i prosjektstrukturen: Bevar Starter-Kits prosjektstruktur og organisasjonsmønstre for å sikre kompatibilitet med fremtidige oppdateringer og opprettholde kodeklarhet.
  • Regelmessig Starter-Kit-integrasjon: Integrer jevnlig kodeendringer fra Starter-Kit i prosjektet ditt for å dra nytte av feilrettinger, nye funksjoner og sikkerhetsoppdateringer. Sett opp en prosess for å gjennomgå og slå sammen endringer oppstrøms regelmessig (månedlig eller kvartalsvis).
  • Valider manifestasjoner tidlig: Valider arbeidsbelastningsmanifestasjonen din tidlig og følg minst privilegierte tillatelser.
  • Bruk dev containers: Bruk en dev container eller Codespaces for et konsistent, engangs miljø.
  • Bruk oppgitte skript: Bruk de medfølgende skriptene (Setup, StartDevServer, StartDevGateway) for å automatisere oppsett og daglig arbeidsflyt.

Neste trinn

Når du har tilgang til koden (enten i Codespaces eller lokalt), fortsett med den detaljerte oppsettsguiden for trinnvise instruksjoner om:

  • Kjøring av oppsettsskriptet
  • Oppstart av utviklingsmiljøet
  • Aktivering av Fabric-utviklerfunksjoner
  • Testing av ditt første HelloWorld-produkt
  • Å komme i gang med koding
  • AI-assistert utviklingstips
  • Feilsøking av vanlige problemer

Flere ressurser

  • Last updated on