Lokalizace balíčků VSIX

Balíček VSIX můžete lokalizovat vytvořením souboru Extension.vsixlangpack pro každý cílový jazyk a jejich umístěním do správné složky. Při instalaci lokalizovaného balíčku se zobrazí lokalizovaný název rozšíření společně s lokalizovaným popisem. Pokud zadáte lokalizovaný licenční soubor nebo adresu URL, která odkazuje na lokalizované informace, zobrazí se také.

Pokud obsah balíčku VSIX obsahuje balíček VSPackage, který přidává příkazy nabídky nebo jiné uživatelské rozhraní, přečtěte si téma Lokalizace příkazů nabídky s informacemi o lokalizaci nových prvků uživatelského rozhraní.

Adresářová struktura

Když uživatel nainstaluje rozšíření, rozšíření a Aktualizace zkontrolují nejvyšší úroveň balíčku VSIX pro složku, jejíž název odpovídá národnímu prostředí sady Visual Studio cílového počítače. Pokud rozšíření a Aktualizace najde soubor .vsixlangpack ve složce, nahradí lokalizované hodnoty v daném souboru odpovídajícími hodnotami v souboru .vsixmanifest. Tyto hodnoty se zobrazí při instalaci rozšíření. Následující příklad ukazuje adresářovou strukturu balíčku VSIX, který je lokalizovaný do španělštiny (es-ES) a francouzštiny (fr-FR).

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

Soubor Extension.vsixlangpack

Soubor Extension.vsixlangpack se řídí schématem jazykové sady VSIX 2.0. Toto schéma má objekt PackageLanguagePackManifest, který je bezprostředně následovaný podřízeným prvkem Metadata . Element Metadata může obsahovat až 6 podřízených prvků, DisplayName, Description, MoreInfo, License, , ReleaseNotesa Icon. Tyto podřízené elementy odpovídají elementu DisplayNameExtension.vsixmanifest DescriptionReleaseNotesLicenseMoreInfo, , a Icon podřízeným Metadata prvkům prvku souboru Extension.vsixmanifest.

Při vytváření souboru vsixlangpack je nutné nastavit Include in Vsix vlastnost na true. V opačném případě bude lokalizovaný instalační text ignorován.

Nastavení include ve vlastnosti Vsix

1. V Průzkumník řešení klepněte pravým tlačítkem myši na soubor Extension.vsixlangpack a potom klepněte na příkaz Vlastnosti.

2. V mřížce vlastností klepněte na tlačítko Zahrnout do Vsix a nastavte jeho hodnotu na true.

Příklad

Popis

Následující příklad ukazuje relevantní části souboru Extension.vsixmanifest . Soubor také obsahuje odpovídající soubor Extension.vsixlangpack pro španělštinu. Hodnoty z jazykové sady nahradí hodnoty z manifestu, pokud je národní prostředí sady Visual Studio cílového počítače nastaveno na španělštinu.

Kód

• [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>

Viz také