Partilhar via


Localizando pacotes VSIX

Você pode localizar um pacote VSIX criando um arquivo de Extension.vsixlangpack para cada idioma de destino e, em seguida, colocá-los 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 localizada ou uma URL que aponta para informações localizadas, elas também são exibidas.

Se o conteúdo do pacote VSIX inclui um VSPackage que adiciona comandos de menu ou outra interface de usuário, consulte Como: localizar os comandos de Menu para obter informações sobre a localização de novos elementos de interface do usuário.

Estrutura de diretórios

Quando um usuário instala uma extensão, Extension Manager verifica o nível superior do pacote VSIX para uma pasta cujo nome corresponde à localidade de sistema do computador de destino. Se Extension Manager localiza um .vsixlangpack de arquivos na pasta, ele substitui os valores localizados nesse arquivo para os 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ório para um pacote VSIX traduzida para Espanhol (es-ES) e francês (fr-FR).

    MyExtension.dll

        Extension.vsixmanifest

        [Content_Types]. XML

        es-ES.

            Extension.vsixlangpack

        fr-FR.

            Extension.vsixlangpack

Dica

Os modelos de projeto com suporte VSIX a SDK do Visual Studio gerar um manifesto VSIX e nomeie-o como 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 de Extension.vsixlangpack segue o Esquema de pacote de idioma do VSIX. Este esquema tem um VSIXLanguagePack elemento raiz e esses elementos de quatro filhos: LocalizedName, LocalizedDescription, MoreInfoURL, e licença. Esses elementos filho correspondem do nome, Descrição, MoreInfoURL, e licença elementos filho do identificador elemento do arquivo Extension.vsixmanifest.

Quando você cria um arquivo de vsixlangpack, você deve definir o Include in Vsix propriedade para true. Caso contrário, o texto de instalação localizado será ignorado.

Para definir a incluir na propriedade Vsix

  1. Em Solution Explorer, clique com o botão direito no arquivo Extension.vsixlangpack e, em seguida, clique em Propriedades.

  2. Na grade de propriedades, clique em incluir na Vsixe defina seu valor como true.

Exemplo

Descrição

O exemplo a seguir mostra as partes relevantes de um arquivo de Extension.vsixmanifest, junto com o arquivo Extension.vsixlangpack correspondente para espanhol. Os valores do pacote de idioma substitua os valores do manifesto, se a localidade do sistema do computador de destino é definida para espanhol.

Código

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

Consulte também

Referência

Elemento de VSIXLanguagePack (VSIX Language Pack esquema)

Conceitos

Modelo de projeto VSIX

Outros recursos

Anatomia de um pacote VSIX