Localisation de packages VSIX

Vous pouvez localiser un package VSIX en créant un fichier Extension.vsixlangpack pour chaque langue cible, puis en les plaçant dans le dossier approprié. Lorsqu’un package localisé est installé, le nom localisé de l’extension s’affiche avec une description localisée. Si vous fournissez un fichier de licence localisé ou une URL qui pointe vers des informations localisées, elles sont également affichées.

Si le contenu de votre package VSIX inclut un VSPackage qui ajoute des commandes de menu ou une autre interface utilisateur, consultez Localiser les commandes de menu pour plus d’informations sur la localisation des nouveaux éléments d’interface utilisateur.

Structure d’annuaires

Lorsqu’un utilisateur installe une extension, extensions et Mises à jour case activée le niveau supérieur du package VSIX pour un dossier dont le nom correspond aux paramètres régionaux Visual Studio de l’ordinateur cible. Si extensions et Mises à jour recherche un fichier .vsixlangpack dans le dossier, il remplace les valeurs localisées dans ce fichier pour 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épertoires d’un package VSIX localisé en espagnol (es-ES) et Français (fr-FR).

.
├── MyExtension.dll
├── Extension.vsixmanifest
├── [Content_Types].xml
├── es-ES
│   └── Extension.vsixlangpack
└── fr-FR
    └── Extension.vsixlangpack

Fichier Extension.vsixlangpack

Le fichier Extension.vsixlangpack suit le schéma vsIX Language Pack 2.0. Ce schéma a un PackageLanguagePackManifestélément enfant, qui est immédiatement suivi Metadata . L’élément Metadata peut contenir jusqu’à 6 éléments enfants, DisplayName, Description, MoreInfo, License, ReleaseNoteset Icon. Ces éléments enfants correspondent aux DisplayNameéléments enfants , , LicenseMoreInfoDescriptionet ReleaseNotesIcon aux éléments enfants de l’élément Metadata du fichier Extension.vsixmanifest.

Lorsque vous créez un fichier vsixlangpack, vous devez définir la Include in Vsix propriété truesur . Sinon, le texte d’installation localisé est ignoré.

Pour définir la propriété Include dans Vsix

1. Dans Explorateur de solutions, cliquez avec le bouton droit sur le fichier Extension.vsixlangpack, puis cliquez sur Propriétés.

2. Dans la grille de propriétés, cliquez sur Inclure dans Vsix et définissez sa valeur truesur .

Exemple

Description

L’exemple suivant montre les parties pertinentes d’un fichier Extension.vsixmanifest . Le fichier inclut également le fichier Extension.vsixlangpack correspondant pour l’espagnol. Les valeurs du module linguistique remplacent les valeurs du manifeste si les paramètres régionaux Visual Studio de l’ordinateur cible sont définis en espagnol.

Code

• [Extension.vsixmanifest]

<?xml version="1.0" encoding="utf-8"?>
<PackageManifest ...>
  <Metadata ...>
    <DisplayName>Family Tree</DisplayName>
    <Description>This extension places a custom treeview control in the toolbox that is optimized for handling family tree information.</Description>
    <MoreInfo>http://www.contoso.com/products/FamilyTree.htm</MoreInfo>
    <License>Eula.rtf</License>
    <ReleaseNotes>ReleaseNotes.rtf</ReleaseNotes>
    <Icon>Icon.png</Icon>
  </Metadata>
  <Installation .../>
  <Dependencies .../>
  <Prerequisites .../>
  <Assets .../>
</PackageManifest>

• [Extension.vsixlangpack]

<?xml version="1.0" encoding="utf-8"?>
<PackageLanguagePackManifest Version="2.0.0" xmlns="http://schemas.microsoft.com/developer/vsx-schema/2011">
  <Metadata>
    <DisplayName>Arbol de Familia</DisplayName>
    <Description> Esta extensión pone control personalizado en la caja de herramientas por manejar información de familia.</Description>
    <MoreInfo> http://www.contoso.com/products/es/ArbolDeFamilia.htm</MoreInfo>
    <License>Eula.rtf</License>
    <ReleaseNotes>ReleaseNotes.rtf</ReleaseNotes>
    <Icon>Icon.png</Icon>
  </Metadata>
</PackageLanguagePackManifest>

Voir aussi