Exportation et création de solutions Unity Visual StudioExporting and building a Unity Visual Studio solution

Si votre application n’a pas besoin du clavier système, nous vous recommandons de l’utiliser pour que votre application utilise légèrement moins de mémoire et un temps de lancement plus rapide.If your app doesn't need the system keyboard, our recommendation is to use D3D so that your app uses slightly less memory and a faster launch time. Toutefois, si vous utilisez le clavier du système via l’API TouchScreenKeyboard, vous devez exporter le projet en tant que code XAML.However, if you're using the system keyboard through the TouchScreenKeyboard API, you need to export the project as XAML.

Exportation à partir d’UnityHow to export from Unity

Paramètres de build UnityUnity build settings
Paramètres de build dans l’éditeur UnityBuild settings in Unity editor

  1. Quand vous êtes prêt à exporter votre projet à partir d’Unity, ouvrez le menu fichier et sélectionnez paramètres de Build...When you're ready to export your project from Unity, open the File menu and select Build Settings...
  2. Sélectionnez Ajouter des scènes ouvertes pour ajouter votre scène à la Build.Select Add Open Scenes to add your scene to the build.
  3. Dans la boîte de dialogue paramètres de build , choisissez les options suivantes à exporter pour HoloLens :In the Build Settings dialog, choose the following options to export for HoloLens:
    • Plateforme : plateforme Windows universelle et veillez à sélectionner basculer la plateforme pour que votre sélection prenne effet.Platform: Universal Windows Platform and be sure to select Switch Platform for your selection to take effect.
    • SDK : Universal 10.SDK: Universal 10.
    • Type de build UWP : D3D.UWP Build Type: D3D.
  4. Facultatif: Unity C# Projects : Checked.Optional: Unity C# Projects: Checked.

Notes

L’activation de cette case à cocher vous permet d’effectuer les opérations suivantes :Checking this box allows you to:

  • Déboguez votre application dans le débogueur distant Visual Studio.Debug your app in the Visual Studio remote debugger.
  • Modifiez les scripts dans le projet Unity C# tout en utilisant IntelliSense pour les API WinRT.Edit scripts in the Unity C# project while using IntelliSense for WinRT APIs.
  1. Dans la fenêtre paramètres de Build... , ouvrez paramètres du lecteur...From the Build Settings... window, open Player Settings...
  2. Sélectionnez les paramètres de plateforme Windows universelle onglet.Select the Settings for Universal Windows Platform tab.
  3. Développez le groupe XR Settings.Expand the XR Settings group.
  4. Dans la section paramètres XR , cochez la case Virtual Really Supported pour ajouter une nouvelle liste d' appareils de réalité virtuelle et confirmer « Windows Mixed Reality » est répertoriée en tant qu’appareil pris en charge.In the XR Settings section, check the Virtual Reality Supported checkbox to add a new Virtual Reality Devices list and confirm "Windows Mixed Reality" is listed as a supported device.
  5. Revenez à la boîte de dialogue paramètres de build .Return to the Build Settings dialog.
  6. Sélectionnez Build.Select Build.
  7. Dans la boîte de dialogue de l’Explorateur Windows qui s’affiche, créez un nouveau dossier pour contenir la sortie de la génération d’Unity.In the Windows Explorer dialog that appears, create a new folder to hold Unity's build output. En règle générale, nous nommez le dossier « App ».Generally, we name the folder "App".
  8. Sélectionnez le dossier que vous venez de créer, puis sélectionnez Sélectionner un dossier.Select the newly created folder and select Select Folder.
  9. Une fois la génération de Unity terminée, une fenêtre de l’Explorateur Windows s’ouvre sur le répertoire racine du projet.Once Unity has finished building, a Windows Explorer window will open to the project root directory. Accédez au dossier nouvellement créé.Navigate into the newly created folder.
  10. Ouvrez le fichier de solution Visual Studio généré situé dans ce dossier.Open the generated Visual Studio solution file located inside this folder.

Moment de la réexportation à partir d’UnityWhen to re-export from Unity

Cochez la case projets C# lors de l’exportation de votre application à partir d’Unity crée une solution Visual Studio qui comprend tous vos fichiers de script Unity.Checking the C# Projects checkbox when exporting your app from Unity creates a Visual Studio solution that includes all your Unity script files. L’utilisation de tous vos scripts dans un même emplacement vous permet d’effectuer une itération sans réexportation à partir d’Unity.Having all your scripts in one place lets you iterate without re-exporting from Unity. Toutefois, si vous apportez des modifications à votre projet qui ne modifient pas simplement le contenu des scripts, vous devez réexporter à partir d’Unity.However, if you make changes to your project that aren't just changing the contents of scripts, you'll need to re-export from Unity. Voici quelques exemples de tentatives de réexportation à partir d’Unity :Some examples of times you need to re-export from Unity are:

  • Vous ajoutez ou supprimez des ressources dans l’onglet projet.You add or remove assets in the Project tab.
  • Vous pouvez modifier n’importe quelle valeur sous l’onglet Inspector.You change any value in the Inspector tab.
  • Vous ajoutez ou supprimez des objets dans l’onglet hiérarchie.You add or remove objects from the Hierarchy tab.
  • Vous modifiez les paramètres d’un projet UnityYou change any Unity project settings

Génération et déploiement d’une solution Unity Visual StudioBuilding and deploying a Unity Visual Studio solution

Le reste de la génération et du déploiement d’applications s’effectue dans Visual Studio.The remainder of building and deploying apps happens in Visual Studio. Vous devrez spécifier une configuration de build Unity.You will need to specify a Unity build configuration. Les conventions d’affectation des noms de Unity peuvent différer de ce que vous utilisez dans Visual Studio :Unity's naming conventions may differ from what you're used to in Visual Studio:

ConfigurationConfiguration ExplicationExplanation
DébogageDebug Toutes les optimisations désactivées et le profileur est activé.All optimizations off and the profiler is enabled. Utilisé pour déboguer les scripts.Used to debug scripts.
MasterMaster Toutes les optimisations sont activées et le profileur est désactivé.All optimizations are turned on and the profiler is disabled. Utilisé pour soumettre des applications au Windows Store.Used to submit apps to the Store.
LibérerRelease Toutes les optimisations sont activées et le profileur est activé.All optimizations are turned on and the profiler is enabled. Utilisé pour évaluer les performances de l’application.Used to evaluate app performance.

Notez que la liste ci-dessus est un sous-ensemble des déclencheurs courants qui entraînent la génération du projet Visual Studio.Note, the above list is a subset of the common triggers that will cause the Visual Studio project to need to be generated. En général, la modification des fichiers. cs à partir de Visual Studio ne nécessite pas la régénération du projet à partir d’Unity.In general, editing .cs files from within Visual Studio won't require the project to be regenerated from within Unity.

DépannageTroubleshooting

Si vous constatez que les modifications apportées à vos fichiers. cs ne sont pas reconnues dans votre projet Visual Studio, vérifiez que les projets Unity C# sont activés lorsque vous générez le projet vs à partir du menu générer de Unity.If you find that edits to your .cs files aren't being recognized in your Visual Studio project, ensure that Unity C# Projects is checked when you generate the VS project from Unity's Build menu.