VSIX-pakketten lokaliseren

U kunt een VSIX-pakket lokaliseren door een Extension.vsixlangpack-bestand te maken voor elke doeltaal en deze vervolgens in de juiste map te plaatsen. Wanneer een gelokaliseerd pakket is geïnstalleerd, wordt de gelokaliseerde naam van de extensie samen met een gelokaliseerde beschrijving weergegeven. Als u een gelokaliseerd licentiebestand of een URL opgeeft die verwijst naar gelokaliseerde informatie, worden deze ook weergegeven.

Als de inhoud van uw VSIX-pakket een VSPackage bevat waarmee menuopdrachten of andere gebruikersinterfaces worden toegevoegd, raadpleegt u Menuopdrachten lokaliseren voor informatie over het lokaliseren van de nieuwe UI-elementen.

Mappenstructuur

Wanneer een gebruiker een extensie installeert, controleert Extensies en updates het hoogste niveau van het VSIX-pakket op een map waarvan de naam overeenkomt met de landinstelling van Visual Studio van de doelcomputer. Als extensies en updates een .vsixlangpack-bestand in de map vinden, worden de gelokaliseerde waarden in dat bestand vervangen door de bijbehorende waarden in het . vsixmanifest-bestand . Deze waarden worden weergegeven wanneer de extensie wordt geïnstalleerd. In het volgende voorbeeld ziet u de mapstructuur voor een VSIX-pakket dat is gelokaliseerd in het Spaans (es-ES) en Frans (fr-FR).

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

Het bestand Extension.vsixlangpack

Het bestand Extension.vsixlangpack volgt het VSIX Language Pack-schema 2.0. Dit schema heeft een PackageLanguagePackManifest, dat direct wordt gevolgd door een Metadata onderliggend element. Het element Metagegevens kan maximaal 6 onderliggende elementen bevatten: DisplayName, Description, MoreInfo, License, ReleaseNotes en Icon. Deze onderliggende elementen komen overeen met de DisplayName, Description, MoreInfo, License, ReleaseNotes, en Icon onderliggende elementen van het Metadata-element in het bestand Extension.vsixmanifest.

Wanneer u een vsixlangpack-bestand maakt, moet u de Include in Vsix eigenschap instellen op true. Anders wordt de gelokaliseerde installatietekst genegeerd.

De eigenschap 'Opnemen in Vsix' instellen

1. Klik in Solution Explorer met de rechtermuisknop op het bestand Extension.vsixlangpack en klik vervolgens op Eigenschappen.

2. Klik in het eigenschappenraster op Opnemen in Vsix en stel de waarde in op true.

Example

Description

In het volgende voorbeeld ziet u relevante gedeelten van een Extension.vsixmanifest-bestand . Het bestand bevat ook het bijbehorende Extension.vsixlangpack-bestand voor Spaans. De waarden uit het taalpakket vervangen de waarden uit het manifest als de landinstelling van Visual Studio van de doelcomputer is ingesteld op Spaans.

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>

Zie ook