Partager via

DevServer avec Microsoft Fabric

DevServer est le serveur web local que vous exécutez lors du développement d’une charge de travail Fabric. Il sert votre serveur frontal (SPA) sur localhost et fournit un petit ensemble de points de terminaison HTTP que Fabric appelle pendant le développement pour récupérer vos manifestes produit et élément. Lorsqu'il est combiné avec DevGateway, Fabric peut charger l'interface de votre charge de travail dans un iFrame et lire vos données manifestes sans publier quoi que ce soit sur votre client.

Ce que fait DevServer

  • Héberge votre interface de charge de travail sur HTTP sur localhost (par exemple http://localhost:60006) afin que Fabric puisse le charger dans un iFrame.
  • Sert des ressources statiques référencées par vos manifestes (icônes, chaînes localisées, images).
  • Expose les points de terminaison JSON locaux que Fabric utilise pour lire vos manifestes pendant le développement.
  • Permet des cycles rapides d'édition et d'actualisation avec rechargement instantané dans la plupart des configurations.

Important

DevServer fonctionne avec DevGateway. DevGateway inscrit votre instance de charge de travail locale auprès de Fabric afin que le service sache à communiquer avec vos points de terminaison DevServer pendant que vous développez.

Où Fabric appelle le DevServer

Lorsque vous activez le mode de développement et démarrez à la fois votre DevGateway et DevServer :

  • Fabric accède à votre front-end via le point de terminaison frontal défini par votre manifeste de charge de travail (voir manifeste de charge de travail). En développement, cela pointe généralement vers une URL localhost exposée par le Serveur de développement.
  • Fabric interroge DevServer pour vos métadonnées orientées vers le produit afin qu'il puisse afficher la navigation, les vignettes et d'autres éléments d'expérience utilisateur pour votre charge de travail. Cela vous permet d’itérer sur Product.json et les manifestes d’élément sans reconstruire et charger un package.

Points de terminaison locaux que devServer fournit

Les itinéraires exacts peuvent varier selon le modèle, mais l’exemple de référentiel expose un petit ensemble de points de terminaison prédictibles :

  • GET / — retourne votre application web (UI Fabric se charge dans un iFrame).
  • GET /manifests : retourne un chargement JSON qui agrège votre manifeste de produit et les manifestes d’élément utilisés par l'interface utilisateur. Cela reflète la structure attendue par Fabric lors de la publication (consultez manifeste de produit et manifeste d’élément).
  • GET /assets/... : sert des icônes, des images et des chaînes localisées référencées par vos manifestes.

Note

  • CORS et en-têtes sont préconfigurés dans l’exemple DevServer afin que l’application puisse être incorporée et communiquer avec l’hôte.
  • Les noms de routage ci-dessus suivent l’exemple actuel ; consultez le fichier README de votre modèle si votre projet utilise un chemin différent pour le point de terminaison des manifestes.

Flux de développement classique

  1. Démarrez DevServer à partir de l’exemple de référentiel pour héberger votre front-end sur localhost.
  2. Démarrez DevGateway pour inscrire votre charge de travail locale auprès de Fabric.
  3. Ouvrez votre espace de travail Fabric et lancez le point d’entrée de la charge de travail ; Fabric charge votre application dans un iFrame et appelle vos points de terminaison DevServer pour lire les données de manifeste.
  4. Modifier l’interface utilisateur ou les fichiers manifestes et actualiser ; les modifications prennent effet immédiatement sans repackaging.

Pour savoir comment démarrer chaque processus, consultez le didacticiel De prise en main et le guide d’installation.

Relation avec les manifestes publiés

En production, les manifestes de votre charge de travail sont empaquetés et chargés dans le cadre du package NuGet de votre charge de travail (voir vue d’ensemble du manifeste). Pendant le développement, les points de terminaison locaux de DevServer agissent en tant que stand-in léger pour ces fichiers empaquetés afin de pouvoir effectuer une itération rapide :

  • Le schéma et les règles sont les mêmes que pour les manifestes publiés.
  • Le DevServer affecte uniquement le développement local. Il ne modifie pas le fonctionnement de la publication.

Conseils de dépannage

  • Si l’iFrame affiche une page vierge, vérifiez que DevServer est en cours d’exécution et que le point de terminaison frontal de votre manifeste pointe vers l’URL localhost correcte.
  • Si des icônes ou des chaînes sont manquantes, vérifiez les assets chemins d’accès et que DevServer sert ces fichiers sous /assets.
  • Si Fabric ne trouve pas vos manifestes, vérifiez que l’itinéraire /manifests existe dans votre modèle et retourne le json valide.

Voir aussi

  • Last updated on