Localizar pacotes VSIX

Artigo
01/13/2024

Você pode localizar um pacote VSIX criando um arquivo Extension.vsixlangpack para cada idioma de destino e, em seguida, colocando-os na pasta correta. Quando um pacote localizado é instalado, o nome localizado da extensão é exibido junto com uma descrição localizada. Se você fornecer um arquivo de licença localizado ou uma URL que aponte para informações localizadas, elas também serão exibidas.

Se o conteúdo do pacote VSIX incluir um VSPackage que adiciona comandos de menu ou outra interface do usuário, consulte Localizar comandos de menu para obter informações sobre como localizar os novos elementos da interface do usuário.

Estrutura do diretório

Quando um usuário instala uma extensão, Extensões e Atualizações verifica o nível superior do pacote VSIX para uma pasta cujo nome corresponde à localidade do Visual Studio do computador de destino. Se Extensões e Atualizações localizar um arquivo .vsixlangpack na pasta, ele substituirá os valores localizados nesse arquivo pelos valores correspondentes no arquivo .vsixmanifest . Esses valores são exibidos quando a extensão está sendo instalada. O exemplo a seguir mostra a estrutura de diretórios de um pacote VSIX localizado em espanhol (es-ES) e francês (fr-FR).

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

Observação

Os modelos de projeto com suporte VSIX no SDK do Visual Studio geram um manifesto VSIX e o nomeiam source.extension.vsixmanifest. Quando o Visual Studio cria o projeto, ele copia o conteúdo desse arquivo para Extension.VsixManifest no pacote VSIX.

O arquivo Extension.vsixlangpack

O arquivo Extension.vsixlangpack segue o esquema VSIX Language Pack 2.0. Esse esquema tem um , que é imediatamente seguido por um PackageLanguagePackManifestMetadata elemento filho. O elemento Metadata pode conter até 6 elementos filho, , , DisplayNameDescriptionMoreInfo, , LicenseReleaseNotese Icon. Esses elementos filho correspondem aos DisplayNameelementos , , , , ReleaseNotesLicenseMoreInfoDescriptione Icon filho do Metadata elemento do arquivo Extension.vsixmanifest.

Ao criar um arquivo vsixlangpack, você deve definir a Include in Vsix propriedade como true. Caso contrário, o texto de instalação localizado será ignorado.

Para definir a propriedade Include in Vsix

No Gerenciador de Soluções, clique com o botão direito do mouse no arquivo Extension.vsixlangpack e clique em Propriedades.
Na Grade de propriedades, clique em Incluir no Vsix e defina seu valor como true.

Exemplo

Descrição

O exemplo a seguir mostra partes relevantes de um arquivo Extension.vsixmanifest . O arquivo também inclui o arquivo Extension.vsixlangpack correspondente para espanhol. Os valores do pacote de idiomas substituem os valores do manifesto se a localidade do Visual Studio do computador de destino estiver definida como espanhol.

Código

[Extensão.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>

[Extensão.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>

Confira também

Título	Descrição
Referência do esquema 2.0 do pacote de idiomas VSIX	Um pacote de idiomas VSIX descreve as informações de localização de um arquivo de implantação .vsix.
Anatomia de um pacote VSIX	Descreve a estrutura e o conteúdo de um pacote vsix.
Localizar comandos de menu	Mostra como localizar outros recursos de texto em uma extensão.

Compartilhar via