Fr/FGAddon: Difference between revisions

Le hangar d'avion officiel '''FGAddon''' est un référentiel de gestion de versions contrôlée, hébergé sur [https://sourceforge.net/projects/flightgear/ l'infrastructure de FlightGear à SourceForge], utilisé pour le développement quotidien de l'aéronef.  FGAddon est un [https://en.wikipedia.org/wiki/Apache_Subversion référentiel de gestion de versions contrôlée Subversion].  Ce sont des avions qui ne font pas partie du logiciel de base - les avions de base se trouvent encore dans le référentiel de base [http://sourceforge.net/p/flightgear/fgdata/ci/next/tree/ FGDdata] - mais ils sont étiquetés avec chaque version stable pour les [http://www.flightgear.org/download/ pages de téléchargement de FlightGear].

Le référentiel de développement d'avions FGAddon devrait être considéré comme instable.  En cas d'utilisation une version FlightGear stable, il est préférable d'obtenir un avion avec un numéro de version correspondante directement des [http://www.flightgear.org/download/ pages de téléchargement de FlightGear].  Cependant, comme les versions stables dès FlightGear 3.4 sont étiqueté et présent dans le référentiel FGAddon, les outils de Subversion peuvent être un moyen pratique pour obtenir un avion particulier ou l'ensemble du hangar officielle d'environ 500 avions.  Aussi, en cas d'utilisation de [[FlightGear Build Server|la dernière version de nuit]] ou [[Building FlightGear|un version compilé de FlightGear à partir des référentiels de gestion de versions Git]], l'utilisation de FGAddon permet aux avions d'être actualisés à la dernière version de développement.

Le projet FlightGear a été conçu le 8 Avril, 1996 par David Murr qui a proposé un nouveau simulateur de vol pour être développé par des volontaires<ref>David Murr (Apr 9, 1996).  FlightGear proposition 1.0: [https://groups.google.com/forum/#!msg/rec.aviation.simulators/ny8HFBE5_T8/OdtIiGNGJc8J "A PROPOSAL FOR A NEW FLIGHT SIMULATOR - home built!@"].  Publié sur le newsgroup rec.aviation.simulators.</ref><ref>David Murr (1996).  FlightGear proposition 2.0: [http://www.flightgear.org/proposal-2.0 FLIGHT GEAR "This truly is as real as it gets!" - a proposal for a new flight simulator - REVISION 2.0]</ref><ref>David Murr (Oct 29, 1996).  FlightGear proposition 3.0: [http://www.flightgear.org/proposal-3.0 FLIGHT GEAR FLIGHT SIMULATOR, revision 3.0 - Wednesday, 10.30.96, "The future of flight simulation is here"].  Publié sur le [http://ftp.igh.cnrs.fr/pub/flightgear/www/old-stuff/flight-gear.9610 la liste de diffusion flight-gear@infoplane.com].</ref><ref>David Murr (Sep 11, 1998).  FlightGear proposition 3.0.1: [http://www.flightgear.org/proposal-3.0.1 FLIGHT GEAR FLIGHT SIMULATOR, revision 3.0.1 - Friday, Sep.11.98, "The future of flight simulation is here"]</ref>.  Une partie des objectifs initiaux étaient de développer des routines graphiques 2D et 3D pour le simulateur.  Mais au début de 1997 cette tâche énorme est venu à un arrêt inachevée car le développeur principal, Eric Korpela, rédigeait sa thèse de doctorat.  À ce point, Curtis Olson a relancé le développement le 16 mai 1997 avec un nouveau projet basé sur les bibliothèques graphique OpenGL, permettant de mettre en place un simulateur de vol fonctionnelle en peu de temps<ref>Curtis Olson (Sep 28, 2015).  [http://forum.flightgear.org/viewtopic.php?f=42&t=27558&p=259048#p259021 Re: A PROPOSAL FOR A NEW FLIGHT SIMULATOR - home built!@].  Publié sur le forum de FlightGear.</ref>.  Les premières commits étaient aux [[FlightGear CVS|référentiels de gestion de version CVS originaux de flightgear et simgear]].

Pendant la croissance du projet, la taille, quantité et qualité des ressources de FlightGear a augmenté ainsi.  Ces ressources n'étaient pas organisés et étaient dispersés à travers de différents lieux sur l'Internet.  Par conséquent, il a été décidé qu'une grande partie de ce contenu de FlightGear seraient assemblés et conservés ensemble dans un nouveau référentiel CVS centralisé appelé fgdata, créé le 22 Octobre 2000.  Pour permettre la redistribution légal de ces contenus dans le cadre de la distribution FlightGear, une politique d'exclusivité de GPLv2 a été adoptée.

En mai 2010, le développement a été interrompu par ''«l'incident de café»'' infâme résultant en la retraite du serveur à domicile de Curtis qui abritait tous les référentiels de gestion de versions de FlightGear<ref>James Turner (May 20, 2010). [http://thread.gmane.org/gmane.games.flightgear.devel/60340/focus=60341 <nowiki>[Flightgear-devel]</nowiki> Re: Flightgear git repositories (was Re: GIT or CVS - Confusion)] Publié sur la liste de diffusion flightgear-devel.</ref>.  Ces événements ont entraîné une [[FlightGear CVS|migration de masse de tous les référentiels CVS vers des référentiels Git]].  En raison de problèmes de bande passante, il a été décidé que les nouveaux dépôts seraient hébergés sur l'infrastructure open source de Gitorious.

En même temps que le projet a grandi, la taille et l'étendue du référentiel de fgdata a élargi lorsqu'une division était inévitable.  Une première tentative de séparation a été organisé par Gijs de Rooy et annoncée le 18 Octobre, 2011<ref>Cedric Sodhi (Oct 18, 2011) [http://thread.gmane.org/gmane.games.flightgear.devel/66846 <nowiki>[Flightgear-devel]</nowiki> FGData Split Completed - a.k.a Life after the Split] Publié sur la liste de diffusion flightgear-devel.</ref>.  Chaque aéronef a été placé dans son propre dépôt Git et tous les aéronefs lié à un nouveau référentiel fgdata-new en utilisant un démarche «Git submodule».  Cependant, cette tentative n'a pas fonctionné comme prévu et a été abandonné.  À partir de cette date jusqu'à la fin de 2014, la conception de la séparation de fgdata a été discutée sur la liste de diffusion de développement et résumée dans l'article de wiki [[FlightGear Git: splitting fgdata]].  Dans les étapes de planification, les référentiels étaient nommé comme la division de fgdata-old en [[FGData]] (aussi appelé fgdata-new) et FGAddon (aussi appelé flightgear-aircraft et fgaircraft).  Après une demi-décennie de planification, il a été décidé que la meilleure solution pour le développement d'aéronef FlightGear serait un seul référentiel de Subversion centralisé.  Cela faciliterait la gestion par la communauté et l'entretien de l'aéronef tout en fournissant en même temps la modularité, des téléchargements plus petits et un référentiel local de taille beaucoup plus réduite.

À la fin de 2014, Gitorious, le fournisseur de l'infrastructure open source pour les référentiels de code source et ressources de FlightGear a annoncé qu'il allait fermer ses services en mai 2015.  Cela a catalysé la scission de fgdata-old et un déménagement à l'infrastructure open source SourceForge pour l'hébergement des référentiels de gestion de version.  D'autres parties de l'infrastructure FlightGear été déjà hébergés par SourceForge, ainsi ce déménagement était un choix naturel.  Pour conclure l'affaire, SourceForge a accepté par écrit d'accueillir l'immense collection d'aéronefs de FlightGear, dont la taille est inégalée dans les cercles open source.  Aujourd'hui, le référentiel de SVN FGAddon, avec la plupart de l'infrastructure du projet FlightGear, est hébergé sur SourceForge.

Avec les outils SVN, le référentiel de gestion de versions FGAddon peuvent être un moyen commode pour obtenir les avions directement de la source officielle pour l'utilisation avec une version spécifique de FlightGear.  En utilisant la [[FlightGear Build Server|dernière version de nuit]] ou [[Building FlightGear|une copie compilé des référentiels FlightGear]], la version de développement plus récente de l'avion doivent être utilisés afin que tous les versions correspondent.  Veuillez noter que si les versions de FlightGear et d'aéronef FGAddon ne correspondent pas, les bogues étranges devraient être attendus et la mauvaise combinaison ne sera pas soutenue par la communauté de FlightGear.  Les sections suivantes décrit comment utiliser le référentiel officiel pour obtenir des avions et autres aéronefs au point de vue d'un utilisateur de FlightGear.

Pour utiliser le référentiel FGAddon, les outils de Subversion doivent être installés:

=== Structure du référentiel FGAddon ===

Pour savoir comment utiliser le référentiel FGAddon, une compréhension de la structure des répertoires du référentiel est essentielle.

[https://sourceforge.net/p/flightgear/fgaddon/HEAD/tree/ L'interface web pour le référentiel FGAddon] permet de parcourir tous les aéronefs.

Si tous les environ 500 aéronefs du référentiel sont souhaitées - faites attention que ce sera un énorme téléchargement de plus de 6 Go - utiliser la commande suivante:

Pour travailler avec la collection officielle d'aéronef, un [https://sourceforge.net/user/registration/ compte SourceForge] doit être configuré.  Cela permettra soit de faire un commit directement au référentiel FGAddon, si l'accès commit a été accordé, ou de travailler dans le cadre d'une équipe de développement à SourceForge.  Le processus d'inscription est très rapide et l'infrastructure de développeur et les services de développement sur SourceForge sera accessible en moins d'une minute.

Ces facile à surmonter obstacles sont tout simplement conçu pour la protection du référentiel contre la corruption ou contra la pollution avec un contenu illégal.  Pour avancer sur le chemin de l’accès commit, les modifications devraient d'abord être fournis sous forme de correctif (un patch).  Si ces correctifs ne sont pas trop gros, ils peuvent être joindre à un email envoyer à la liste de diffusion.  Mais viellez noter que des pièces jointes volumineuses impose une forte pression sur l'infrastructure open source.  Donc au lieu un [https://sourceforge.net/p/flightgear/codetickets/ code ticket] peut être créé et le patch attaché, ou le patch téléchargé sur un serveur public et un lien envoyé dans un message à la liste de diffusion de développement.

Pour suivre tous les changements dans le référentiel FGAddon, abonnez-vous à la [https://lists.sourceforge.net/lists/listinfo/flightgear-fgaddon-commitlogs liste de diffusion flightgear-fgaddon-commitlogs].  Un email est envoyé pour chaque commit, dès que la validation est faite.

Le hangar d'aéronefs FGAddon est maintenu dans un référentiel Subversion distant situé sur l'infrastructure SourceForge.  D'utiliser les outils de SVN pour le développement de l'aéronef est donc le moyen le plus simple.  Consultez la [[#Préparation|section d'installation de Subversion]] pour la mise en place de la chaîne d'outil.

==== Checkout du référentiel ====

La première étape consiste de faire un «checkout» (en français une extraction) pour obtenir une copie soit du <code>trunk</code> du référentiel ou l'un des aéronefs dans le <code>trunk</code>:  

Pour l'URL pertinentes, vous devez choisir l'un des [[#Scénarios de développement|scénarios de développement]] et cherchez pour l'URL dans la section correspondante.  Cette commande va créer un référentiel Subversion locale dans le dossier <code><dir></code> fourni.  Viellez noter que le dossier ne contiendra que la partie du référentiel FGAddon spécifié dans l'URL.  Cela signifie que Subversion vous permet de faire un «checkout», soit d'un seul fichier jusqu'aux totalité du référentiel distant.

De voir les informations sur le référentiel local à n'importe quel moment, tapez:

Pour voir l'histoire de la copie extraite du référentiel, tapez:

Cela va enregistrer le fichier ou le répertoire <code><chemin></code> avec le référentiel local pour permettre plus tard d'être «committed» et envoyé au référentiel distant.  Pour déplacer ou renommer un fichier ou répertoire, utilisez:

Cela doit être utilisé au lieu de le déplacer ou le renommer de la façon normale, afin que le changement est suivi dans le référentiel local.  Pour supprimer un fichier du référentiel local, tapez:

Pour voir l'état actuel du référentiel local, tapez:

Toutes les opérations ci-dessus on lieu seulement sur le référentiel local - le référentiel FGAddon distant à SourceForge ne saura rien de ces modifications.  Pour envoyer toutes les modifications à FGAddon, il faut faire un commit et valider les modifications:

=== Référentiel git du développeur ===

=== Envoi de changements de référentiel externe git dans FGAddon ===

=== Connexion d'un référentiel git existant à FGAddon ===

===== Mis en place du référentiel privée =====

===== Travailler avec le référentiel =====