將 VSIX 封裝當地語系化

  • 發行項

透過建立每個目標語言的 Extension.vsixlangpack 檔案，然後將它們放在正確的資料夾中，以當地語系化 VSIX 套件。 安裝當地語系化套件時，擴充功能的當地語系化名稱會連同當地語系化的描述一起顯示。 如果您提供當地語系化的授權檔案，或指向當地語系化資訊的 URL，也會顯示它們。

如果您的 VSIX 套件包含新增功能表命令或其他 UI 的 VSPackage 內容，請參閱當地語系化功能表命令 ，以取得當地語系化新 UI 元素的相關資訊。

目錄結構

當使用者安裝擴充功能時，擴充功能和更新會檢查 VSIX 套件的最上層是否有名稱符合目標電腦的 Visual Studio 地區設定的資料夾。 如果 [擴充功能和更新] 在資料夾中找到 .vsixlangpack 檔案，它會將該檔案中的當地語系化值取代為 .vsixmanifest 檔案中的對應值。 安裝擴充功能時會顯示這些值。 下列範例顯示當地語系化為西班牙文 (es-ES) 和法文 (fr-FR) 之 VSIX 套件的目錄結構。

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

注意

Visual Studio SDK 中支援 VSIX 的專案範本會產生 VSIX 資訊清單，並將它命名為 source.extension.vsixmanifest。 當 Visual Studio 建置專案時，會將該檔案的內容複製到 VSIX 套件中的 Extension.VsixManifest。

Extension.vsixlangpack 檔案

Extension.vsixlangpack 檔案遵循 VSIX 語言套件結構描述 2.0。 這個結構描述具有 PackageLanguagePackManifest，緊接在 Metadata 子元素後面。 Metadata 元素最多可以包含 6 個子元素 DisplayName、Description、MoreInfo、License、ReleaseNotes 和 Icon。 這些子元素會對應至 Extension.vsixmanifest 檔案之 Metadata 元素的 DisplayName、Description、MoreInfo、License、ReleaseNotes 和 Icon 子元素。

當您建立 vsixlangpack 檔案時，必須將 Include in Vsix 屬性設定為 true。 否則，將會忽略當地語系化的安裝文字。

設定 [包含在 Vsix] 屬性

  1. 在 [方案總管] 中，以滑鼠右鍵按一下 Extension.vsixlangpack 檔，然後按一下 [屬性]。

  2. 在 [屬性方格] 中，按下 [包含在 Vsix] 中，並將其值設定為 true。

範例

描述

下列範例顯示 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>

另請參閱

標題 描述
VSIX 語言套件結構描述 2.0 參考 VSIX 語言套件描述 .vsix 部署檔的當地語系化資訊。
VSIX 封裝的結構 描述 vsix 套件的結構和內容。
當地語系化功能表命令 展示如何在延伸模組中當地語系化其他文字資源。