Exercice : contrôle de code source avec Git
Cet exercice utilise l’exemple de société Cronus à partir de la version américaine de Business Central. Vous devrez peut-être adapter les étapes si vous utilisez l’exemple de société pour votre pays ou région.
Scénario
Vous travaillez pour CRONUS International Ltd en tant que développeur. Vous souhaitez créer une extension AL, l’ajouter au contrôle de version avec Git et sauvegarder le code dans Azure Repos.
Tâches
Créer une extension AL
Ajouter le code source à un référentiel Git local
Ajouter Azure Repos en tant que référentiel Git distant
Transmettre le référentiel Git existant au référentiel distant
Étapes
Démarrez Visual Studio Code.
Sélectionnez Afficher>Extensions (Ctrl+Maj+X).
Saisissez AL Language dans la zone de recherche Rechercher des extensions dans Marketplace.
Sélectionnez le bouton vert Installer.
Créez un projet d’extension AL. Sélectionnez Afficher>Palette de commandes... (Ctrl+Maj+P).
Saisissez AL: Go! dans la zone de recherche, puis sélectionnez la commande dans la liste.
Acceptez le chemin suggéré (ou saisissez un chemin différent).
Sélectionnez la plateforme cible la plus récente.
Sélectionnez Bac à sable cloud Microsoft comme point de terminaison de développement.
Téléchargez les symboles d’application en sélectionnant Afficher>Palette de commandes... (Ctrl + Maj + P).
Saisissez AL: Download symbols dans la zone de recherche, puis sélectionnez la commande dans la liste.
Si vous y êtes invité, fournissez vos informations d’identification professionnelles (compte Microsoft 365/compte Microsoft Entra ID).
Ouvrez le fichier App.json et redéfinissez le paramètre name sur Hello Business Central. Redéfinissez le paramètre publisher sur Cronus International Ltd.
Installez Git (si ce n’est pas encore fait) sur la page Installation de Git.
Dans Visual Studio Code, cliquez sur Afficher>SCM (Ctrl + Maj + G) pour ouvrir la vue Contrôle de code source.
Cliquez sur le bouton Initialiser le référentiel afin d’initialiser un référentiel local pour l’extension AL actuelle.
Vos fichiers sont maintenant affichés avec le statut U à la fin, qui correspond à « Untracked » (Non suivi). Cliquez avec le bouton droit sur le premier fichier .app et sélectionnez ajouter à .gitignore. Vous pouvez effectuer cette étape uniquement dans la vue Contrôle de code source, pas dans la vue Explorateur.
Répétez ce processus pour chaque fichier .app et pour le fichier launch.json.
Sélectionnez tous les fichiers, faites un clic droit et sélectionnez Changements d’étape ou cliquez sur l’icône + en regard de Changements. Cette action entraîne l’ajout des fichiers à la zone intermédiaire.
Ajoutez le message Validation initiale dans la zone de message de validation, puis cliquez sur le bouton de validation (le bouton représentant une coche) ou appuyez sur Ctrl + Entrée
Dans votre navigateur web préféré ouvrez votre organisation Azure DevOps.
Sélectionnez le projet Hello Business Central, si vous l’avez créé à partir de la démonstration vidéo, ou créez un projet si celui-ci n’est pas disponible.
Sélectionnez Repos dans le menu gauche. Vous voyez que le référentiel est vide et que vous pouvez y ajouter du code.
Copiez le lien https que vous trouverez dans la section Cloner sur votre ordinateur.
Ouvrez Visual Studio Code, appuyez sur F1 et saisissez Git: Add Remote... dans la zone de recherche.
Saisissez un nom distant : origine
Collez l’URL que vous avez copiée à partir d’Azure Repos dans la zone URL distante.
En fonction de votre configuration, Visual Studio Code vous invite à vous connecter à Azure DevOps avec votre compte Microsoft/professionnel. Si cela ne fonctionne pas et si Visual Studio Code vous demande toujours de vous connecter avec un nom d’utilisateur et un mot de passe, vous pouvez retourner dans Azure DevOps et cliquer sur le bouton Générer des informations d’identification Git sous la zone de saisie où vous avez copié l’URL du référentiel. Cela vous permet de copier un nom d’utilisateur et un mot de passe que vous pouvez utiliser pour Git au lieu de votre compte standard.
Si le référentiel distant est correctement lié dans Visual Studio Code, vous pouvez cliquer sur l’icône Publier, en bas de votre fenêtre Visual Studio Code à gauche. Ce bouton représente une icône de nuage avec une flèche vers le haut. Il est situé en regard du bouton de la branche principale.
Cette opération permet de publier votre code local dans Azure Repos.
Ouvrez Azure DevOps et actualisez la page. Votre code devrait être visible.
Dans Visual Studio Code, ouvrez le fichier HelloWorld.al déposer et modifiez Hello World dans Hello Business Central dans la fonction Message. Enregistrez vos modifications (Ctrl+S).
Ouvrez votre vue de contrôle de code source. Le fichier HelloWorld.al doit être visible tel qu’il a été modifié. Sélectionnez le fichier et ajoutez-le à la zone intermédiaire.
Ajoutez un message de validation et cliquez sur le bouton de validation.
Maintenant, transmettez vos modifications au référentiel distant. Vous pouvez cliquer sur les trois points ... pour ouvrir un menu et sélectionner push. Vous pouvez également cliquer sur l’icône de synchronisation en bas de la fenêtre (même emplacement où vous avez cliqué sur l’icône de publication). La synchronisation est alors effectuée. Par conséquent, une fenêtre s’ouvre indiquant que cette action effectue une extraction et une transmission push. Vous pouvez accepter en cliquant sur Oui.
Ouvrez Azure DevOps, actualisez la page et sélectionnez le fichier HelloWorld.al. Vos modifications doivent être visibles.