Bien démarrer avec le modèle de projet VSIX

  • Article

Vous pouvez utiliser le modèle de projet VSIX pour créer une extension ou pour empaqueter une extension existante pour le déploiement. Le modèle de projet VSIX a à la fois des versions Visual Basic et Visual C# et est installé dans le cadre du Kit de développement logiciel (SDK) Visual Studio.

Le modèle de projet VSIX se compose simplement d’un source.extension.vsixmanifest fichier, qui contient des informations sur l’extension et les ressources qu’il fournit.

Pour trouver le modèle de projet VSIX, vous devez installer le Kit de développement logiciel (SDK) Visual Studio. Pour plus d'informations, consultez SDK Visual Studio.

Déployer un modèle de projet personnalisé à l’aide du modèle de projet VSIX

Les étapes suivantes montrent comment utiliser le projet VSIX pour empaqueter un modèle de projet que vous pouvez partager avec d’autres développeurs ou charger dans la galerie Visual Studio.

  1. Créez un modèle de projet.

    1. Ouvrez le projet à partir duquel créer un modèle. Ce projet peut être de n’importe quel type de projet.

    2. Dans le menu Projet, cliquez sur Exporter le modèle. Effectuez les étapes de l’Assistant.

      Un .zip fichier est créé dans %USERPROFILE%\My Documents\Visual Studio {version}\My Exported Templates\.

  2. Créez un projet VSIX vide.

    Sélectionnez Fichier>Nouveau>Projet. Dans la zone de recherche, tapez « vsix », puis sélectionnez la version C# ou Visual Basic du projet VSIX.

  3. Ajoutez le fichier .zip au projet. Définissez sa propriété Copy to Output Directory sur Copy Always.

  4. Dans Explorateur de solutions, double-cliquez sur le fichier source.extension.vsixmanifest pour l’ouvrir dans le Concepteur de manifeste VSIX, puis apportez les modifications suivantes :

    • Définissez le champ Nom du produit sur Mon modèle de projet.

    • Définissez le champ ID de produit sur MyProjectTemplate - 1.

    • Définissez le champ Auteur sur Fabrikam.

    • Définissez le champ Description sur Mon modèle de projet.

    • Dans la section Assets , ajoutez un type Microsoft.VisualStudio.ProjectTemplate et définissez son chemin d’accès au nom du fichier .zip .

  5. Enregistrez et fermez le fichier source.extension.vsixmanifest.

  6. Créez le projet.

  7. Dans le répertoire de sortie, double-cliquez sur le .vsix fichier.

  8. Une boîte de message du programme d’installation VSIX s’affiche. Suivez les instructions pour installer l’extension.

  9. Fermez Visual Studio, puis rouvrez-le.

  10. Sélectionnez Gérer les extensions (dans le menu Extensions ) et sélectionnez la catégorie Modèles . L’une des extensions disponibles doit être Mon modèle de projet.

  11. Le nouveau modèle de projet apparaît dans la boîte de dialogue Nouveau projet au même endroit que le modèle de projet d’origine. Par exemple, si vous avez créé un modèle nommé Console VB à partir d’une application console Visual Basic, la console VB apparaît dans le même volet que le modèle d’application console Visual Basic.

Pour spécifier l’emplacement du modèle dans la boîte de dialogue Nouveau projet

  1. Les dossiers de modèles se trouvent dans les répertoires et {Visual Studio Installation Path}\Common7\IDE\ItemTemplates les {Visual Studio Installation Path}\Common7\IDE\ProjectTemplates répertoires. Les noms des sections de niveau supérieur de la boîte de dialogue Nouveau projet ne correspondent pas exactement aux noms des dossiers de modèle. Là où elles diffèrent, utilisez le nom du dossier de modèle.

    Remplacez l’extension .zipde .vsix fichier par , puis ouvrez le fichier.

  2. Créez un dossier portant le même nom que la section de la boîte de dialogue Nouveau projet dans laquelle le modèle doit apparaître.

  3. Si le modèle doit apparaître dans une sous-section, créez un sous-dossier du même nom.

  4. Déplacez le fichier de modèle .zip dans le nouveau dossier.

  5. Remplacez l’extension .vsixpar .zip .

  6. Ouvrez le manifeste VSIX.

  7. Dans le manifeste VSIX, mettez à jour le chemin d’accès de la ressource du modèle afin qu’il pointe vers la racine de l’arborescence de répertoires qui contient le fichier de modèle. Par exemple, si le modèle est dans \CSharp\Windows, la référence doit pointer vers \CSharp.