Synchroniser les modifications du fichier de spécification avec le code source généré

Vous pouvez utiliser la fonction de synchronisation pour apporter de nouvelles modifications du fichier de spécification aux fichiers source de code chaîne (modèle et contrôleur). La fonction fonctionne avec les projets TypeScript et Go.

Remarques :
  • La synchronisation est unidirectionnelle : vous pouvez apporter des modifications à partir de votre fichier de spécification dans votre projet de code chaîne, mais pas l'inverse. Les modifications apportées à votre projet de code chaîne restent inchangées après le processus de synchronisation.
  • La commande fonctionne uniquement si le projet de code chaîne a été échafaudé à l'aide d'un fichier de spécification. Ne supprimez, renommez ou déplacez pas le fichier de spécification si vous prévoyez de synchroniser les modifications du fichier de spécification vers le code source à l'avenir.
  • Lors de la synchronisation, les fichiers de code chaîne du dossier lib sont automatiquement mis à niveau. Si vous apportez des modifications à ces fichiers de bibliothèque, sauvegardez les fichiers modifiés ou suivez les modifications que vous apportez avant d'utiliser la fonction de synchronisation, afin de pouvoir les appliquer à nouveau après la synchronisation.
Pour synchroniser vos fichiers de spécification et de code chaîne :
  1. Dans le panneau Spécifications, sélectionnez le fichier de spécification que vous avez mis à jour pour ouvrir le panneau Détails de spécification correspondant. En haut du panneau, cliquez sur Code chaîne pour ouvrir le panneau indiquant les codes chaîne générés à partir du fichier de spécification.
  2. Cochez la case Synchroniser en regard de chaque code chaîne à mettre à jour avec les nouvelles modifications. Vous pouvez synchroniser plusieurs codes chaîne générés à partir d'un fichier de spécification à la fois. Cliquez sur Synchroniser.
Les projets de code chaîne contiennent désormais des fichiers mis à jour.

Résolution de conflits

Comme vous pouvez modifier à la fois les fichiers de synchronisation et les fichiers de code chaîne, il est possible de se retrouver avec des conflits où le fichier de spécification mis à jour pourrait écraser une modification que vous avez apportée au fichier de code chaîne. Dans ce cas, lorsque vous essayez de synchroniser une erreur s'affiche indiquant qu'il y a un conflit. Vous pouvez utiliser le panneau Conflits pour résoudre ces erreurs.

  1. Dans le panneau Conflits, cliquez sur le nom du fichier de code chaîne dans lequel les conflits existent. Le fichier s'ouvre dans un éditeur avec les conflits mis en évidence.
    Conflit de synchronisation affiché dans l'éditeur

    Dans l'exemple illustré, Marble124 se trouve dans le fichier de spécification et Marble123 dans le fichier de modèle de code chaîne.

  2. Au-dessus du conflit se trouve une liste d'options. Cliquez sur Accepter la modification en cours pour remplacer le fichier de spécification et utiliser ce qui se trouve actuellement dans le fichier de code chaîne. Cliquez sur Accepter la modification entrante pour remplacer le fichier de code chaîne et utiliser ce qui se trouve actuellement dans le fichier de spécification.
  3. Revenez au panneau Conflits. Cochez la case Synchroniser en regard du nom du conflit, puis cliquez sur Confirmer les modifications. Si vous avez plusieurs conflits, résolvez-les avant de cliquer sur Confirmer les modifications.