Utilisation du gestionnaire de versions Subversion
Mohamed Lokbani
1.00
1 Survol SVN
• Histoire : créé en 2000 dans un effort de confectionner un gestionnaire de versions, logiciel gratuit à code source ouvert (« open source »)
• Gestionnaire de versions (Gestionnaire de revisions, gestionnaire de sources) : logiciel permettant de gérer les modifications de documents, programme informatique, la majorité des types d’information
2 Termes
• Repository (dépôt) : base de données conservant les fichiers
• Client : L’ordinateur exécutant les commandes (vous en l’occurrence)
• Working Copy : répertoire local sur lequel vous travaillez et effectuez des modifications
• Trunk/Main : endroit principal où le code se trouve dans le dépôt
• Revision : la version courante du fichier sur lequel l’on travaille
• Head : la dernière revision dans le dépôt
• Changelog : Liste des changements apportés aux fichiers
• Revert : écrase les modifications de la copie de travail par la dernière version enregistrée dans le dépôt
4 Subversion (SVN)
• Logiciel de gestion de versions
• Disponibles en ligne de commande ou sous la forme d’application
• Parmi les applications pour Windows : Tortoise SVN ou Visual SVN https://tortoisesvn.net/downloads.html
https://www.visualsvn.com/downloads/
5 Intégration dans Android Studio
5.1 Activer le gestionnaire de versionDans le menu, cliquer sur “VCS”, puis “Enable Version Control Integration”, puis choisir “Subversion”, puis cliquer sur “OK”.
5.2 Dépôt SVN du DIRO
Ouvrir un navigateur et fournir l’URL “https://subversion.iro.umontreal.ca/ift1155/IFT1155_H19_x yz / ” où “xyz” est votre login au DIRO.
Votre navigateur web vous demandera alors vos identifiants de connexion. Ceux-ci se trouvent sur le papier qui vous a été remis sous cette forme : xxxxxxxx:yyyyyyy
Si la connexion a réussi, vous allez obtenir une page sous cette forme (en supposant que le dépôt est vide):
5.3 Intégration du dépôt SVN dans Android Studio
Dans le menu, cliquer sur “VCS”, puis “Checkout from Version Control”, puis choisir “Subversion”. Vous allez obtenir cette fenêtre:
Cliquer sur “+” pour ajouter l’adresse de votre dépôt, puis cliquer sur “OK”:
Sélectionner le dépôt et cliquer sur “Checkout”:
Sélectionner le répertoire de “Checkout”, le nom de votre projet. Dans cet exemple, je vais prendre le projet “Localization”, puis cliquer sur “OK”:
Il n’est pas nécessaire de cliquer sur les options par défaut fournies, cliquer sur “OK”:
Vous allez obtenir cette fenêtre, cliquer sur “OK”:
Il vous sera demandé votre nom d’utilisateur et votre mot de passe:
Il s’agit des informations fournies dans la séance de cours et que vous avez testées à l’aide d’un navigateur dans l’étape 5.2. Par la suite, cliquer sur “OK”.
Vous allez obtenir cette fenêtre, cliquer sur “Yes” si le projet n’est pas déjà ouvert.
La couleur associée à chaque fichier permet de connaitre son état. Ainsi:
- Brun : le fichier n’est pas suivi par le gestionnaire
- Bleu : le fichier a été modifié, mais pas encore “commit” (soumis) - Vert : le fichier a été ajouté au gestionnaire
- Noir : le fichier est à jour
5.4 Avant d’ajouter le projet au dépôt, nous allons commencer par configurer Android Studio afin d’ignorer certains fichiers du projet. Ces fichiers sont générés automatiquement, ils ne sont pas nécessaires. Android Studio va les régénérer à la demande. Les répertoires et fichiers à ignorer sont:
build/
app/build/
.gradle/
.idea/libraries/
.idea/workspace.xml local.properties
Dans “File”, “Settings”, “Version Control”, “Ignored Files”, cliquer sur le signe “+”:
Vous allez obtenir cette fenêtre:
Sélectionner les fichiers et répertoires à ignorer:
5.5 Nous allons maintenant ajouter les fichiers à inclure dans le système de suivi Subversion. Cliquer avec le bouton droit de la souris sur
“app”, “Subversion”, “Commit Directory”
Finalement, nous obtenons cette fenêtre:
Il se peut que vous obteniez cette fenêtre signalant des problèmes avec quelques fichiers.
Il est suggéré de cliquer sur “review” pour prendre connaissance:
Un problème avec l’encodage d’un fichier, un autre avec un mot qui n’a pas été traduit.
En cliquant sur “Commit”, on remarque ce qui suit dans la fenêtre principale d’Android Studio
Fournir votre nom d’utilisateur et votre mot de passe, s’ils n’ont pas été mémorisés à l’étape xxx
Si tout s’est bien déroulé, vous allez voir ce message:
Connecter à la page web, mentionnée à l’étape 5.2, et constater la présence des fichiers: