Déploiement MSI et VSIX d'un langage spécifique à un domaineMSI and VSIX Deployment of a DSL

Vous pouvez installer une langue spécifique à un domaine sur votre ordinateur ou sur d’autres ordinateurs.You can install a domain-specific language on your own computer or on other computers. Visual Studio doit déjà être installé sur l’ordinateur cible.Visual Studio must already be installed on the target computer.

Choix entre VSIX et de déploiement MSIChoosing between VSIX and MSI Deployment

Il existe deux méthodes de déploiement d’un langage spécifique à un domaine :There are two methods of deploying a domain-specific language:

MéthodeMethod AvantagesBenefits
VSX (Extension de Visual Studio)VSX (Visual Studio Extension) Très facile à déployer : copie et d’exécuter le .vsix fichier à partir du projet DslPackage.Very easy to deploy: Copy and execute the .vsix file from the DslPackage project.

Pour plus d’informations, consultez installation et désinstallation d’une solution DSL à l’aide de la VSX.For more information see Installing and Uninstalling a DSL by using the VSX.
MSI (fichier de programme d’installation)MSI (installer file) -Permet à l’utilisateur ouvrir Visual Studio en double-cliquant sur un fichier DSL.- Allows the user to open Visual Studio by double-clicking a DSL file.
-Associe une icône avec le type de fichier DSL dans l’ordinateur cible.- Associates an icon with the DSL file type in the target computer.
-Associe un XSD (schéma XML) avec le type de fichier DSL.- Associates an XSD (XML schema) with the DSL file type. Cela évite des avertissements lorsque le fichier est chargé dans Visual Studio.This avoids warnings when the file is loaded into Visual Studio.

Vous devez ajouter un projet d’installation à votre solution pour créer un fichier MSI.You must add a setup project to your solution to create an MSI.

Pour plus d’informations, consultez déploiement d’une solution DSL à l’aide d’un fichier MSI.For more information, see Deploying a DSL by using an MSI file.

Installation et désinstallation d’une solution DSL à l’aide de la VSXInstalling and Uninstalling a DSL by using the VSX

Lorsque votre solution DSL est installé par cette méthode, l’utilisateur peut ouvrir un fichier DSL à partir de Visual Studio, mais le fichier ne peut pas être ouvert à partir de l’Explorateur Windows.When your DSL is installed by this method, the user can open a DSL file from within Visual Studio, but the file cannot be opened from Windows Explorer.

Pour installer une solution DSL à l’aide de la VSXTo install a DSL by using the VSX

  1. Sur votre ordinateur, recherchez le .vsix fichier qui a été généré par votre projet de Package DSL.In your computer, find the .vsix file that was built by your DSL Package project.

    1. Dans l’Explorateur de solutions, avec le bouton droit le DslPackage de projet, puis cliquez sur ouvrir le dossier dans l’Explorateur Windows.In Solution Explorer, right-click the DslPackage project, and then click Open Folder in Windows Explorer.

    2. Recherchez le fichier bin\*\VotreProjet. DslPackage.vsixLocate the file bin\*\YourProject.DslPackage.vsix

  2. Copie le .vsix fichier sur l’ordinateur cible sur lequel vous souhaitez installer la solution DSL.Copy the .vsix file to the target computer on which you want to install the DSL. Il peut s’agir de votre propre ordinateur ou d’un autre.This can be your own computer or another one.

  3. Sur l’ordinateur cible, double-cliquez sur le .vsix fichier.On the target computer, double-click the .vsix file.

    LeProgramme d’installation des extensions Visual Studio s’ouvre et installe l’extension.Visual Studio Extension Installer opens and installs the extension.

  4. Démarrez ou redémarrez Visual StudioVisual Studio.Start or restart Visual StudioVisual Studio.

  5. Pour tester la solution DSL, utilisez Visual Studio pour créer un nouveau fichier portant l’extension que vous avez défini pour votre DSL.To test the DSL, use Visual Studio to create a new file that has the extension that you defined for your DSL.

Pour désinstaller une solution DSL a été installée à l’aide de VSXTo uninstall a DSL that was installed by using VSX

  1. Sur le outils menu, cliquez sur Gestionnaire d’extensions.On the Tools menu, click Extension Manager.

  2. Développez Extensions installées.Expand Installed Extensions.

  3. Sélectionnez l’extension dans lequel la solution DSL est défini, puis cliquez sur désinstallation.Select the extension in which the DSL is defined, and then click Uninstall.

    Exceptionnellement, une extension défaillante ne parvient pas à se charger et crée un rapport dans la fenêtre d’erreur, mais ne s’affiche pas dans le Gestionnaire d’extensions.Rarely, a faulty extension fails to load and creates a report in the error window, but does not appear in Extension Manager. Dans ce cas, vous pouvez supprimer l’extension en supprimant le fichier de l’emplacement suivant :In that case, you can remove the extension by deleting the file from:

    LocalAppData \Microsoft\VisualStudio\10.0\ExtensionsLocalAppData \Microsoft\VisualStudio\10.0\Extensions

Déploiement d’une solution DSL dans un fichier MSIDeploying a DSL in an MSI

En définissant un fichier MSI (Windows Installer) pour votre DSL, vous pouvez autoriser les utilisateurs à ouvrir des fichiers DSL à partir de l’Explorateur Windows.By defining an MSI (Windows Installer) file for your DSL, you can allow users to open DSL files from Windows Explorer. Vous pouvez également associer une icône et une brève description votre extension de nom de fichier.You can also associate an icon and short description with your file name extension. En outre, le fichier MSI peut installer un XSD qui peut être utilisé pour valider des fichiers DSL.In addition, the MSI can install an XSD that can be used to validate DSL files. Si vous le souhaitez, vous pouvez ajouter d’autres composants dans le fichier MSI qui est installé en même temps.If you want, you can add other components into the MSI that will be installed at the same time.

Pour plus d’informations sur les fichiers MSI et d’autres options de déploiement, consultez déploiement d’Applications, Services et composants.For more information about MSI files and other deployment options, see Deploying Applications, Services, and Components.

Pour générer un fichier MSI, vous ajoutez un projet d’installation à votre solution Visual Studio.To build an MSI, you add a Setup project to your Visual Studio solution. La méthode la plus simple de création d’un projet d’installation consiste à utiliser le modèle CreateMsiSetupProject.tt, que vous pouvez télécharger depuis le site VMSDK.The easiest method of creating a Setup project is to use the CreateMsiSetupProject.tt template, which you can download from the VMSDK site.

Pour déployer une solution DSL dans un fichier MSITo Deploy a DSL in an MSI

  1. Définissez InstalledByMsi dans le manifeste d’extension.Set InstalledByMsi in the extension manifest. Cela empêche le VSX installé et désinstallé à l’exception par le fichier MSI.This prevents the VSX from being installed and uninstalled except by the MSI. Ceci est important si vous inclurez des autres composants dans le fichier MSI.This is important if you will include other components in the MSI.

    1. Ouvrez DslPackage\source.extension.ttOpen DslPackage\source.extension.tt

    2. Insérez la ligne suivante avant <SupportedProducts>:Insert the following line before <SupportedProducts>:

      <InstalledByMsi>true</InstalledByMsi>
      
  2. Créez ou modifiez une icône qui représentera votre DSL dans l’Explorateur Windows.Create or edit an icon that will represent your DSL in Windows Explorer. Par exemple, modifiez DslPackage\Resources\File.icoFor example, edit DslPackage\Resources\File.ico

  3. Assurez-vous que les attributs suivants de votre DSL sont corrects :Make sure that the following attributes of your DSL are correct:

    • Cliquez sur le nœud racine dans l’Explorateur DSL et dans la fenêtre Propriétés, consultez :In DSL Explorer click the root node, and in Properties window, review:

      • DescriptionDescription

      • VersionVersion

    • Cliquez sur le éditeur nœud dans la fenêtre Propriétés, cliquez sur icône.Click the Editor node and in the Properties window, click Icon. Définissez la valeur pour référencer un fichier d’icône DslPackage\Resources, tel que File.icoSet the value to reference an icon file in DslPackage\Resources, such as File.ico

    • Sur le Build menu, ouvrez Configuration Manageret sélectionnez la configuration que vous souhaitez générer, tel que version ou déboguer .On the Build menu, open Configuration Manager, and select the configuration that you want to build, such as Release or Debug.

  4. Accédez à page d’accueil Visualization and Modeling SDKet à partir de la télécharge onglet, téléchargez CreateMsiSetupProject.tt.Go to Visualization and Modeling SDK home page, and from the Downloads tab, download CreateMsiSetupProject.tt.

  5. Ajouter CreateMsiSetupProject.tt à votre projet Dsl.Add CreateMsiSetupProject.tt to your Dsl project.

    Visual Studio crée un fichier nommé CreateMsiSetupProject.vdproj.Visual Studio will create a file named CreateMsiSetupProject.vdproj.

  6. Dans l’Explorateur Windows, copiez Dsl\*.vdproj vers un nouveau dossier nommé le programme d’installation.In Windows Explorer, copy Dsl\*.vdproj to a new folder named Setup.

    (Si vous le souhaitez, vous pouvez désormais exclure CreateMsiSetupProject.tt à partir de votre projet Dsl.)(If you want, you can now exclude CreateMsiSetupProject.tt from your Dsl project.)

  7. Dans l’Explorateur de solutions, ajouter le programme d’installation\*.vdproj qu’un projet existant.In Solution Explorer, add Setup\*.vdproj as an existing project.

  8. Sur le projet menu, cliquez sur dépendances du projet.On the Project menu, click Project Dependencies.

    Dans le dépendances du projet boîte de dialogue, sélectionnez le projet d’installation.In the Project Dependencies dialog box, select the setup project.

    Activez la case en regard DslPackage.Select the box next to DslPackage.

  9. Régénérez la solution.Rebuild the solution.

  10. Dans l’Explorateur Windows, localisez le fichier MSI généré dans votre projet d’installation.In Windows Explorer, locate the built MSI file in your Setup project.

    Copiez le fichier MSI sur un ordinateur sur lequel vous souhaitez installer votre DSL.Copy the MSI file to a computer on which you want to install your DSL. Double-cliquez sur le fichier MSI.Double-click the MSI file. Le programme d’installation s’exécute.The installer runs.

  11. Dans l’ordinateur cible, créez un nouveau fichier qui porte l’extension de fichier de votre DSL.In the target computer, create a new file that has the file extension of your DSL. Vérifiez que :Verify that:

    • Dans la vue de liste de l’Explorateur Windows, le fichier s’affiche avec l’icône et la description que vous avez défini.In Windows Explorer list view, the file appears with the icon and description that you defined.

    • Lorsque vous double-cliquez sur le fichier, Visual Studio démarre et ouvre le fichier DSL dans l’éditeur de votre DSL.When you double-click the file, Visual Studio starts, and opens the DSL file in your DSL editor.

    Si vous préférez, vous pouvez créer le projet d’installation manuellement, au lieu d’utiliser le modèle de texte.If you prefer, you can create the Setup project manually, instead of using the text template. Pour une procédure pas à pas qui inclut cette procédure, consultez le chapitre 5 du de visualisation et modélisation de laboratoire de kit de développement logiciel.For a walkthrough that includes this procedure see Chapter 5 of the Visualization and Modeling SDK Lab.

Pour désinstaller une solution DSL a été installée à partir d’un fichier MSITo uninstall a DSL that was installed from an MSI

  1. Dans Windows, ouvrez le programmes et fonctionnalités le panneau de configuration.In Windows, open the Programs and Features control panel.

  2. Désinstaller la solution DSL.Uninstall the DSL.

  3. Redémarrez Visual Studio.Restart Visual Studio.