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

Vous pouvez installer un langage 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 StudioVisual Studio doit déjà être installé sur l’ordinateur cible. 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 (Visual StudioVisual Studio Extension)VSX (Visual StudioVisual 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 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 d’ouvrir Visual StudioVisual Studio en double-cliquant sur un fichier DSL.- Allows the user to open Visual StudioVisual Studio by double-clicking a DSL file.
-Associe une icône avec le type de fichier DSL sur l’ordinateur cible.- Associates an icon with the DSL file type in the target computer.
-Associe un schéma 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 StudioVisual Studio.This avoids warnings when the file is loaded into Visual StudioVisual 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 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 DSL à l’aide de la VSXInstalling and Uninstalling a DSL by using the VSX

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

Pour installer une 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 de DSL.In your computer, find the .vsix file that was built by your DSL Package project.

    1. Dans l’Explorateur de solutions, cliquez sur 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 à l’ordinateur cible sur lequel vous souhaitez installer le 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 DSL, utilisez Visual StudioVisual Studio pour créer un nouveau fichier ayant l’extension que vous avez définie pour votre DSL.To test the DSL, use Visual StudioVisual Studio to create a new file that has the extension that you defined for your DSL.

Pour désinstaller une 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 laquelle la DSL est définie, 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 DSL dans un fichier MSIDeploying a DSL in an MSI

En définissant un fichier MSI (Windows Installer) de 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 schéma XSD qui peut être utilisé pour valider les 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 vont être 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 pour votre Visual StudioVisual Studio solution.To build an MSI, you add a Setup project to your Visual StudioVisual Studio solution. La méthode de création d’un projet d’installation la plus simple est d’utiliser le modèle CreateMsiSetupProject.tt, que vous pouvez télécharger à partir de la 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 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 les 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 de <SupportedProducts>:Insert the following line before <SupportedProducts>:

      <InstalledByMsi>true</InstalledByMsi>
      
  2. Créez ou modifiez une icône qui représente 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éfinir la valeur pour faire référence à 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 générer menu, ouvrir Configuration Manager, puis 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 StudioVisual Studio Crée un fichier nommé CreateMsiSetupProject.vdproj. 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, ajoutez 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 à côté DslPackage.Select the box next to DslPackage.

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

  10. Dans l’Explorateur Windows, recherchez 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 voulez 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 liste de l’Explorateur Windows, le fichier s’affiche avec l’icône et la description que vous avez définie.In Windows Explorer list view, the file appears with the icon and description that you defined.

    • Lorsque vous double-cliquez sur le fichier, Visual StudioVisual Studio démarre et ouvre le fichier DSL dans l’éditeur de votre DSL.When you double-click the file, Visual StudioVisual 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 de 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 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ésinstallez la DSL.Uninstall the DSL.

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