VSIX パッケージのローカライズ

VSIX パッケージをローカライズするには、ターゲット言語ごとに Extension.vsixlangpack ファイルを作成し、正しいフォルダーに配置します。 ローカライズされたパッケージがインストールされると、ローカライズされた説明と共に拡張機能のローカライズされた名前が表示されます。 ローカライズされたライセンス ファイル、またはローカライズされた情報を指す URL を指定すると、それらのファイルも表示されます。

VSIX パッケージのコンテンツに、メニュー コマンドまたはその他の UI を追加する VSPackage が含まれている場合、新しい UI 要素のローカライズについては、「 メニュー コマンドのローカライズ 」を参照してください。

ディレクトリの構造

ユーザーが拡張機能をインストールすると、 拡張機能と更新プログラム は、VSIX パッケージの最上位レベルで、ターゲット コンピューターの Visual Studio ロケールと一致する名前のフォルダーを確認します。 Extensions and Updates でフォルダー内の .vsixlangpack ファイルが見つかると、そのファイル内のローカライズされた値が .vsixmanifest ファイル内の対応する値に置き換えられます。 これらの値は、拡張機能のインストール時に表示されます。 次の例は、スペイン語 (es-ES) とフランス語 (fr-FR) にローカライズされた VSIX パッケージのディレクトリ構造を示しています。

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

Extension.vsixlangpack ファイル

Extension.vsixlangpack ファイルは、VSIX Language Pack スキーマ 2.0 に従います。 このスキーマには PackageLanguagePackManifestがあり、その直後に Metadata 子要素が続きます。 Metadata 要素には、最大 6 個の子要素、 DisplayName、 Description、 MoreInfo、 License、 ReleaseNotes、および Iconを含めることができます。 これらの子要素は、DisplayName ファイルのDescription要素のMoreInfo、License、ReleaseNotes、Icon、Metadata、および子要素に対応します。

vsixlangpack ファイルを作成するときは、 Include in Vsix プロパティを true に設定する必要があります。 それ以外の場合、ローカライズされたインストール テキストは無視されます。

Vsix に含めるプロパティを設定するには

1. ソリューション エクスプローラーで Extension.vsixlangpack ファイルを右クリックし、[プロパティ] をクリックします。

2. プロパティ グリッドで、[Vsix に含める] をクリックし、その値をtrueに設定します。

Example

Description

次の例は、 Extension.vsixmanifest ファイルの関連部分を示しています。 このファイルには、スペイン語用の対応する Extension.vsixlangpack ファイルも含まれています。 ターゲット コンピューターの Visual Studio ロケールがスペイン語に設定されている場合、言語パックの値によってマニフェストの値が置き換えられます。

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>

こちらも参照ください