Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Das DevGateway ist ein kleines Hilfsprogramm, das Sie während der Entwicklung ausführen, um Ihre lokale Workloadinstanz bei Fabric zu registrieren. Er teilt dem Fabric-Dienst mit, wo Ihr Frontend gehostet wird (Ihr DevServer auf localhost) und welche Elemente basierend auf Ihren Manifesten verfügbar sind. Wenn DevGateway läuft, kann Fabric Ihre Benutzeroberfläche in einem iFrame laden und Ihren lokalen DevServer aufrufen, um Produkt- und Artikelmetadaten zu lesen, ohne ein Paket für Ihren Mandanten zu veröffentlichen.
Funktionsweise des DevGateway
- Registriert eine lokale Workloadinstanz in einem bestimmten Arbeitsbereich für den aktuellen angemeldeten Entwickler.
- Informiert Fabric über Ihre Workload-Identität und deren Einstiegspunkt mithilfe Ihrer Manifeste.
- Leitet Fabric-Hostaufrufe an Ihre lokale Umgebung weiter, damit die Plattform Ihr Frontend laden und Elemente während des Iterierens identifizieren kann.
- Arbeitet Hand in Hand mit dem DevServer, der Ihr Frontend hostet und Manifestendpunkte bereitstellt.
Hinweis
Das DevGateway bedient Ihre Web-App oder Manifeste nicht selbst. Stattdessen registriert das System Ihre lokale Instanz und richtet Fabric auf Ihren DevServer und die Manifeste aus.
Wie Manifestdateien in der Entwicklung verwendet werden
Ihre Workload wird sowohl in der Entwicklung als auch in der Produktion manifestgesteuert. Während der Entwicklung:
- DevGateway verwendet Ihre lokale Konfiguration, um die Identität und Einstiegspunkte der Workload (wie im Workload-Manifest definiert) anzukündigen.
- Fabric ruft dann Ihren DevServer auf, um das Produktmanifest und die Elementmanifeste über lokale Endpunkte abzurufen (z. B. die Route der Vorlage
/manifests), damit der Dienst Navigation, Kacheln und Erstellungsfunktionen rendern kann.
Dies entspricht dem, was zur Veröffentlichungszeit passiert, bleibt jedoch alles lokal, um schnellere Iterationen zu ermöglichen.
Typischer Entwicklungsfluss
- Starten Sie Ihren DevServer, um das Frontend auf localhost zu hosten.
- Starten Sie devGateway, und melden Sie sich mit einem Benutzer an, der ein Administrator des Zielarbeitsbereichs ist.
- Öffnen Sie Ihren Fabric-Arbeitsbereich und verwenden Sie den Einstiegspunkt für die Arbeitslast. Fabric lädt Ihre Benutzeroberfläche in einem iFrame und ermittelt Elemente über Ihre Manifeste.
- Bearbeiten Sie UI- und Manifestdateien, aktualisieren Sie, um Änderungen sofort anzuzeigen.
Im Tutorial "Erste Schritte" finden Sie Schritt-für-Schritt-Anleitungen für die Einrichtung und Inbetriebnahme.
Konfigurationseingaben
Je nach Vorlage liest DevGateway eine lokale Konfiguration, die Folgendes umfasst:
- Zielarbeitsbereich für die Registrierung
- Lokaler Frontend-Endpunkt (Ihre DevServer-URL)
- Pfade oder Verweise auf Ihre Manifestdateien/Ressourcen, die während der Entwicklung verwendet werden
Die Setup-/Buildskripts Ihres Repositorys generieren oder aktualisieren diese Konfiguration automatisch, sodass DevGateway und DevServer synchronisiert bleiben.
Tipps zur Problembehandlung
- Wenn die Benutzeroberfläche nicht in Fabric geöffnet wird, stellen Sie sicher, dass Sie sowohl das DevGateway als auch den DevServer gestartet haben und dass Sie bei einem Arbeitsbereich angemeldet sind, in dem Sie über die erforderlichen Berechtigungen verfügen.
- Wenn Fabric keine Elemente ermitteln kann, bestätigen Sie, dass der Manifestendpunkt Ihres DevServer gültige JSON zurückgibt und Ihr DevGateway den Dienst auf die richtige localhost-URL verweist.
- Wenn Symbole oder Zeichenfolgen fehlen, überprüfen Sie die Ressourcenpfade in Ihren Manifesten, und stellen Sie sicher, dass Ihr DevServer sie bedient.