Up to date
This page is up to date for Godot 4.3.
If you still find outdated information, please open an issue.
Systèmes de contrôle de version
Introduction
Godot vise la compatibilité avec les logiciels de gestion de version et à générer des fichiers relativement lisibles et faciles à fusionner.
Extensions de contrôle de version
Godot prend également en charge l'utilisation de systèmes de contrôle de version (SCV) dans l'éditeur lui-même. Cependant, utiliser un SCV dans l'éditeur nécessite un plugin pour le SCV spécifique que vous utilisez.
En date de juillet 2023 seul un greffon Git est disponible, mais la communauté pourrait créer des greffons pour d'autres logiciels de gestion de version.
Plugin Git officiel
L'utilisation de Git depuis l'intérieur de l'éditeur est prise en charge avec un plugin officiel. Vous pouvez trouver les dernières versions `sur GitHun<https://github.com/godotengine/godot-git-plugin/releases>`__.
La documentation sur comment utiliser le plugin Git peut être trouvée à l'adresse wiki.
Fichiers à exclure du VCS
Note
Cela liste les fichiers et dossiers à ignorer par la gestion des versions dans Godot 4.1 et suivants.
La liste des fichiers et dossiers à ignorer de la gestion des version dans Godot 3.x et Godot 4.0 est totalement différente. C'est important car Godot 3.x et 4.0 pourraient stocker des identifiants sensibles dans export_presets.cfg (contrairement à Godot 4.1 et suivants).
Si vous utilisez Godot 3, regardez la version 3.5 de cette page de la documentation à la place.
Certains fichiers et dossiers sont créés automatiquement par Godot à la première ouverture d'un projet dans l'éditeur. Pour éviter de polluer votre dépôt avec des données générées, vous devriez les ajouter dans les exclusions de votre gestion de version :
.godot/: Ce dossier stocke de nombreuse données de caches du projet.*.translation: Ces fichiers sont importés en binaire traductions, générées à partir de fichiers CSV.
Le gestionnaire de projets de Godot peut générer pour vous, automatiquement, les métadonnées de votre gestion de versions lors de la création d'un projet. Lorsque vous choisissez l'option Git, cela crée les fichiers .gitignore et .gitattributes dans la racine du projet :
Création des métadonnées de gestion de version dans la fenêtre Nouveau Projet du gestionnaire de projets
Dans les projets existants, sélectionnez le menu Project en haut de l'éditeur, puis choisissez Contrôle de version > Générer les métadonnées de contrôle de version. Cela crée les mêmes fichiers que si l'opération avait été effectuée dans le gestionnaire de projet.
Travailler avec Git sous Windows
La plupart des clients Git pour Windows sont configurés avec le paramètre core.autocrlf réglé sur true. Cela peut conduire à ce que des fichiers soient inutilement marqués comme modifiés par Git, car leurs fins de ligne sont converties automatiquement de LF à CRLF.
Il est préférable de définir cette option comme :
git config --global core.autocrlf input
La création de métadonnées de contrôle de la version à l'aide du gestionnaire de projet ou de l'éditeur fera automatiquement appliquer les terminaisons de ligne LF en utilisant le fichier .gitattributes. Dans ce cas, vous n'avez pas besoin de changer votre configuration Git.