Utiliser le fichier .gitignore

Effectué

Lorsque vous utilisez un système de contrôle de version, vous pouvez ne pas souhaiter stocker tous les fichiers dans Git. Pour Business Central, nous pouvons laisser les différents fichiers .app et certains fichiers .json hors du système de contrôle de version.

  • Fichiers de symboles : ces fichiers dépendent de la version sur laquelle vous effectuez le déploiement. Il est préférable de télécharger les fichiers de symboles depuis Visual Studio Code lorsque vous travaillez sur l’extension.

  • Launch.json : ce fichier contient les informations sur le serveur que vous utilisez en tant que développeur lors de votre développement pour déployer et tester votre extension. Il s’agit souvent d’une image Docker exécutée sur votre propre ordinateur et différente pour chaque développeur. Ce fichier ne doit pas être ajouté au contrôle de code source et doit être généré sur la machine du développeur.

  • Rad.json : ce fichier contenant une liste de fichiers modifiés depuis la modification précédente permet le développement rapide d’applications et accélère le déploiement lors du développement. Ce fichier est différent pour chaque développeur et évolue constamment. Il est recommandé de ne pas inclure ce fichier dans Git.

  • Fichier d’application .app : le résultat d’une build dans Visual Studio Code est un fichier .app de votre extension. Ce fichier .app est recréé avec chaque build et ne doit pas être inclus dans Git. Un pipeline de build (et éventuellement de mise en production) crée un fichier .app dans Azure DevOps.

Pour indiquer les fichiers à inclure et ceux à exclure, vous pouvez créer un fichier .gitignore. Ce fichier est un fichier texte contenant une liste de fichiers à exclure. Vous pouvez également spécifier un répertoire ou des fichiers avec une extension de fichier spécifique.

Le moyen le plus simple de créer ce fichier ou d’ajouter une entrée à ce fichier consiste à utiliser la fonctionnalité intégrée de Visual Studio Code.

  1. Sélectionnez Afficher dans le menu, puis SCM (Ctrl+Maj+G).

  2. Dans l’Explorateur du contrôle de code source, vous pouvez cliquer avec le bouton droit sur un fichier, puis sélectionner Ajouter à .gitignore.

    Capture d’écran de l’option Ajouter à .gitignore du menu contextuel.

Pour ignorer tous les fichiers .app (ou uniquement ceux dans .alpackages), vous pouvez utiliser les entrées suivantes :

*.app ou .alpackages/*.app