Локализация пакетов VSIX

Статья
10/10/2023

Вы можете локализовать пакет VSIX, создав файл Extension.vsixlangpack для каждого целевого языка, а затем поместив их в правильную папку. При установке локализованного пакета локализованное имя расширения отображается вместе с локализованным описанием. Если вы предоставляете локализованный файл лицензии или URL-адрес, указывающий на локализованные сведения, они также отображаются.

Если содержимое пакета VSIX содержит VSPackage, который добавляет команды меню или другой пользовательский интерфейс, см. в разделе " Локализовать команды меню" для получения сведений о локализации новых элементов пользовательского интерфейса.

Структура каталогов

Когда пользователь устанавливает расширение, расширения и Обновления проверка верхнего уровня пакета VSIX для папки, имя которой соответствует языковому стандарту Visual Studio целевого компьютера. Если расширения и Обновления находит vsixlangpack-файл в папке, он заменяет локализованные значения в этом файле соответствующими значениями в vsixmanifest-файле. Эти значения отображаются при установке расширения. В следующем примере показана структура каталогов для пакета VSIX, локализованного на испанский (es-ES) и французский (fr-FR).

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

Примечание.

Поддерживаемые VSIX шаблоны проектов в пакете SDK Visual Studio создают манифест VSIX и называют его source.extension.vsixmanifest. При сборке проекта Visual Studio копирует содержимое этого файла в Extension.VsixManifest в пакет VSIX.

Файл Extension.vsixlangpack

Файл Extension.vsixlangpack следует схеме языкового пакета VSIX 2.0. Эта схема имеет дочерний PackageLanguagePackManifestэлемент, который сразу же следует дочернему элементу Metadata . Элемент метаданных может содержать до 6 дочерних элементов, DisplayName, , Description, MoreInfo, LicenseReleaseNotesи Icon. Эти дочерние элементы соответствуют DisplayNameэлементам , , LicenseReleaseNotesIconDescriptionMoreInfoи дочерним элементам Metadata элемента файла Extension.vsixmanifest.

При создании файла vsixlangpack необходимо задать Include in Vsix для trueсвойства значение . В противном случае локализованный текст установки будет игнорироваться.

Установка свойства Include в vsix

В Обозреватель решений щелкните правой кнопкой мыши файл Extension.vsixlangpack и выберите пункт "Свойства".
В сетке свойств щелкните "Включить в Vsix" и задайте для него значениеtrue.

Пример

Description

В следующем примере показаны соответствующие части файла Extension.vsixmanifest . Файл также содержит соответствующий файл Extension.vsixlangpack для испанского языка. Значения из языкового пакета заменяют значения из манифеста, если языковой стандарт Visual Studio целевого компьютера имеет значение испанского языка.

Код

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

См. также

Заголовок	Description
Справочник по схеме пакета языка VSIX 2.0	Языковой пакет VSIX описывает сведения о локализации файла развертывания VSIX.
Анатомия пакета VSIX	Описывает структуру и содержимое пакета vsix.
Локализация команд меню	Показывает, как локализовать другие текстовые ресурсы в расширении.

Поделиться через