Localisation de packages VSIX
Vous pouvez localiser un package VSIX en créant un fichier Extension.vsixlangpack pour chaque langue cible et en le mettant ensuite dans le dossier correspondant. Lorsqu'un package localisé est installé, le nom localisé de l'extension est affiché avec une description localisée. Si vous fournissez un fichier de licence localisé, ou une URL qui pointe sur les informations localisées, il sera également affiché.
Si le contenu votre package VSIX inclut un VSPackage qui ajoute des commandes de menu ou un autre interface utilisateur, consultez Comment : Recherchez les commandes de menu pour plus d'informations sur la localisation des nouveaux éléments d'interface utilisateur.
Structure de répertoire
Lorsqu'un utilisateur installe une extension, le Gestionnaire d'extensions recherche dans le niveau supérieur du package VSIX un dossier dont le nom correspond aux paramètres régionaux système de l'ordinateur cible. Si le Gestionnaire d'extensions trouve un fichier .vsixlangpack dans le dossier, il remplace les valeurs localisées dans ce fichier par les valeurs correspondantes dans le fichier .vsixmanifest. Ces valeurs sont affichées lorsque l'extension est installée. L'exemple suivant montre la structure de répertoire pour un package VSIX localisé en espagnol (es-ES) et en français (fr-FR).
MyExtension.dll
Extension.vsixmanifest
[Content_Types].xml
es-ES
Extension.vsixlangpack
fr-FR
Extension.vsixlangpack
Notes
Les modèles de projet VSIX-pris en charge dans Kit de développement logiciel Visual Studio génèrent un manifeste VSIX et le nom source.extension.vsixmanifest.Lorsque Visual Studio génère le projet, il copie le contenu de ce fichier dans Extension.VsixManifest du package VSIX.
Fichier Extension.vsixlangpack
Le fichier Extension.vsixlangpack suit le Schéma du module linguistique VSIX. Ce schéma comporte un élément racine VSIXLanguagePack et les quatre éléments enfants suivants : LocalizedName, LocalizedDescription, MoreInfoURL et License. Ces éléments enfants correspondent à nom, à description, à MoreInfoURL, et les éléments enfants de licence de l'élément d' identificateur du fichier Extension.vsixmanifest.
Lorsque vous créez un fichier de vsixlangpack, vous devez définir la propriété d' Include in Vsix à true. Sinon, le texte d'installation localisé sera ignoré.
Pour définir l'inclure dans la propriété de VSIX
Dans Explorateur de solutions, cliquez avec le bouton droit sur le fichier Extension.vsixlangpack, puis cliquez sur Propriétés.
dans la grille des propriétés, cliquez sur Incluez dans VSIX, et définissez sa valeur à true.
Exemple
Description
L'exemple suivant montre les parties pertinentes d'un fichier Extension.vsixmanifest, avec le fichier Extension.vsixlangpack correspondant à l'Espagnol. Les valeurs du module linguistique remplacent les valeurs du manifeste si les paramètres régionaux système de l'ordinateur cible sont définis sur l'espagnol.
Code
[Extension.vsixmanifest]
<?xml version="1.0" encoding="utf-8"?>
<VSIX ...>
<Identifier ...>
<Name>Family Tree</Name>
<Description>This extension places a custom treeview control in the toolbox that is optimized for handling family tree information.</Description>
<License>EULA.rtf</License>
<MoreInfoURL>https://www.contoso.com/products/FamilyTree.htm</MoreInfoURL>
...
</Identifier>
<References .../>
<Content .../>
</VSIX>
[Extension.vsixlangpack]
<?xml version="1.0" encoding="utf-8"?>
<VsixLanguagePack Version="1.0.0" xmlns="https://schemas.microsoft.com/developer/vsx-schema-lp/2010">
<LocalizedName>Arbol de Familia</LocalizedName>
<LocalizedDescription> Esta extensión pone control personalizado en la caja de herramientas por manejar información de familia.</LocalizedDescription>
<License>es\Eula.rtf</License>
<MoreInfoUrl> https://www.contoso.com/products/es/ArbolDeFamilia.htm</MoreInfoUrl>
</VsixLanguagePack>
Voir aussi
Référence
VSIXLanguagePack, élément (Schéma du module linguistique VSIX)