Localizzazione di pacchetti VSIX
È possibile localizzare un pacchetto VSIX creando un file Extension.vsixlangpack per ogni lingua di destinazione e inserendo i file nella cartella corretta. Quando un pacchetto localizzato viene installato, il nome localizzato dell'estensione viene visualizzato insieme con una descrizione localizzata. Se si fornisce un file di licenza localizzato, o un URL che fa riferimento alle informazioni localizzate, anche questi vengono visualizzati.
Se il contenuto il pacchetto VSIX include un package VS che aggiunge i comandi di menu o di un'altra interfaccia utente, vedere Procedura: localizzare i comandi di menu per informazioni sulla localizzazione nuovi elementi di interfaccia utente.
Struttura di directory
Quando un utente installa un'estensione, Gestione estensioni cerca nel livello principale del pacchetto VSIX una cartella il cui nome corrisponda alle impostazioni locali del sistema del computer di destinazione. Se Gestione estensioni trova un file con estensione vsixlangpack nella cartella, sostituisce con i valori localizzati di quel file i valori corrispondenti del file con estensione vsixmanifest. Questi valori vengono visualizzati durante l'installazione dell'estensione. Nell'esempio seguente viene illustrata la struttura di directory per un pacchetto VSIX localizzato in spagnolo (es-ES) e francese (fr-FR).
MyExtension.dll
Extension.vsixmanifest
[Content_Types].xml
es-ES
Extension.vsixlangpack
fr-FR
Extension.vsixlangpack
Nota
I modelli di progetto VSIX-supportati in Visual Studio SDK generano un manifesto VSIX e lo nome source.extension.vsixmanifest.Quando Visual Studio viene compilato il progetto, copiare il contenuto del file Extension.VsixManifest nel pacchetto VSIX.
File Extension.vsixlangpack
Il file Extension.vsixlangpack segue lo schema di Language Pack VSIX. Questo schema presenta un elemento radice VSIXLanguagePack e i quattro elementi figlio seguenti: LocalizedName, LocalizedDescription, MoreInfoURL e License. Questi elementi figlio corrispondono a nome, a descrizione, a MoreInfoURLe gli elementi figlio di licenza dell'elemento di identificatore del file Extension.vsixmanifest.
Quando si crea un file di vsixlangpack, è necessario impostare la proprietà di Include in Vsix a true. In caso contrario, il testo di installazione localizzato verrà ignorato.
Per impostare l'inclusione nella proprietà VSIX
In Esplora soluzioni, fare clic con il pulsante destro del mouse sul file Extension.vsixlangpack quindi fare clic su Proprietà.
Nella griglia delle proprietà, fare clic Importare in VSIXe impostare il valore su true.
Esempio
Descrizione
Le parti rilevanti diesempio di file Extension.vsixmanifest, insieme al file Extension.vsixlangpack corrispondente per lo Spagnolo. Se le impostazioni locali di sistema del computer di destinazione sono impostate sulla lingua spagnola, i valori del Language Pack sostituiscono i valori del manifesto.
Codice
[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>
Vedere anche
Riferimenti
Elemento VSIXLanguagePack (schema Language Pack VSIX)