Comment disposer en permanence de la dernière version à jour du logiciel PhpGedView ?
Sommaire
Introduction
PhpGedView est un logiciel particulièrement vivant, puisque le rythme de sortie des nouvelles versions est un des plus rapides dans le monde du logiciel libre. La communauté des développeurs de PhpGedView est donc particulièrement dynamique et productive ! Chaque sortie officielle d’une nouvelle version de PhpGedView est signalée sur la page d’accueil de ce PGVWiki, et est représentée par une suite de 3 chiffres (par exemple la version 4.1.3). Chacune de ces versions contient le cœur du logiciel ainsi qu’une série de modules optionnels tels que par exemple, Googlemaps. Or, dans la réalité, une nouvelle version de PhpGedView n’apparaît pas brutalement de temps à autre : la version de PhpGedView vit tous les jours, au rythme des modifications apportées par l’équipe de développeurs.
Dans le contexte du projet PhpGedView, un dépôt central dit SVN (pour Subversion) enregistre et maintient tous les codes source du logiciel PhpGedView. Les développeurs de PhpGedView qui disposent d’un droit d’écriture au dépôt peuvent effectuer des modifications sur le code et les transférer dans le dépôt afin que tout le monde puisse voir ces modifications et en bénéficier.
Ainsi, la version 4.1.3 porte le numéro de révision 2223 daté du 19 novembre 2007 à 16h02 UTC. De même, la version 4.1 porte le numéro de révision 1399 daté du 6 août 2007 à 17h11 UTC. Au moment où j'écris ces lignes, le logiciel en est au numéro de révision 2436 du 24 décembre 2007 à 16h43 UTC. Ce numéro de révision est une partie de la future version officielle 4.1.4...
Ces versions « stables » sont placées dans le répertoire trunk du dépôt central SVN de PhpgedView.
Ce dépôt central est constitué de trois répertoires: le répertoire trunk, qui contient la dernière version stable de PhpGedView le répertoire branches, qui contient la prochaine version officiellle de PhpGedView. Attention, cette version est instable ! Il n'est donc pas recommandé de l'installer ! le répertoire tags, qui contient des copies du code source de PhpGedView à chaque fois qu'une version officielle sort. Ce répertoire contient donc les codes sources des versions antérieures: la 4.1.2, la 4.1.1, la 4.1, la 4.0, etc...
Structure des dépôts de PhpGedView
PhpGedView utilise la structure standard suivante pour déposer les différentes versions de son logiciel:
phpgedview/ | |___branches | |___tags | |___trunk
Vous pouvez parcourir le dépôt de PhpgedView en ligne, directement depuis la page d'accueil de Sourceforge, en cliquant dans la barre de menu sur Code --> Svn Browse:
[[Image: Site sourceforge svn browse.png | 250 px | center | thumbs | Cliquer sur l'image pour l'agrandir]
en vous connectant à cette adresse: [1]
Trunk (Le tronc)
Le répertoire trunk (tronc) contient la dernière version stable de PhpGedView qui prend en compte la résolution de tous les bugs qui ont été signalés depuis la sortie de dernière version officielle. La plupart des travaux de développement vers la prochaine version officielle sont placés dans une branche différente du répertoire trunk. Cela garantit ainsi la stabilité de la version présente dans le répertoire trunk, c’est pourquoi il vous est conseillé en tant que simple utilisateur (et non développeur) de PhpGedView, d’utiliser la dernière version qui a été déposée par les développeurs dans ce répertoire trunk. Les dépots autres que trunk, sont dédiés à l’usage exclusif des développeurs ou des utilisateurs qui sont prêts à tester une version de PhpGedView qui a encore beaucoup de bugs.
Si vous disposez d'un environnement Linux, vous pouvez vérifier le numéro de la dernière version de phpgedview présente dans le répertoire trunk, en tapant la commande suivante dans votre terminal:
svn checkout https://phpgedview.svn.sourceforge.net/svnroot/phpgedview/trunk/phpGedView phpgedview
Tags
Le répertoire tags contient des copies du code source à des instants spécifiques. Chaque fois qu’une sortie officielle d’une nouvelle version de PhpGedView est réalisée, le code est "taggé (marqué)" en copiant le code source présent dans le répertoire trunk dans un sous-répertoire renommé pour l’occasion, du répertoire tags. Ainsi, dans le sous-répertoire stable-4.1 du répertoire tags, se trouve le code source de la version 4.1 stable-4.1 tel qu’il était dans le répertoire trunk au moment de la sortie officielle de cette version 4.1.
Les données qui sont dans le répertoire tags directory shne doivent JAMAIS être modifiées !
Si vous disposez d'un environnement Linux, le code source de la version v4.1 de phpgedview peut être exploré dans le répertoire tags, en tapant la commande suivante dans votre terminal:
svn checkout https://phpgedview.svn.sourceforge.net/svnroot/phpgedview/tags/stable-4.1 phpgedview
Branches
Il existe une branche du dépôt de PhpGedView qui contient la prochaine version officielle de PhpGedView. C’est cette branche qui est utilisée par les développeurs du logiciel PhpGedView. Cette branche a été crée afin de préserver la stabilité du répertoire trunk, ceci afin de permettre au plus grand nombre d’utilisateurs, de bénéficier du code source de la dernière version stable de PhpGedView. Le code source de PhpGedView qui est présent dans le répertoire branches est instable, et peut donc ne pas fonctionner et contenir des fonctionnalités partiellement implémentées. A moins que vous ne soyez vous-même un développeur, vous n’avez a priori aucune raison d’aller chercher le code source dans ce répertoire branch.
Si vous disposez d'un environnement Linux, la branche qui est actuellement en phase de développement est la suivante [2] et elle peut être explorée dans le répertoire phpgedview en tapant la commande suivante dans votre terminal:
svn checkout https://phpgedview.svn.sourceforge.net/svnroot/phpgedview/branches/phpGedView phpgedview
Révisions
La dépôt SVN assure lui-même la maintenance de son numéro de révision interne. Cela est différent, et même souvent confus pour ceux qui sont familiers avec CVS dans la mesure où CVS assure la maintenance de numéros de version independants pour chacun des fichiers présents dans son répertoire.
A chaque fois qu’un développeur réalise une modification valide du code source, le numéro interne de révision de dépôt est automatiquement incrémenté. Chaque numéro de révision est effectivement un "tag" (identifiant) qui représente l’état du dépôt après chaque modification du code source. En fait, les numéros de révision peuvent être utilisés pour parcourir le dépôt (ou une partie du dépôt) à différents moments afin de récupérer le code source correspondant strictement au numéro de révision voulu.
Accès au dépôt
Pour pouvoir accéder au dépôt SVN, vous devez installer un logiciel client de Subversion – ces logiciels sont disponibles pour la plupart des systèmes d’exploitation existants : Windows, Linuw, Macintosh,... Le dépôt SVN de PhpGedView est hébergé à cette adresse SourceForge.
Seuls les développeurs qui disposent d’un droit d’écriture dans le dépôt peuvent effectuer des modifications sur le code source, toutes les autres personnes peuvent lire/explorer le code source présent dans le dépôt.
Subversion (SVN) est un logiciel de gestion de version (Version Control System : VCS). Il vous permet de suivre pas à pas toutes les modifications qui sont apportées à tout type de donnée informatique, comme par exemple les codes sources des programmes, les pages web. Subversion est actuellement une alternative au logiciel CVS, qui est également un projet open source (logiciel libre).
Comment utiliser Subversion ?
PARTIE 1
Installer un Client pour Windows
Il existe des logiciels fonctionnant sous Windows qui vous permettront de construire une réplique des fichiers présents dans les répertoires du dépôt central SVN de PhpGedView. Tortoise est l'un d'entre eux: il est facile d'utilisation et peut être téléchargé à cette adresse: http://tortoisesvn.tigris.org/. C'est l'utilisation de ce logiciel qui vous est présentée dans ce Wiki.
Bien que le logiciel Tortoise ne soit pas encore traduit en français, son installation est très simple. Voici l'écran d'accueil qui apparaît lorsque vous lancez le programme d'installation.
Cliquez sur Next> pour démarrer le processus d'installation.
Cliquez encore sur I accept the terms of the license agreement> sur l'écran suivant.
Puis cliquez sur "Install" pour lancer le processus d'installation.
Une fois que le processus d'installation est terminé, redémarrez votre ordinateur.
Les erreurs courantes avec SVN
Une erreur courante lors de la phase de vérification (checkout) d’un dépôt est la suivante:
svn: Can't convert string from 'UTF-8' to native encoding:
Cette erreur vient du fait que PhpGedView supporte certains langages qui utilisent des caractères qui ne sont pas reconnus par votre ordinateur personnel. Pour résoudre ce bug, il vous suffit de rendre votre ordinateur compatible avec le format d’encodage UTF-8. Sur les systèmes d’exploitation Linux, vous pouvez vérifier cette compatibilité en tapant depuis la ligne de commande suivante depuis votre terminal:
locale
Vous devez alors obtenir une suite d’instructions qui ressemblent à celles-ci et qui vous indiquent que votre ordinateur personnel ne supporte pas le format d’encodage UTF-8:
LANG=fr_FR LC_CTYPE=" fr_FR " LC_NUMERIC=" fr_FR " LC_TIME=" fr_FR " LC_COLLATE=" fr_FR " LC_MONETARY=" fr_FR " LC_MESSAGES=" fr_FR " LC_PAPER=" fr_FR " LC_NAME=" fr_FR " LC_ADDRESS=" fr_FR " LC_TELEPHONE=" fr_FR " LC_MEASUREMENT=" fr_FR " LC_IDENTIFICATION=" fr_FR " LC_ALL=
En tapant la commande suivante, vous pouvez ajouter le support d’encodage UTF-8:
export LANG= fr_FR.UTF-8
Liens externes
- Site officiel de SVN
- http://subversion.tigris.org/
- SVN sur Wikipedia
- Subversion_(software)
- Documentation en ligne de SVN
- http://svnbook.red-bean.com/
- Documentation de SVN sur SourceForge
- Version control for non-programmers with Subversion
- Command-line SVN client
- TortoiseSVN
- SVN
- Logiciels graphiques de SVN
- TortoiseSVN - Official website
- Subclipse - Official website for the Eclipse plugin
