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

VSIX パッケージのローカライズは、対象言語ごとに Extension.vsixlangpack ファイルを作成し、これらを適切なフォルダーに配置することによって行うことができます。 ローカライズされたパッケージをインストールすると、拡張機能のローカライズされた名前がローカライズされた説明と共に表示されます。 ローカライズされたライセンス ファイル、またはローカライズされた情報を示す URL を指定すると、それらも表示されます。

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

ディレクトリの構造

ユーザーが拡張機能をインストールすると、[拡張機能と更新プログラム] によって、ターゲット コンピューターの Visual Studio ロケールに一致する名前を持つフォルダーの VSIX パッケージの最上位レベルがチェックされます。 [拡張機能と更新プログラム] によってフォルダー内の .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 言語パックのスキーマ 2.0 に従います。 このスキーマには PackageLanguagePackManifest があり、その直後に 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>

関連項目