Déploiement VSIX
Vous pouvez utiliser le format VSIX pour empaqueter des modèles de projet, des modèles d'élément, des packages d'intégration Visual Studio, les composants managés d' (MEF)infrastructure d'extensibilité, des contrôles de boîte à outils , les assemblys, les types personnalisés (cela inclut des pages de démarrage personnalisées). Le format VSIX utilise le déploiement basé sur des fichiers et ne prend pas en charge l'écriture dans le Global (GAC) Assembly Cache ou à la base de registres. Nous vous recommandons d'utiliser le déploiement VSIX pour les genres d'extensions qu'il prend en charge.
Lorsque vous téléchargez des extensions qui ont le format package Visual Studio Gallery VSIX au site Web, les utilisateurs peuvent utiliser Gestionnaire d'extensions pour les installer. Pour plus d'informations sur Gestionnaire d'extensions, consultez Gestion des extensions et mises à jour pour Visual Studio.
Le format VSIX ne prend pas en charge l'installation des macros, des compléments, ou les extraits de code. Il ne prend pas en charge certains autres scénarios tels que les clés de Registre d'écriture pendant l'installation. Pour une comparaison d'autres stratégies de déploiement disponibles, consultez Déploiement d'une extension Visual Studio.
Pour éviter les conflits lorsque vous développez une extension, il est conseillé de désinstaller les versions antérieures de l'extension, utilisées et de désinstaller ou de désactiver des extensions conflit de manière.
Le package VSIX
Un package VSIX est un fichier compressé conforme à la norme OPC (Open Packaging Conventions). Le package contient des fichiers binaires et des fichiers de prise en charge, avec un fichier de [Content_Types] .xml et un fichier manifeste .vsix. Un package VSIX peut contenir la sortie de plusieurs projets, et même des packages multiples qui ont leurs propres manifestes. Pour plus d'informations sur le contenu d'un package VSIX, consultez l' Anatomie d'un package VSIX.
La plupart des modèles de projet dans Kit de développement logiciel Visual Studio créent un package VSIX lorsque vous générez votre projet. Vous pouvez également créer un package VSIX autour de votre extension en créant un projet VSIX vide, puis en ajoutant votre extension à celui-ci. Pour plus d'informations sur la création d'un package VSIX, consultez modèle de projet VSIX.
Notes
Les noms des fichiers inclus dans des packages VSIX ne doivent pas inclure des espaces, ni les caractères qui sont réservés dans la spécification (URI) d'Uniform Resource identifiers, comme défini sous [RFC2396].
Emplacement d'installation
Pendant l'installation, Gestionnaire d'extensions uncompresses le fichier .vsix et place son contenu dans %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions\Company\produit\version\. société, produit, et version sont spécifiés dans le fichier extension.vsixmanifest, et correspondent à l'espace de noms, le nom du projet, et numéro de version qui sont définis dans les propriétés du projet.
Par défaut, l'installation s'applique uniquement à l'utilisateur actuel, car %LocalAppData% est un répertoire spécifique à l'utilisateur. Toutefois, si vous définissez l'élément d' AllUsers du manifeste à True, l'extension sera installé dans. \dossier d'installation de Visual Studio\Common7\IDE\Extensions \société\produit\version\, et sont à la disposition de tous les utilisateurs du système.
Gestion des dépendances
Si un utilisateur essaie d'installer une extension qui a des dépendances, le programme d'installation vérifie que les assemblys requis sont installés sur le système de l'utilisateur. Si les assemblys requis sont introuvables, Gestionnaire d'extensions indique à l'utilisateur une liste des assemblys manquants.
Si le manifeste de l'extension inclut un ou plusieurs éléments de référence , Gestionnaire d'extensions compare le manifeste de chaque référence aux extensions installées sur le système, et installe l'extension référencée si ce n'est déjà installée. Si une version antérieure d'une extension référencée est installée, la dernière version de remplacement.
Par défaut dans une solution contenant plusieurs projets, si un projet que les sorties à un package VSIX contient une référence à un autre projet de la même solution, il comprend les dépendances de ce projet. Vous pouvez substituer ce comportement en cliquant sur la référence pour le projet interne, puis, dans la fenêtre de Propriétés , définissant la propriété de Groupes de sortie inclus dans VSIX à BuiltProjectOutputGroup.
Publication
Vous pouvez distribuer un package VSIX en le plaçant sur Visual Studio Gallery le site Web afin qu'il soit disponible pour les utilisateurs de Visual Studio à Gestionnaire d'extensions. Sinon, vous pouvez télécharger le package à un autre site Web ou un partage réseau, afin que les utilisateurs puissent installer l'extension en double-cliquant sur le fichier .vsix et après l'instruction.
galeries privées
Vous pouvez partager des contrôles, des modèles, et les outils que vous développez dans une organisation sur un intranet en les publiant une galerie privée. Pour plus d'informations, consultez galeries privées.
Rubriques connexes
Titre |
Description |
|---|---|
décrit les composants d'un package VSIX. |
|
Fournit des instructions pas - à - pas sur la façon d'empaqueter et publier une extension. |
|
Explique comment fournir du texte localisé pour le processus d'installation à l'aide de les fichiers extension.vsixlangpack. |
|
Décrit comment mettre à jour une extension sur votre système et comment déployer une mise à jour d'une extension existante de Visual Studio. |
|
Décrit comment ajouter des références à des packages de déploiement VSIX. |