Dela via

DevServer med Microsoft Fabric

DevServer är den lokala webbserver som du kör när du utvecklar en Fabric arbetsbelastning. Den betjänar din klientdel (SPA) på localhost och tillhandahåller en liten uppsättning HTTP-slutpunkter som Fabric anropar under utvecklingen för att hämta dina produkt- och objektmanifest. I kombination med DevGateway kan Fabric ladda in arbetsbelastningens användargränssnitt i en iFrame och läsa manifestdata utan att publicera något till din hyresgäst.

Vad DevServer gör

  • Är värd för din arbetsbelastningsklientdel via HTTP på localhost (till exempel http://localhost:60006) så att Fabric kan läsa in den i en iFrame.
  • Hanterar statiska tillgångar som refereras av dina manifest (ikoner, lokaliserade strängar, bilder).
  • Exponerar lokala JSON-slutpunkter som Fabric använder för att läsa dina manifest under utvecklingen.
  • Möjliggör snabba redigeringscykler med hot reload i de flesta konfigurationer.

Viktigt!

DevServer fungerar tillsammans med DevGateway. DevGateway registrerar din lokala arbetsbelastningsinstans med Fabric så att tjänsten kan kommunicera med dina DevServer-slutpunkter medan du utvecklar.

Där Fabric anropar DevServer

När du aktiverar utvecklingsläget och startar både DevGateway och DevServer:

  • Infrastrukturresurserna navigerar till klientdelen via klientdelsslutpunkten som definieras av arbetsbelastningsmanifestet (se Arbetsbelastningsmanifest). Under utveckling pekar detta vanligtvis på en localhost-URL som exponeras av DevServer.
  • Fabric frågar DevServer efter dina produktorienterade metadata så att den kan rendera navigering, paneler och annan användarupplevelse för din belastning. På så sätt kan du iterera på Product.json och objektmanifest utan att återskapa och ladda upp ett paket.

Lokala slutpunkter som DevServer tillhandahåller

Exakta vägar kan variera beroende på mall, men exempellagringsplatsen exponerar en liten uppsättning förutsägbara slutpunkter:

  • GET / – skickar tillbaks din webbapp (UI Fabric laddas in i en iFrame).
  • GET /manifest – returnerar en JSON-nyttolast som aggregerar ditt produktmanifest och objektmanifest som används av klientdelen. Detta speglar strukturen fabric förväntar sig vid publiceringstidpunkt (se Produktmanifest och Objektmanifest).
  • GET /assets/... – hanterar ikoner, bilder och lokaliserade strängar som refereras av dina manifest.

Anmärkning

  • CORS och headers är förkonfigurerade i exempel-DevServern så att appen kan bäddas in och kommunicera med värden.
  • Routningsnamnen ovan följer det aktuella exemplet. Läs mer i README för mallen om projektet använder en annan sökväg för manifestslutpunkten.

Typiskt utvecklingsflöde

  1. Starta DevServer från exempel-repositoryt för att hosta din frontend på localhost.
  2. Starta DevGateway för att registrera din lokala arbetsbelastning med Fabric.
  3. Öppna din Fabric-arbetsyta och starta ingångspunkten för arbetsbelastningen. Fabric läser in din app i en iFrame och anropar dina DevServer-slutpunkter för att läsa manifestdata.
  4. Redigera användargränssnitt eller manifestfiler och uppdatera; ändringarna börjar gälla omedelbart utan ompaketering.

Information om hur du startar varje process finns i självstudien Komma igång och installationsguiden.

Relation till publicerade manifest

I produktionsmiljö paketeras ditt arbetslastermanifest och laddas upp som en del av arbetslastens NuGet-paket (se Manifestöversikt). Under utvecklingen fungerar DevServers lokala slutpunkter som en enkel stand-in för de paketerade filerna så att du snabbt kan iterera:

  • Schema och regler är samma som för publicerade manifest.
  • DevServer påverkar endast lokal utveckling. det ändrar inte hur publicering fungerar.

Felsökningstips

  • Om iFrame visar en tom sida bekräftar du att DevServer körs och klientdelsslutpunkten i manifestet pekar på rätt localhost-URL.
  • Om ikoner eller strängar saknas, kontrollera sökvägarna assets och att DevServern tillhandahåller dessa filer under /assets.
  • Om Fabric inte kan hitta dina manifest kontrollerar du att /manifests vägen finns i mallen och returnerar giltig JSON.

Se även

  • Last updated on