Lokalisieren von VSIX-Paketen

Artikel
01/13/2024

Sie können ein VSIX-Paket lokalisieren, indem Sie eine Extension.vsixlangpack-Datei für jede Zielsprache erstellen und diese dann in den richtigen Ordner einfügen. Wenn ein lokalisiertes Paket installiert wird, wird der lokalisierte Name der Erweiterung zusammen mit einer lokalisierten Beschreibung angezeigt. Wenn Sie eine lokalisierte Lizenzdatei oder eine URL angeben, die auf lokalisierte Informationen verweist, werden diese ebenfalls angezeigt.

Wenn der Inhalt, den Ihr VSIX-Paket enthält, ein VSPackage-Element enthält, das Menübefehle oder eine andere Benutzeroberfläche hinzufügt, finden Sie unter "Lokalisieren von Menübefehlen " Informationen zum Lokalisieren der neuen UI-Elemente.

Verzeichnisstruktur

Wenn ein Benutzer eine Erweiterung installiert, überprüft Erweiterungen und Updates die oberste Ebene des VSIX-Pakets auf einen Ordner, dessen Name mit dem Gebietsschema von Visual Studio des Zielcomputers übereinstimmt. Wenn Erweiterungen und Updates eine VSIXLANGpack-Datei im Ordner finden, ersetzt sie die lokalisierten Werte in dieser Datei durch die entsprechenden Werte in der VSIXMANIFEST-Datei . Diese Werte werden angezeigt, wenn die Erweiterung installiert wird. Das folgende Beispiel zeigt die Verzeichnisstruktur für ein VSIX-Paket, das in Spanisch (es-ES) und Französisch (fr-FR) lokalisiert ist.

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

Hinweis

Die VSIX-unterstützten Projektvorlagen im Visual Studio SDK generieren ein VSIX-Manifest und nennen es "source.extension.vsixmanifest". Wenn Visual Studio das Projekt erstellt, kopiert es den Inhalt dieser Datei in Extension.VsixManifest im VSIX-Paket.

Datei "Extension.vsixlangpack"

Die Datei Extension.vsixlangpack folgt dem VSIX Language Pack-Schema 2.0. Dieses Schema verfügt über ein PackageLanguagePackManifestuntergeordnetes Element, das unmittelbar auf ein Metadata untergeordnetes Element folgt. Das Metadata-Element kann bis zu 6 untergeordnete Elemente, DisplayName, , Description, MoreInfo, License, und ReleaseNotes.Icon Diese untergeordneten Elemente entsprechen den DisplayName, Description, , MoreInfo, License, ReleaseNotesund Icon untergeordneten Elementen des Metadata Elements der Datei Extension.vsixmanifest .

Wenn Sie eine Vsixlangpack-Datei erstellen, müssen Sie die Include in Vsix Eigenschaft auf true. Andernfalls wird der lokalisierte Installationstext ignoriert.

So legen Sie die Include in Vsix-Eigenschaft fest

Klicken Sie in Projektmappen-Explorer mit der rechten Maustaste auf die Datei "Extension.vsixlangpack" und dann auf "Eigenschaften".
Klicken Sie im Eigenschaftenraster auf "In Vsix einschließen", und legen Sie dessen Wert auf true.

Beispiel

BESCHREIBUNG

Das folgende Beispiel zeigt relevante Teile einer Extension.vsixmanifest-Datei . Die Datei enthält auch die entsprechende Extension.vsixlangpack-Datei für Spanisch. Die Werte aus dem Sprachpaket ersetzen die Werte aus dem Manifest, wenn das Gebietsschema von Visual Studio auf Spanisch festgelegt ist.

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>

Siehe auch

Titel	Beschreibung
VSIX Language Pack-Schema 2.0-Referenz	Ein VSIX-Sprachpaket beschreibt die Lokalisierungsinformationen einer VSIX-Bereitstellungsdatei.
Anatomie eines VSIX-Pakets	Beschreibt die Struktur und den Inhalt eines Vsix-Pakets.
Lokalisieren von Menübefehlen	Zeigt, wie Sie andere Textressourcen in einer Erweiterung lokalisieren.

Freigeben über