Installer l'environnement

Prérequis, installation de Unity et configuration du projet pour les nouveaux développeurs.

Prérequis

Installe ces outils avant de cloner le dépôt.

[!IMPORTANT] Le projet utilise Git LFS pour tous les fichiers binaires (.png, .fbx, .wav, .unity, .prefab, .asset, etc.). Sans Git LFS installé et activé, tu cloneras uniquement des pointeurs vides — le projet ne s’ouvrira pas correctement dans Unity.

[!WARNING] N’ouvre jamais le projet directement depuis l’explorateur de fichiers. Utilise Unity Hub exclusivement pour éviter les conflits de version.

1. Installer Git LFS

Lance cette commande une seule fois sur ta machine pour activer Git LFS globalement :

git lfs install

Vérifie l’installation :

git lfs version
# → git-lfs/x.x.x (GitHub; ...)

2. Cloner le dépôt

git clone https://github.com/CogniActif/Cogni-Actif-dss.git

Git LFS télécharge automatiquement tous les fichiers binaires pendant le clone. Selon ta connexion et la taille du dépôt, cela peut prendre plusieurs minutes.

Si le clone s’est fait avant l’installation de Git LFS, force le téléchargement des fichiers LFS :

cd Cogni-Actif-dss
git lfs pull

Structure du dépôt

Cogni-Actif-dss/
├── Unity/
│   └── Cogni-Actif-IT3/     ← dossier à ouvrir dans Unity Hub
├── scripts/
└── .gitattributes           ← définit les types de fichiers gérés par LFS

3. Installer Unity 2022.3.62f3 LTS

1. Ouvre Unity Hub
2. Va dans Installs → Install Editor
3. Cherche la version 2022.3.62f3

[!NOTE] Si la version exacte n’apparaît pas dans la liste, utilise l’onglet Archive ou le lien de téléchargement direct depuis unity.com/releases/editor/archive.

4. Ouvrir le projet dans Unity

1. Dans Unity Hub, clique sur Add → Add project from disk
2. Sélectionne le dossier Unity/Cogni-Actif-IT3/
3. Unity Hub détecte automatiquement la version 2022.3.62f3
4. Clique sur le projet pour l’ouvrir

Le premier chargement compile tous les scripts et importe les assets — prévoir 5 à 15 minutes selon la machine.

5. Packages

Tous les packages sont déclarés dans Packages/manifest.json. Unity les télécharge automatiquement à l’ouverture. Aucune action manuelle requise.

Le SDK PlayFab est inclus directement dans Assets/Packages/Outils/PlayFab/ — il est géré par Git LFS et ne nécessite pas d’installation séparée. Le Title ID est déjà configuré dans le projet (PlayFabSharedSettings.asset).

6. Paramètres éditeur à conserver

[!IMPORTANT] Ces paramètres sont critiques pour que les .meta files soient correctement versionnés par Git. Ne les modifie pas.

Vérifie dans Edit → Project Settings → Editor :

7. Vérifier l’installation

1. Dans la fenêtre Project, ouvre Assets/Scenes/MenuDeConnexion.unity
2. Appuie sur Play
3. L’écran de connexion doit s’afficher sans erreurs dans la Console

[!TIP] Si des erreurs rouges apparaissent dans la Console au premier lancement, tente Assets → Reimport All. Ce processus peut prendre quelques minutes mais résout la majorité des problèmes liés à une importation incomplète.

Règles de contribution

• Travaille sur une branche dédiée — jamais directement sur main
• Ne modifie pas ProjectSettings/ProjectVersion.txt ni les fichiers de Packages/ sans décision d’équipe
• Crée une Pull Request sur GitHub pour toute modification à fusionner