Delen via

Zelfstudie: Aan de slag met Fabric Extensibility Toolkit

Gebruik deze handleiding om aan de slag te gaan met het bouwen van een Microsoft Fabric-workload met de Extensibility Toolkit. U stelt uw omgeving in, voert de Starter-Kit uit in GitHub Codespaces of lokaal en leert de basisbeginselen die u nodig hebt om te bouwen en publiceren.

Wat u bouwt

U voert de Starter-Kit uit in Fabric, verkent het manifest- en host-API-gebruik, brengt een kleine UI-wijziging aan en begrijpt hoe items die uw workload maakt zich gedragen als systeemeigen Fabric-artefacten.

Vereiste voorwaarden

  • Toegang tot een Fabric-tenant en een werkruimte waar u items kunt maken
  • Een GitHub-account (vereist voor Codespaces)
  • Als u lokaal ontwikkelt: een recente Node.js LTS en een pakketbeheerder (zie de README voor exacte hulpprogramma's)
  • Toegang om een Microsoft Entra-toepassing te maken
  • Optioneel: een Azure-abonnement als u van plan bent om uw web-app te hosten in Azure

Aanbeveling

Lokale ontwikkeling wordt systeemeigen ondersteund in Windows, macOS en Linux. Voordat u installatiescripts uitvoert of de ontwikkelserver start, controleert en voldoet u aan de vereisten in de Starter-Kit.

Opmerking

U hoeft niets in uw tenant te implementeren om de Starter-Kit uit te proberen. Gebruik de DevGateway tijdens de ontwikkeling om de Fabric-host te emuleren.

Belangrijk

Zorg ervoor dat u toegang hebt tot een Fabric-werkruimte en dat uw tenant ontwikkelaarsfuncties toestaat. U schakelt de fabric-ontwikkelaarsmodus in voordat u gaat testen.

Kies uw pad

Diagram van Aan de slag met Codespaces.

Als u snel aan de slag wilt gaan, kiest u een van de volgende opties voor toegang tot de code:

Optie 1: Starten in GitHub Codespaces

  1. Fork de Starter-Kit-opslagplaats naar uw GitHub-account.
  2. Maak een GitHub Codespace op uw fork om aan de slag te gaan met een ontwikkelomgeving in de cloud.

Zie de documentatie voor GitHub Codespaces voor meer informatie over GitHub Codespaces.

Optie 2: Lokaal klonen en uitvoeren

  1. Fork de Starter-Kit-opslagplaats naar uw GitHub-account.
  2. Kloon uw fork naar uw lokale computer:
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
  1. Installeer de vereiste vereisten voor lokale ontwikkeling:

Benodigde hulpmiddelen:

Ai-ondersteunde ontwikkeling

Deze opslagplaats werkt goed met AI-hulpprogramma's voor pair-programmeren. Of u nu lokaal of in GitHub Codespaces ontwikkelt, u kunt GitHub Copilot of andere AI-assistenten gebruiken om taken zoals het bewerken van React-onderdelen, het bijwerken van routes of het genereren van test-scaffolding te versnellen.

Aanbeveling

De Starter-Kit opslagplaats is AI-ondersteund en bevat GitHub Copilot-instructies die u begeleiden bij het aanpassen van het Hello World-item aan uw behoeften. Andere AI-hulpprogramma's (bijvoorbeeld Anthropic Claude) kunnen dezelfde richtlijnen volgen, maar moeten worden geconfigureerd om de richtlijnen of documenten van de repository te lezen.

  • Gebruik AI om concepten van items voor bewerking en weergave te ontwikkelen en pas deze vervolgens aan op de host-API-patronen die in de Starter-Kit worden gebruikt.
  • Vraag AI om het workloadmanifest samen te vatten en minimale machtigingensets voor te stellen.
  • In Codespaces is Copilot beschikbaar in de browser of vs Code-desktop; houd de dev-server actief om wijzigingen direct te zien.

Aanbeveling

Als u wilt zien wat anderen bouwen, opent u de uitbreidbaarheidsvoorbeelden en implementeert u deze in uw omgeving. Daar vindt u uitgebreide itemtypen waarmee u aan de slag kunt gaan.

Beste praktijken

  • Fork de opslagplaats: Fork de Starter-Kit opslagplaats en gebruik je fork als basis voor je project.
  • Gesynchroniseerd houden: houd uw fork gesynchroniseerd met upstream om verbeteringen op te halen.
  • Consistentie van de projectstructuur behouden: behoud de projectstructuur en organisatiepatronen van de Starter-Kit om compatibiliteit met toekomstige updates te garanderen en codehelder te houden.
  • Regelmatige integratie van Starter-Kit: integreer regelmatig codewijzigingen van de Starter-Kit in uw project om te profiteren van bugfixes, nieuwe functies en beveiligingsupdates. Stel een proces in voor het regelmatig controleren en samenvoegen van upstreamwijzigingen (maandelijks of per kwartaal).
  • Valideer manifesten vroeg: Valideer het workloadmanifest vroeg en volg machtigingen met minimale bevoegdheden.
  • Dev-containers gebruiken: gebruik een dev-container of Codespaces voor een consistente, wegwerpomgeving.
  • Gebruik opgegeven scripts: gebruik de opgegeven scripts (Setup, StartDevServer, StartDevGateway) om de installatie en de dagelijkse werkstroom te automatiseren.

Volgende stappen

Zodra u toegang hebt tot de code (in Codespaces of lokaal), gaat u verder met de gedetailleerde installatiehandleiding voor stapsgewijze instructies voor:

  • Het installatiescript uitvoeren
  • De ontwikkelomgeving starten
  • Functies voor fabric-ontwikkelaars inschakelen
  • Uw eerste HelloWorld-item testen
  • Aan de slag met coderen
  • AI-geassisteerde ontwikkelingstips
  • Veelvoorkomende problemen oplossen

Aanvullende bronnen

  • Last updated on