Dela via

Detaljerad installationsguide

När du har åtkomst till koden (antingen i Codespaces eller lokalt) genom att följa guiden Komma igång följer du dessa steg:

Tips/Råd

Om du inte vill följa stegen manuellt ber du GitHub Copilot att hjälpa dig att utföra arbetet. Den Starter-Kit lagringsplatsen är AI-aktiverad och Copilot kan vägleda dig genom installationsprocessen interaktivt. Prova den här uppmaningen: "Hjälp mig att komma igång med den här lagringsplatsen och kör HelloWorld-exemplet."

Steg 1: Kör installationsskriptet

Installationsskriptet automatiserar de flesta konfigurationer (appregistrering, standardvärden osv.).

# From the repo root
pwsh ./scripts/Setup/Setup.ps1 -WorkloadName "Org.MyWorkload"

Installationsskriptanteckningar:

  • WorkloadName måste följa mönstret Organization.WorkloadName. För utveckling använder du Org.[YourWorkloadName].
  • Om du återanvänder en befintlig Microsoft Entra-app kontrollerar du att SPA-omdirigerings-URI:er har konfigurerats enligt beskrivningen i den manuella installationsguiden för lagringsplatser.
  • På macOS/Linux använder du pwsh för att köra skript.
  • Kontrollera att PowerShell-körningsprincipen är inställd på Obegränsad och att filerna avblockeras om du tillfrågas om PowerShell-filerna ska startas.
  • Följ de anvisningar som skriptet ger för att få allt konfigurerat

Installationsskriptet kan köras flera gånger. Om det redan finns värden tillfrågas du om de ska skrivas över. Om du vill skriva över allt använder du force-parametern.

Anmärkning

Om du stöter på installationsfel läser du installationsfelet för PowerShell i felsökningsavsnittet nedan.

Tips/Råd

Om du har problem med det automatiserade installationsskriptet kan du följa guiden för manuell installation för stegvis manuell konfiguration.

Steg 2: Starta utvecklingsmiljön

Kör utvecklingsservern (klientdelen + API:er) och registrera din lokala instans med Fabric via DevGateway.

# Terminal 1: start local dev server
pwsh ./scripts/Run/StartDevServer.ps1

# Terminal 2: start DevGateway to register your local instance with Fabric
pwsh ./scripts/Run/StartDevGateway.ps1

Steg 3: Aktivera utvecklarfunktioner i Fabric

Gå till Infrastrukturportalen och konfigurera de inställningar som krävs:

3.1 Konfigurera klientinställningar i administratörsportalen:

Gå till administratörsportalens inställningar och aktivera följande klientinställningar:

  • Kapacitetsadministratörer och deltagare kan lägga till och ta bort ytterligare arbetsbelastningar
  • Arbetsytaadministratörer kan skapa partnerarbetsflöden
  • Användare kan se och arbeta med ytterligare arbetsbelastningar som inte har verifierats av Microsoft

Skärmbild av klientinställningar.

3.2 Aktivera Fabric-utvecklarläge:

Gå till Inställningar för infrastrukturutvecklare och aktivera infrastrukturutvecklingsläget:

Skärmbild av Fabric-utvecklingsläget.

Nu är du redo att skapa ditt första Hello World Item i Fabric.

Steg 4: Testa HelloWorld-objektet

Du kan komma åt arbetsbelastningen från arbetsbelastningshubben (leta efter ditt arbetsbelastningsnamn) eller navigera direkt. Skapa sedan ett Hello World-objekt.

Steps:

  1. Open Fabric Workload Hub: Leta upp din arbetsbelastning (till exempel Org.MyWorkload).

    • Direkt navigering: https://app.fabric.microsoft.com/workloadhub/detail/<WORKLOAD_NAME>?experience=fabric-developer
    • Ersätt <WORKLOAD_NAME> med ditt faktiska arbetsbelastningsnamn (t.ex. Org.MyWorkload)

  2. Skapa ett nytt objekt: Välj objekttypen Hello World och välj din utvecklingsarbetsyta.

  3. Verifiera funktioner: Redigeraren öppnas; bekräfta att objektet fungerar som förväntat och visas som en intern artefakt på arbetsytan.

Grattis! Du skapade ditt första objekt från utvecklingsmiljön.

Steg 5: Börja koda

Nu när du är konfigurerad kan du börja skapa egna anpassade objekt. Följ vår omfattande guide för att lära dig hur du skapar anpassade fabric-objekt:

📖 Guide för att skapa anpassade tygföremål – Den här guiden innehåller två metoder för att skapa objekt:

  • AI-Assisterad ansats: Använd GitHub Copilot för interaktiv vägledning (särskilt rekommenderas för nya utvecklare).
  • Manuell skriptmetod: Använd automatiserade PowerShell-skript för snabb installation (rekommenderas för erfarna utvecklare)

Snabbstartsalternativ:

  • Uppdatera den befintliga HelloWorld-redigeraren: Workload/app/items/HelloWorldItem/HelloWorldItemEditor.tsx
  • Eller skapa ett nytt objekt med skriptet: ./scripts/Setup/CreateNewItem.ps1

Glad kodning! 🚀

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.

Felsökning av vanliga problem

PowerShell-installationsfel

Om du får ett fel under körningen av installationsskriptet kontrollerar du att du har den senaste PowerShell-versionen installerad och konfigurerad i den miljö som du kör skriptet.

Skärmbild av powershell-installationsfel.

Fel i skriptkörningsprincip

Om du stöter på: : cannot be loaded because the execution policy is unrestricted

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Port 5173 används

Om DevServer inte kan starta på port 5173 letar du upp och avslutar processen:

# Find process using port
Get-Process -Id (Get-NetTCPConnection -LocalPort 5173).OwningProcess

# Terminate process
Stop-Process -Id <ProcessId> -Force

Beroendefelaktigheter

Om du får ett meddelande om saknade beroenden:

# From Workload folder
cd Workload
npm install

Problem med DevGateway-autentisering

Om autentiseringen misslyckas när DevGateway startas:

  1. Verifiera omdirigerings-URI:er för appregistrering i Microsoft Entra
  2. Kontrollera att klientinställningarna tillåter de nödvändiga utvecklarfunktionerna
  3. Kontrollera att du är inloggad på rätt klientorganisation i DevGateway

Omfattande information om felsökning finns i README-filen för Starter-Kit-lagringsplatsen.

Viktiga anteckningar

Nya begränsningar för lokal nätverksåtkomst i Chrome

Google har infört nya begränsningar för lokal nätverksåtkomst (LNA) i Chrome som bryter den lokala utvecklingen med DevServer. Dessa begränsningar hindrar webbplatser från att komma åt lokala nätverksresurser utan uttrycklig användarbehörighet.

Åtgärd som krävs för lokal utveckling: Du måste ändra Chrome-konfigurationen för att fortsätta utveckla arbetsbelastningar lokalt:

  1. Navigera till chrome://flags/#local-network-access-check i Chrome
  2. Ange flaggan till "Inaktiverad"
  3. Starta om Chrome

Varför detta behövs: De nya begränsningarna blockerar kommunikationen mellan din arbetsbelastning som körs i Infrastruktur och den lokala DevGateway-servern, vilket är viktigt för arbetsflödet för utveckling.

Ytterligare resurser:

Viktigt!

Utan att inaktivera den här flaggan fungerar inte lokal utveckling med DevGateway i Chrome. Den här konfigurationsändringen behövs bara för utvecklingsmiljöer.

Nästa steg

  • Last updated on