次の方法で共有

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

  • [アーティクル]

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

コンテンツがVSIX パッケージ メニュー コマンドやそのほかの UI を追加する VSPackage が含まれている場合は新しい UI 要素をローカライズする方法の詳細については 方法: メニュー コマンドをローカライズする を参照してください。

ディレクトリ構造

ユーザーが拡張機能をインストールするとき、拡張機能マネージャーは、VSIX パッケージのトップレベルをチェックして、ターゲット コンピューターのシステム ロケールに一致する名前のフォルダーを探します。 そのフォルダーに .vsixlangpack ファイルが見つかった場合、拡張機能マネージャーは、.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 という名前を付けます。プロジェクトをビルドするとVSIX パッケージの Extension.VsixManifest にそのファイルの内容をコピーします。

Extension.vsixlangpack ファイル

Extension.vsixlangpack ファイルは、VSIX Language Pack スキーマに準拠しています。 このスキーマには、VSIXLanguagePack ルート要素と、LocalizedName、LocalizedDescription、MoreInfoURL、および License の 4 つの子要素があります。 これらの子要素は 名前説明MoreInfoURL にExtension.vsixmanifest の 識別子 の要素の ライセンス の子要素です。

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

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

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

  2. プロパティ グリッドで[ENT3ENT] をクリックしtrue に値を設定します。

例

Description

Extension.vsixmanifest の次の例の関連部分はスペイン語に対応する Extension.vsixlangpack ファイルとともにファイル。 ターゲット コンピューターのシステム ロケールがスペイン語に設定されている場合は、マニフェストの値が Language Pack の値で置き換えられます。

コード

[入力] Extension.vsixmanifest

<?xml version="1.0" encoding="utf-8"?>
<VSIX ...>
  <Identifier ...>
    <Name>Family Tree</Name>
    <Description>This extension places a custom treeview control in the toolbox that is optimized for handling family tree information.</Description>
    <License>EULA.rtf</License>
    <MoreInfoURL>https://www.contoso.com/products/FamilyTree.htm</MoreInfoURL>
    ...
  </Identifier>
  <References .../>
  <Content .../>
</VSIX>

[Extension.vsixlangpack]

<?xml version="1.0" encoding="utf-8"?>
<VsixLanguagePack Version="1.0.0" xmlns="https://schemas.microsoft.com/developer/vsx-schema-lp/2010">
  <LocalizedName>Arbol de Familia</LocalizedName>
  <LocalizedDescription> Esta extensión pone control personalizado en la caja de herramientas por manejar información de familia.</LocalizedDescription>
  <License>es\Eula.rtf</License>
  <MoreInfoUrl> https://www.contoso.com/products/es/ArbolDeFamilia.htm</MoreInfoUrl>
</VsixLanguagePack>

参照

関連項目

VSIXLanguagePack 要素 (VSIX Language Pack スキーマ)

概念

VSIX プロジェクト テンプレート

その他の技術情報

VSIX パッケージの構造