Localizzazione di pacchetti VSIX

Articolo
01/13/2024

È possibile localizzare un pacchetto VSIX creando un file Extension.vsixlangpack per ogni lingua di destinazione e quindi inserendoli nella cartella corretta. Quando viene installato un pacchetto localizzato, il nome localizzato dell'estensione viene visualizzato insieme a una descrizione localizzata. Se si specifica un file di licenza localizzato o un URL che punta a informazioni localizzate, vengono visualizzate anche.

Se il contenuto del pacchetto VSIX include un PACCHETTO VSPackage che aggiunge comandi di menu o un'altra interfaccia utente, vedere Localizzare i comandi di menu per informazioni sulla localizzazione dei nuovi elementi dell'interfaccia utente.

Struttura di directory

Quando un utente installa un'estensione, Estensioni e Aggiornamenti controlla il livello principale del pacchetto VSIX per una cartella il cui nome corrisponde alle impostazioni locali di Visual Studio del computer di destinazione. Se Extensions e Aggiornamenti trova un file con estensione vsixlangpack nella cartella , sostituisce i valori localizzati in tale file per i valori corrispondenti nel file con estensione vsixmanifest. Questi valori vengono visualizzati quando viene installata l'estensione. L'esempio seguente illustra 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 supportati da VSIX in Visual Studio SDK generano un manifesto VSIX e denominano source.extension.vsixmanifest. Quando Visual Studio compila il progetto, copia il contenuto del file in Extension.VsixManifest nel pacchetto VSIX.

File Extension.vsixlangpack

Il file Extension.vsixlangpack segue lo schema del Language Pack VSIX 2.0. Questo schema ha un PackageLanguagePackManifestoggetto , che viene immediatamente seguito da un Metadata elemento figlio. L'elemento Metadata può contenere fino a 6 elementi figlio, DisplayName, Description, MoreInfoLicense, ReleaseNotes, e Icon. Questi elementi figlio corrispondono agli DisplayNameelementi figlio , MoreInfoDescription, License, ReleaseNotes, e Icon dell'elemento Metadata del file Extension.vsixmanifest.

Quando si crea un file vsixlangpack, è necessario impostare la Include in Vsix proprietà su true. In caso contrario, il testo dell'installazione localizzato verrà ignorato.

Per impostare la proprietà Includi in Vsix

In Esplora soluzioni fare clic con il pulsante destro del mouse sul file Extension.vsixlangpack e quindi scegliere Proprietà.
Nella griglia delle proprietà fare clic su Includi in Vsix e impostarne il valore su true.

Esempio

Descrizione

L'esempio seguente mostra parti pertinenti di un file Extension.vsixmanifest . Il file include anche il file Extension.vsixlangpack corrispondente per lo spagnolo. I valori del Language Pack sostituiscono i valori del manifesto se le impostazioni locali di Visual Studio del computer di destinazione sono impostate su Spagnolo.

Codice

[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>

Vedi anche

Posizione	Descrizione
Informazioni di riferimento sullo schema VSIX Language Pack 2.0	Un Language Pack VSIX descrive le informazioni di localizzazione di un file di distribuzione con estensione vsix.
Anatomia di un pacchetto VSIX	Descrive la struttura e il contenuto di un pacchetto vsix.
Localizzare i comandi di menu	Illustra come localizzare altre risorse di testo in un'estensione.

Condividi tramite