Del via

DevServer med Microsoft Fabric

DevServer er den lokale webserver, du kører, mens du udvikler en Fabric-arbejdsbelastning. Den betjener din frontend (SPA) på localhost og leverer et lille sæt HTTP-slutpunkter, som Fabric kalder under udviklingen for at hente dine produkt- og varemanifester. Når det kombineres med DevGateway, kan Fabric indlæse brugergrænsefladen til din arbejdsbelastning i en iFrame og læse dine manifestdata uden at publicere noget til din lejer.

Hvad DevServer gør

  • Hoster din arbejdsbelastningsfrontend over HTTP på localhost (f.eks. http://localhost:60006), så Fabric kan indlæse den i en iFrame.
  • Serverer statiske aktiver, der refereres til af dine manifester (ikoner, lokaliserede strenge, billeder).
  • Viser lokale JSON-slutpunkter, som Fabric bruger til at læse dine manifester under udviklingen.
  • Muliggør hurtige redigerings-opdateringscyklusser med varm genindlæsning i de fleste opsætninger.

Vigtigt

DevServer arbejder sammen med DevGateway. DevGateway registrerer din lokale arbejdsbelastningsforekomst med Fabric, så tjenesten ved, at den skal tale med dine DevServer-slutpunkter, mens du udvikler.

Hvor Fabric kalder DevServer

Når du aktiverer udviklingstilstand og starter både din DevGateway og DevServer:

  • Fabric navigerer til din frontend via det frontendslutpunkt, der er defineret af dit arbejdsbelastningsmanifest (se Arbejdsbelastningsmanifest). Under udvikling peger dette normalt på en localhost-URL, der er eksponeret af DevServer.
  • Fabric forespørger DevServer om dine produktorienterede metadata, så den kan gengive navigation, felter og anden brugeroplevelse for din arbejdsbelastning. Dette giver dig mulighed for at gentage Product.json og genstandsmanifester uden at genopbygge og overføre en pakke.

Lokale slutpunkter, som DevServer leverer

Nøjagtige ruter kan variere efter skabelon, men eksempellageret viser et lille sæt forudsigelige slutpunkter:

  • GET / — returnerer din webapp (UI Fabric indlæses i en iFrame).
  • GET /manifests – returnerer en JSON-nyttedata, der samler dine produktmanifester og varemanifester, der bruges af frontend. Dette afspejler den struktur, som Fabric forventer på udgivelsestidspunktet (se Produktmanifest og Varemanifest).
  • GET /assets/... – serverer ikoner, billeder og lokaliserede strenge, der refereres til af dine manifester.

Notat

  • CORS og headere er forudkonfigureret i DevServer-eksempelet, så appen kan integreres og kommunikere med værten.
  • Rutenavnene ovenfor følger det nuværende eksempel; konsulter din skabelons README, hvis dit projekt bruger en anden sti for manifests-endpointet.

Typisk udviklingsforløb

  1. Start DevServer fra eksempellageret for at hoste din frontend på localhost.
  2. Start DevGateway for at registrere din lokale arbejdsbelastning med Fabric.
  3. Åbn dit Fabric-arbejdsområde, og start indgangspunktet for arbejdsbelastningen. Fabric indlæser din app i en iFrame og kalder dine DevServer-slutpunkter for at læse manifestdata.
  4. Rediger brugergrænseflade eller manifestfiler og opdater; ændringer træder i kraft med det samme uden ompakning.

For hvordan du starter hver proces, se vejledningen Getting Started-vejledningen og opsætningsguiden.

Relation til offentliggjorte manifester

I produktion pakkes og uploades din arbejdsbelastnings manifest som en del af din arbejdsbelastnings NuGet-pakke (se manifestoversigt). Under udviklingen fungerer DevServers lokale endepunkter som en letvægts-stand-in for de pakkede filer, så du hurtigt kan iterere:

  • Skema og regler er de samme som for publicerede manifester.
  • DevServeren påvirker kun lokal udvikling; Det ændrer ikke, hvordan udgivelse fungerer.

Tip til fejlfinding

  • Hvis iFrame viser en tom side, skal du bekræfte, at DevServer kører, og at frontend-slutpunktet i manifestet peger på den korrekte localhost-URL.
  • Hvis der mangler ikoner eller strenge, skal du kontrollere stierne assets , og at DevServer serverer disse filer under /assets.
  • Hvis Fabric ikke kan finde dine manifester, så verificér at /manifests ruten findes i din skabelon og returnerer gyldig JSON.

Se også

  • Last updated on