Partager via


Comment : Empaquetez manuellement une extension (le déploiement VSIX)

Vous pouvez créer un package VSIX pour encapsuler une extension de Visual Studio pour le déploiement. Il existe trois façons de créer le package :

  • Créez un projet de package VSIX avec un des modèles d'extensibilité inclus dans Visual Studio Kit de développement logiciel. Il s'agit de l'option la plus simple pour la plupart des scénarios.

  • Encapsulez la sortie de votre projet d'extension dans projet VSIXvide. Nous vous recommandons cette option pour les modèles, les assemblys non pris en charge, et des types personnalisés.

  • Création manuelle d'un package VSIX. Nous vous recommandons cette option uniquement lorsque les deux autres sont pas disponibles.

Ce document décrit la troisième option.

Création d'un package VSIX

Pour empaqueter manuellement une extension, ajoutez un fichier d'extension.manifest et un fichier [Content_Types] .xml au projet d'extension, placez -les dans un fichier compressé avec votre sortie de génération, puis renommez le fichier compressé afin qu'il ait une extension de nom de fichier .vsix. L'extension à empaqueter doit être d'un type qui est pris en charge par Schéma VSIX. Pour une liste des types d'extensions pris en charge, consultez Déploiement d'une extension Visual Studio.

Notes

Les noms des fichiers dans des packages VSIX ne doivent pas inclure des espaces, ni les caractères qui sont réservés dans les Uniform Resource (URI) identifiers, comme défini sous [RFC2396].

Pour créer manuellement un package VSIX

  1. Créez une extension Visual Studio d'un type qui est pris en charge par le schéma VSIX.

  2. Créez un fichier XML, et nommez-le extension.vsixmanifest.

  3. Remplissez le fichier extension.vsixmanifest d'après le schéma VSIX. Pour obtenir un exemple manifeste, consultez Élément de PackageManifest (élément racine, schéma VSX).

  4. Créez un deuxième fichier XML, et nommez-le [Content_Types] .xml.

  5. Remplissez le fichier [Content_Types] .xml comme spécifié dans [Content_types].xml (déploiement VSIX).

  6. Mettez les deux fichiers XML dans un répertoire avec l'extension à déployer.

    Dans le cas d'un modèle de projet ou d'un modèle d'élément, placez le fichier .zip qui contient le modèle dans le même dossier que les fichiers XML. Ne placez pas les fichiers XML dans le fichier .zip.

    Dans tous les autres cas, placez les fichiers XML dans le même répertoire que la sortie de génération.

  7. Dans l'Explorateur Windows, cliquez avec le bouton droit sur le dossier qui contient le contenu d'extension et les deux fichiers XML, cliquez sur Envoyer vers, puis cliquez sur Dossier compressé (zippé).

  8. Renommez le fichier résultant .zip en nom de fichier.vsix, où nom de fichier est le nom du fichier redistribuable qui installe votre package.

Voir aussi

Autres ressources

Déploiement VSIX

Anatomie d'un package VSIX

Élément de PackageManifest (élément racine, schéma VSX)