Note du traducteur: pour des raisons techniques je n'ai pas pu reproduire ces étapes dans un environnement français, aussi j'ai laissé toutes les images de l'article original créé par Nonki Takahashi.

Cet article traite du Contrôle de Révision (ou Gestion du Versioning) avec le Small Basic. Le contrôle de révision est toujours utile, mais en particulier lorsque plusieurs développeurs travaillent sur le même projet.


Numéro de Révision dans le Program ID

Le Program ID est attribué lorsque vous {Publier] votre programme.  Son format est du type "xxxnnn", ou "x" est une lettre majuscule (sauf A, E, I, O, U, Y) et "n" est un chiffre entre 0 à 9.  Quand vous [Publier] après avoir [Importer], un nombre de révision en suffixe est ajouté de cette manière "xxxnnn-n". Le premier numéro de révision est -0.  Et celui qui suit -9 est -10.

Erreur de Publication

La taille d'un programme pouvant être publié est limité à 2500 lignes. Si le programme Small Basic est trop grand, l'erreur suivante apparaîtra lorsque vous {Publier]. Une des méthodes de contournement pour ce problème est de supprimer tous les commentaires et publier de nouveau. 

Essai Avancé avec des Outils de Contrôle de Révision

Les outils généraux de contrôle de révision ont cette capacité de comparer deux révisions de codes source. Par exemple, Git Gui détaillé dans la suite de cet article peut gérer tout type de code source, y compris ceux de Small Basic.  Git Gui enregistre les informations dans un dépôt local, mais il peut également le faire sur un dépôt distant. Pour les dépôts distants, il y a plusieurs services sur Internet. Cet article présentera CodePlex comme dépôt distant. 

Git Gui

Git a été développé comme une commande Linux pour gérer les révisons. Git Gui est l'interface graphique de la commande Git. 

Préparation du Dépôt Local

Pour préparer le dépôt locaux, nous allons suivre les instructions suivantes.

  1. Télécharger Git Gui en se rendant sur http://git-scm.com/downloads et en cliquant Windows.
  2. Cliquer sur le bouton [Exécuter] pour lancer l'installeur.
  3. Patienter jusqu'à la fin du téléchargement et que la vérification de sécurité soit terminée.
  4. Cliquer sur le bouton [Oui] pour autoriser que l'installeur s'exécute avec l'UAC (autorisation d'exécuter le programme comme administrateur).
  5. Cliquer sur [Next] dans l'Assistant de l'Installeur Git.
  6. Lire la licence et cliquer sur [Suivant].
  7. Cliquer sur [Suivant].
  8. Cliquer sur [Suivant].
  9. Cliquer sur [Suivant].
  10. Cliquer sur [Suivant].
  11. Cliquer sur [Suivant].
  12. Lire les notes de release et fermer WordPad.
  13. Depuis l'écran de démarrage de Windows (appuyer sur la touche Windows), allez dans l'écran Application et cliquer sur l'icône [Git GUI] pour lancer Git Gui.
  14. Cliquer sur le lien [Créer nouveau dépôt] pour créer un nouveau dépôt pour votre code source.
  15. Entrer le chemin complet de votre code source et cliquer sur [Naviguer] et sélectionner le dossier du code source. Et cliquer sur [Create].
  16. Maintenant vous pouvez voir la fenêtre principal de Git Gui. Il y a cinq boutons : [Recharger Modifs.], [Indexer Modifs.], [Signer], [Commiter] et [Pousser]. Ces cinq fonctions sont les fonctions principales de cet outil.
  17. Sélectionner le menu [Edition] > [Options], entrer votre nom, adresse email, et sélectionner "utf-8" pour "Codage du contenu des fichiers par défaut" et cliquer sur [Sauvegarder].

Recharger Modifs

Une fois que vous avez modifier et enregistrer votre code source dans l'EDI Small Basic, cliquer sur [Recharger Modifs.] pour actualiser les informations et que Git Gui puisse reconnaître les nouveaux fichiers. Les fichiers modifiés sont affichés la liste [Modifs. non indexés]. Cette action n'est pas nécessaire la première fois juste après avoir créé le nouveau dépôt. 

Indexer modifs

Maintenant cliquer sur [Indexer modifs.] pour sélectionner les fichiers avec lesquels Git Gui va mettre à jour le dépôt. Si vous obtenez la boite de dialogue suivante, cliquer sur [Oui]. Maintenant les fichiers sont déplacés dans la liste [Modifs indexées].

Signer

Entrer les commentaires concernant cette révision (ou version) dans la zone de saisie en bas à droite, et cliquer sur [Signer] pour ajouter le message de signature après les commentaires.

Commiter

Cliquer sur [Commiter] pour synchroniser les fichiers indexés avec le dépôt local. Une fois commités, les fichiers qui se trouvaient dans [Modifs. indexées] ainsi que les commentaires disparaissent.  

Visualiser l'Historique

En sélectionnant le menu [Dépôt] > [Voir l'historique de la branche : master], vous pouvez vérifier l'historique de vos révisions dans le dépôt.

Préparation pour le Dépôt Distant

Avant de suivre les instructions, vous devez configurer un dépôt distant avec CodePlex ou GitHub.

Cloner

Sélectionner [Clôner un dépôt existant] pour récupérer le dépôt distant dans le dépôt local.

Entrer l'emplacement du dépôt distant [Emplacement Source]. Entrer le dossier de destination dans [Répertoire cible] ou cliquer sur [Naviguer] et sélectionner le dossier. Ensuite cliquer sur [Cloner].

Fusionner

Sélectionner le menu [Fusionner] > [Fusion Locale] pour fusionner le dépôt distant dans le dépôt local. Cette action n'est pas nécessaire la première fois après avoir cloné le dépôt.

Pousser

Cliquer sur [Pousser] pour appliquer les modifications locales au dépôt distant.

CodePlex

CodePlex est le site d'hébergement de projet open source de Microsoft. Vous pouvez créer votre dépôt distant sur ce site. Le site de listing de programme Small Basic program à des limitations de téléchargement qui sont:

  • La taille maximale du code source est de 2500 lignes.
  • Les lignes avec l'objet File sont commentées.
  • Certaines constantes texte (comme "<" et ">") ne sont pas affichés correctement.

Mais CodePlex n'a pas ces limitations.  Visiter https://www.codeplex.com/ avec votre navigateur.

Préparation

Ces instructions ne sont nécessaire que la première fois. 

  1. Sélectionner le lien [Register] dans la barre du haut, et choisissez [Microsoft account].
  2. S'enregistrer avec votre compte Microsoft.
  3. Vous arrivez sur votre page CodePlex.

Cloner depuis un Distant

Le projet suivant est un exemple de programme Small Basic  L'URL est https://smallsvgeditor.codeplex.com/ .

Sélectionner [SOURCE CODE].

Sélectionner [Clone]. Vous pouvez obtenir une URL pour télécharger le dépôt distant dans le local. C'est ce que l'on saisit dans Emplacement Source de Git Gui.

Les Autres Fonctions de CodePlex

CodePlex possède les fonctions utiles suivantes. Elles permettent d'aider les équipes de programmation.

  • Documentation
  • Discussions
  • Problèmes

Voir Aussi


Autres Langues