Configuration de Unity — PC du site de Brest

Préparer Unity et l’éditeur C# sur les postes de l’école avant les TP.

Unity Hub et Unity 6.3 LTS

Sur les machines de l’école, lancez Unity Hub depuis le menu des applications (sur Linux : Applications > Développement > Unity Hub, selon le poste). Connectez-vous à votre compte Unity ; créez-en un si nécessaire et suivez les indications de licence du poste.

Dans Installs, utilisez Unity 6.3 LTS, déjà installé. Son numéro commence par 6000.3 ; gardez le patch installé pour le TP.

Si l’installation n’est pas répertoriée, utilisez Locate et sélectionnez l’exécutable Editor/Unity de l’installation 6.3 présente sur le poste. Le chemin exact dépend de la configuration de l’école : demandez-le à l’enseignant si nécessaire. L’ancien chemin /opt/img/Unity-2021.3.9f1/Editor/Unity ne correspond plus à la version du cours.

Créez le projet avec Universal 3D (URP). Dans Window > Package Management > Package Manager, préparez l’Input System, Unity UI et les dépendances du contrôleur FPS pendant la séance. Dans Edit > Project Settings > Player > Other Settings > Configuration, choisissez Active Input Handling = Input System Package (New) si ce réglage n’est pas déjà sélectionné, puis acceptez le redémarrage demandé.

Pour exporter, le module de build de la plateforme du poste doit être installé. S’il manque, signalez-le à l’enseignant ; Unity Hub > Installs > menu de l’installation > Add modules permet de l’ajouter lorsque les droits du poste le permettent.

Visual Studio Code (éditeur C#)

L’intégration actuelle repose sur l’extension Unity publiée par Microsoft dans VS Code. Elle installe les dépendances C# nécessaires, dont C# Dev Kit. Dans le Package Manager de Unity, utilisez Visual Studio Editor, en version stable proposée pour l’éditeur et au minimum 2.0.20. L’ancien package Visual Studio Code Editor n’est plus maintenu. Instructions Microsoft.

Pour ouvrir les scripts dans VS Code :

  1. Dans Unity, ouvrez Edit > Preferences > External Tools (sur macOS, les préférences se trouvent dans le menu Unity).
  2. Dans External Script Editor, choisissez Visual Studio Code ou utilisez Browse…. Sur les postes Linux où il est installé à cet emplacement, l’exécutable est /usr/bin/code.
  3. Régénérez les fichiers de projet avec Regenerate project files, si nécessaire, puis ouvrez un script depuis Unity pour charger le projet complet dans VS Code.

En cas de problème d’auto-complétion

  • Vérifiez que les extensions Microsoft Unity, C# et C# Dev Kit sont actives et que le package Visual Studio Editor est installé.
  • Ouvrez le projet Unity complet, pas un fichier C# isolé. Régénérez les fichiers de projet puis rechargez la fenêtre VS Code.
  • Consultez les messages de l’extension et corrigez les erreurs de compilation dans la Console Unity.
  • Si un runtime ou SDK .NET est demandé, suivez les indications de l’extension et faites vérifier l’installation du poste.

Les anciennes consignes OmniSharp Use Global Mono = always concernent une autre génération d’intégration et ne doivent pas être appliquées par défaut à cette configuration.

Choix du dossier de projet

Placez le projet sur le disque local, par exemple dans l’espace local du poste ou /tmp sous Linux, si ce dossier est prévu pour la séance. Le SSD local évite les ralentissements d’import et de compilation du disque réseau.

Sauvegarde en fin de séance

L’espace temporaire peut être supprimé au redémarrage. Sauvegardez et copiez votre projet sur votre espace personnel avant de quitter le poste. Gardez Assets (avec ses fichiers .meta), Packages et ProjectSettings. Les caches Library et Temp peuvent être régénérés par Unity.