Lokalisieren von VSIX-Paketen
Sie lokalisieren ein VSIX-Paket, indem Sie eine Extension.vsixlangpack-Datei für jede Zielsprache erstellen und sie dann in den entsprechenden Ordnern ablegen. Ist ein lokalisiertes Paket bereits installiert, wird der lokalisierte Name der Erweiterung zusammen mit einer lokalisierten Beschreibung angezeigt. Wenn Sie eine lokalisierte Lizenzdatei oder eine auf lokalisierte Informationen verweisende URL angeben, wird sie ebenfalls angezeigt.
Wenn der Inhalt das VSIX-Paket VSPackage enthält, die Menübefehle oder ein anderes Benutzeroberfläche hinzufügen, finden Sie unter Gewusst wie: Suchen Sie Menübefehle Informationen über das Lokalisieren der neuen Benutzeroberflächenelemente.
Verzeichnisstruktur
Installiert ein Benutzer eine Erweiterung, wird von Erweiterungs-Manager geprüft, ob auf der obersten Ebene des VSIX-Pakets ein Ordner vorhanden ist, dessen Bezeichnung mit dem Systemgebietsschema des Zielcomputers übereinstimmt. Wird von Erweiterungs-Manager eine VSIXLANGPACK-Datei im Ordner gefunden, werden die entsprechenden Werte in der Datei durch die lokalisierten Werte der VSIXLANGPACK-Datei ersetzt. Diese Werte werden angezeigt, wenn die Erweiterung installiert wird. Im folgenden Beispiel wird die Verzeichnisstruktur für ein VSIX-Paket veranschaulicht, das in Spanisch (es-ES) und Französisch (fr-FR) lokalisiert wird.
MyExtension.dll
Extension.vsixmanifest
[Content_Types].xml
es-ES
Extension.vsixlangpack
fr-FR
Extension.vsixlangpack
Hinweis
Die VSIX-unterstützten in Projektvorlagen generieren Visual Studio SDK ein VSIX-Manifest und geben Sie dieser source.extension.vsixmanifest.Wenn Visual Studio das Projekt erstellt wird, kopiert er den Inhalt dieser Datei in Extension.VsixManifest im VSIX-Paket.
Die Extension.vsixlangpack-Datei
Die Extension.vsixlangpack-Datei entspricht dem VSIX-Schema für Language Packs. In diesem Schema sind das VSIXLanguagePack-Stammelement und diese vier untergeordneten Elemente enthalten: LocalizedName, LocalizedDescription, MoreInfoURL und License. Diese untergeordneten Elemente entsprechen den untergeordneten Elementen Name, Beschreibung, MoreInfoURLund Lizenz des Bezeichner-Elements der Datei " extension.vsixmanifest ".
Wenn Sie eine vsixlangpack Datei erstellen, müssen Sie die Include in Vsix-Eigenschaft auf truefestlegen. Andernfalls wird der Installation lokalisierter Text ignoriert.
So erstellen Sie das Kontrollkästchen in Vsix-Eigenschaft festlegen
In Projektmappen-Explorermit der rechten Maustaste auf die Extension.vsixlangpack-Datei, und klicken Sie dann auf Eigenschaften.
Im Eigenschaft-Raster auf Include in Vsixund legen Sie dessen Wert auf truefest.
Beispiel
Beschreibung
Im folgenden Beispiel wird die relevanten Teile einer Datei " extension.vsixmanifest " zusammen mit der entsprechende Extension.vsixlangpack-Datei für Spanisch angezeigt. Die Werte des Language Packs ersetzen die Werte des Manifests, wenn das Systemgebietsschema des Zielcomputers auf Spanisch festgelegt ist.
Code
[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>
Siehe auch
Referenz
VSIXLanguagePack-Element (Schema für VSIX-Language Pack)