Prise en main de Visual Studio Tools pour UnityGetting Started with Visual Studio Tools for Unity

Dans cette section, vous allez apprendre à installer Visual Studio Tools pour Unity et à configurer votre projet Unity pour qu’il fonctionne avec Visual Studio.In this section, you'll learn how to install Visual Studio Tools for Unity and configure your Unity project to work with Visual Studio.

Important

Unity 5.2 ajoute la prise en charge intégrée pour Visual Studio Tools pour Unity 2.1, ce qui simplifie la configuration de projet.Unity 5.2 adds built-in support for Visual Studio Tools for Unity 2.1, which simplifies project setup. Pour tirer parti de cette possibilité, vous avez besoin d’Unity version 5.2.0 ou ultérieure sur Windows et de Visual Studio Tools pour Unity version 2.1 ou ultérieure.To take advantage of this, you'll need Unity version 5.2.0 or higher on Windows, and Visual Studio Tools for Unity version 2.1 or higher.

PrérequisPrerequisites

Pour utiliser Visual Studio Tools pour Unity, vous avez besoin des éléments suivants :To use Visual Studio Tools for Unity, you'll need:

  • Une version de Visual Studio qui prend en charge les extensions, telle que Visual Studio Community, Professional, Premium ou Enterprise.A version of Visual Studio that supports extensions, such as Visual Studio Community, Professional, Premium, or Enterprise. Vous pouvez télécharger gratuitement Visual Studio Community.You can download Visual Studio Community for free.

    Télécharger Visual Studio CommunityDownload Visual Studio Community

  • Unity version 4.0.0 ou ultérieure ; Unity version 5.2.0 ou ultérieure pour tirer parti de la prise en charge intégrée pour Visual Studio Tools pour Unity version 2.1 ou ultérieure.Unity version 4.0.0 or higher; Unity version 5.2.0 or higher to take advantage of built-in support for Visual Studio Tools for Unity version 2.1 or higher.

    Télécharger UnityDownload Unity

Installer Visual Studio Tools pour UnityInstall Visual Studio Tools for Unity

Téléchargez et installez Visual Studio Tools pour Unity à partir de la galerie Visual Studio.Download and install Visual Studio Tools for Unity from the Visual Studio Gallery. Vous devez installer le package approprié à votre version de Visual Studio.You'll need to install the right package for your version of Visual Studio. Assurez-vous d’installer Visual Studio Tools pour Unity version 2.1 ou ultérieure pour tirer parti de la prise en charge intégrée pour VSTU dans Unity 5.2 ou ultérieure.Make sure to install Visual Studio Tools for Unity version 2.1 or higher to take advantage of built-in support for VSTU in Unity 5.2 or higher.

Note

Les versions Express de Visual Studio ne prennent pas en charge les extensions telles que Visual Studio Tools pour Unity.Express versions of Visual Studio don't support extensions such as Visual Studio Tools for Unity. Visual Studio Community est une version gratuite de Visual Studio qui prend en charge Visual Studio Tools pour Unity et d’autres extensions.Visual Studio Community is a free version of Visual Studio that supports Visual Studio Tools for Unity and other extensions. Pour la plupart des utilisateurs, Visual Studio Community est un meilleur choix que la version Express.For most users, Visual Studio Community is a better choice than Express.

Note

Pour Visual Studio 2017, VSTU 3 est fourni avec la charge de travail Unity que vous pouvez choisir à partir du programme d’installation.For Visual Studio 2017, VSTU 3 comes with the Unity workload that you can choose from the installer.

Votre premier projet Unity avec Visual Studio Tools pour UnityYour first Unity project with Visual Studio Tools for Unity

Maintenant que vous avez tout ce dont vous avez besoin, vous êtes prêt pour votre premier projet Unity avec Visual Studio.Now that you have everything you need, you're ready for your first Unity project with Visual Studio. La configuration de votre projet Unity est différente selon les versions d’Unity et de Visual Studio Tools pour Unity installées.Setting up your Unity project is different depending on which versions of Unity and Visual Studio Tools for Unity are installed. Suivez les étapes ci-dessous pour la version d’Unity et de Visual Studio Tools pour Unity que vous avez installée.Follow the steps below for the version of Unity and Visual Studio Tools for Unity that you have installed.

Unity 5.2 et versions ultérieures (nécessite VSTU 2.1 ou version ultérieure)Unity 5.2 and higher (requires VSTU 2.1 or higher)

Depuis Unity 5.2, vous ne devez plus importer le package Visual Studio Tools pour Unity dans vos projets.Starting with Unity 5.2, you no longer have to import the Visual Studio Tools unitypackage into your projects. Si votre projet importe ce package, Unity 5.2 l’ignore et charge directement Visual Studio Tools pour Unity à partir de son emplacement d’installation.If your project imports this unitypackage, Unity 5.2 ignores it and directly loads Visual Studio Tools for Unity from its installed location.

1 - Créer un projet Unity1 - Create a Unity Project

Si vous êtes déjà familiarisé avec Unity, vous pouvez créer un projet ou charger l’un des vôtres.If you're already experienced with Unity, you can create a new project or load one of your own. Si vous chargez un projet qui a importé le package Visual Studio Tools pour Unity pour utiliser Visual Studio Tools pour Unity avec une version précédente d’Unity, nous vous recommandons de le supprimer en supprimant le répertoire UnityVS.If you're loading a project that imported the Visual Studio Tools unitypackage to use Visual Studio Tools for Unity with a previous version of Unity, we recommend that you remove it by deleting the UnityVS directory.

Sinon, si vous débutez avec Unity, commencez avec un didacticiel de base.Otherwise, if you're new to Unity, start small with a basic tutorial. Visitez la page de découverte d’Unity pour rechercher des didacticiels sur les exemples de projets avec lesquels vous pouvez démarrer, ainsi que les leçons qui vous permettront d’apprendre à créer votre propre jeu avec Unity.Visit the Unity Learn page to find tutorials on example projects you can start with and lessons you can learn from to build your own game with Unity. La page de découverte d’Unity possède des didacticiels faciles à suivre pour plusieurs jeux différents.The Unity Learn page has easy-to-follow tutorials for several different games.

Didacticiels - Page de découverte d’UnityTutorials - Unity Learn page

2 - Configurer l’éditeur Unity pour utiliser Visual Studio Tools pour Unity2 - Configure Unity Editor to use Visual Studio Tools for Unity

Pour activer votre projet pour utiliser Visual Studio Tools pour Unity, définissez simplement Visual Studio comme éditeur de script externe.To enable your project to use Visual Studio Tools for Unity, just set Visual Studio as its external script editor. Dans l’éditeur Unity, dans le menu principal, sélectionnez Modifier, Préférencespuis, dans la boîte de dialogue des préférences Unity , choisissez Outils externes.In the Unity Editor, on the main menu, choose Edit, Preferences; then, in the Unity Preferences dialog, choose External Tools. Ensuite, affectez à la propriété de l’ éditeur de script externe la version de Visual Studio que vous souhaitez utiliser (Visual Studio Tools pour Unity doit être installé pour cette version de Visual Studio) et assurez-vous que la propriété d’ attachement de l’éditeur est définie.Next, set the External Script Editor property to the version of Visual Studio you want to use (Visual Studio Tools for Unity must be installed for this version of Visual Studio) and make sure the Editor Attaching property is set.

Pour vérifier que la prise en charge intégrée pour Visual Studio Tools pour Unity est maintenant activée, consultez la boîte de dialogue À propos d’Unity .To make sure that built-in support for Visual Studio Tools for Unity is now enabled, see the About Unity dialog. In the Unity editor, on the main menu, choose Aide, À propos d’UnityIn the Unity editor, on the main menu, choose Help, About Unity. . Si Visual Studio Tools pour Unity est installé et configuré correctement, vous verrez un message affiché dans le coin inférieur gauche de la boîte de dialogue À propos d’Unity .If Visual Studio Tools for Unity is installed and correctly configured, you'll see a message displayed in the lower left-hand corner of the About Unity dialog.

Enfin, assurez-vous que vous avez défini une cible de génération via la page Paramètres de génération et que Débogage de script est activé.Finally, make sure you've set a build target through the Build Settings page and that Script Debugging is enabled.

Configurez les paramètres de build Unity pour le débogage.Configure the Unity build settings for debugging.

3 - Lancer Visual Studio à partir de l’éditeur Unity3 - Launch Visual Studio from the Unity Editor

Depuis Unity 5.2, le menu de l’extension Visual Studio Tools n’est plus nécessaire pour lancer Visual Studio ni configurer Visual Studio Tools pour Unity.Starting with Unity 5.2, the Visual Studio Tools extension menu is no longer needed to launch Visual Studio or to configure Visual Studio Tools for Unity. En revanche, une fois que Visual Studio est configuré comme éditeur de script externe, choisissez le fichier de script à partir de l’éditeur Unity et votre code sera ouvert dans Visual Studio.Instead, once Visual Studio is configured as your external script editor, just choose the script file from the Unity editor and your code will be opened in Visual Studio.

Versions précédentes d’Unity (avant 5.2)Previous versions of Unity (pre-5.2)

Avant Unity 5.2, il n’existait aucune prise en charge intégrée pour Visual Studio Tools pour Unity.Before Unity 5.2, there was no built-in support for Visual Studio Tools for Unity. Au lieu de cela, chaque projet devait importer le package Visual Studio Tools pour Unity et configurer d’autres paramètres de projet afin d’utiliser Visual Studio Tools pour Unity.Instead, each project had to import the Visual Studio Tools unitypackage and configure other project settings in order to use Visual Studio Tools for Unity.

1 - Créer un projet Unity1 - Create a Unity Project

Si vous êtes déjà familiarisé avec Unity, vous pouvez créer un projet ou charger l’un des vôtres.If you're already experienced with Unity, you can create a new project or load one of your own. Si vous démarrez un nouveau projet, importez le package Visual Studio Tools pour Unity lors de sa création.If you're starting a new project, import the Visual Studio Tools unitypackage when you create it.

Sinon, si vous débutez avec Unity, commencez avec un didacticiel de base.Otherwise, if you're new to Unity, start small with a basic tutorial. Visitez la page de découverte d’Unity pour rechercher des didacticiels sur les exemples de projets avec lesquels vous pouvez démarrer, ainsi que les leçons qui vous permettront d’apprendre à créer votre propre jeu avec Unity.Visit the Unity Learn page to find tutorials on example projects you can start with and lessons you can learn from to build your own game with Unity. La page de découverte d’Unity possède des didacticiels faciles à suivre pour plusieurs jeux différents.The Unity Learn page has easy-to-follow tutorials for several different games.

Didacticiels - Page de découverte d’UnityTutorials - Unity Learn page

2 - Configurer l’éditeur Unity pour utiliser Visual Studio Tools pour Unity2 - Configure Unity Editor to use Visual Studio Tools for Unity

Si vous commencez à partir d’un projet Unity existant ou que vous n’avez pas importé le package Visual Studio Tools pour Unity lors de la création du projet, vous devez l’importer maintenant.If you're starting from an existing Unity project or you didn't import the Visual Studio Tools unitypackage when you created the project, you need to import the unitypackage now. Dans l’éditeur Unity, dans le menu principal, choisissez Composants, Importer un package, Visual Studio 2015 Tools (vous devez voir une option pour la version de Visual Studio que vous avez installée).In the Unity editor, on the main menu, choose Assets, Import Package, Visual Studio 2015 Tools (you should see an option for the version of Visual Studio you have installed).

Importer le package VSTU dans votre projet Unity.Import the VSTU package into your Unity project.

Enfin, assurez-vous que vous avez défini une cible de génération via la page Paramètres de génération et que Débogage de script est activé.Finally, make sure you've set a build target through the Build Settings page and that Script Debugging is enabled.

Configurez les paramètres de build Unity pour le débogage.Configure the Unity build settings for debugging.

3 - Lancer Visual Studio à partir de l’éditeur Unity3 - Launch Visual Studio from Unity Editor

L’étape finale consiste à démarrer Visual Studio à partir d’Unity.The final step is to start Visual Studio from Unity. Une solution Visual Studio est créée pour votre projet, et s’ouvre dans Visual Studio.This creates a Visual Studio Solution for your project, and then opens it in Visual Studio.

Dans l’éditeur Unity, dans le menu principal, sélectionnez Visual Studio Tools, Ouvrir dans Visual Studio.In the Unity Editor, on the main menu, choose Visual Studio Tools, Open in Visual Studio.

Ouvrir votre projet Unity dans Visual Studio.Open your unity project in Visual Studio.

Étapes suivantesNext steps

Pour savoir comment manipuler et déboguer votre projet Unity dans Visual Studio, consultez Utilisation de Visual Studio Tools pour Unity.To learn how to work with and debug your Unity project in Visual Studio, see Using Visual Studio Tools for Unity.

Voir aussiSee Also

Page d’accueil d’UnityUnity Homepage