Udostępnij przez


Usługa DevGateway z usługą Microsoft Fabric

Usługa DevGateway to mały pomocnik uruchamiany podczas programowania w celu zarejestrowania lokalnego wystąpienia obciążenia w usłudze Fabric. Informuje usługę Fabryka, gdzie jest hostowany frontend (DevServer na localhost) i które elementy są dostępne na podstawie manifestów. Po uruchomieniu DevGateway, Fabric może załadować interfejs użytkownika w elemencie iFrame i wywołać lokalny DevServer, aby odczytać metadane produktu i elementu — bez publikowania pakietu u dzierżawcy.

Co robi usługa DevGateway

  • Rejestruje lokalne wystąpienie obciążenia w określonym obszarze roboczym dla bieżącego zalogowanego dewelopera.
  • Informuje Fabric o tożsamości zadania i punkcie wejścia za pomocą manifestów.
  • Przekierowuje wywołania hosta Fabric do środowiska lokalnego, aby platforma mogła ładować frontend i odnajdywać elementy podczas iteracji.
  • Ściśle współpracuje z serwerem DevServer, który faktycznie hostuje frontend i udostępnia punkty końcowe manifestu.

Uwaga / Notatka

Usługa DevGateway nie obsługuje Twojej aplikacji internetowej ani nie manifestuje się. Zamiast tego rejestruje twoje lokalne wystąpienie i wskazuje Fabric na twój DevServer oraz manifesty.

Jak używa manifestów podczas programowania

Praca jest napędzana przez manifest zarówno w środowisku deweloperskim, jak i produkcyjnym. Podczas opracowywania:

  • Usługa DevGateway używa lokalnej konfiguracji do udostępniania tożsamości i punktów wejścia zadań (zgodnie z definicją w manifeście zadań).
  • Fabric następnie wywołuje Twój DevServer, aby pobrać manifest produktu i manifesty elementów za pośrednictwem lokalnych punktów końcowych (na przykład trasy szablonu /manifests), aby usługa mogła renderować nawigację, kafelki i interfejsy tworzenia.

Odzwierciedla to, co dzieje się w momencie publikacji, ale wszystko pozostaje lokalnie, co pozwala na szybkie iteracje.

Typowy przepływ programowania

  1. Uruchom serwer DevServer, aby hostować fronton na hoście lokalnym.
  2. Uruchom usługę DevGateway i zaloguj się przy użyciu użytkownika, który jest administratorem docelowego obszaru roboczego.
  3. Otwórz obszar roboczy Fabric i użyj punktu wejścia dla obciążenia; Fabric ładuje interfejs użytkownika w elemencie iFrame i odnajduje elementy poprzez manifesty.
  4. Edytuj interfejs użytkownika i pliki manifestu, odśwież, aby natychmiast zobaczyć zmiany.

Zobacz samouczek Wprowadzenie , aby uzyskać instrukcje krok po kroku dotyczące konfigurowania i uruchamiania.

Parametry konfiguracji

W zależności od szablonu usługa DevGateway odczytuje lokalną konfigurację obejmującą następujące elementy:

  • Docelowy obszar roboczy do rejestracji
  • Lokalny punkt końcowy frontonu (adres URL serwera DevServer)
  • Ścieżki lub odwołania do plików manifestu/zasobów używanych podczas programowania

Skrypty instalacji/kompilacji repozytorium generują lub aktualizują tę konfigurację automatycznie, aby usługa DevGateway i DevServer pozostawały zsynchronizowane.

Wskazówki dotyczące rozwiązywania problemów

  • Jeśli interfejs użytkownika nie jest otwarty w usłudze Fabric, upewnij się, że uruchomiono zarówno usługę DevGateway, jak i serwer DevServer, i że zalogowaliśmy się do obszaru roboczego, w którym masz wymagane uprawnienia.
  • Jeśli sieć szkieletowa nie może odnaleźć elementów, upewnij się, że punkt końcowy manifestów serwera DevServer zwraca prawidłowy kod JSON, a usługa DevGateway wskazuje usługę na poprawny adres URL hosta lokalnego.
  • Jeśli brakuje ikon lub ciągów, sprawdź ścieżki zasobów w manifeście i czy serwer DevServer je obsługuje.

Zobacz także