Compartilhar via

Designer de manifesto do VSIX

  • Artigo

Modifica um arquivo de manifesto de pacote VSIX, que define o comportamento de instalação para uma extensão do Visual Studio.

O VSIX Manifest Designer mapeia para o esquema VSIX subjacente. Cada elemento no esquema pode ser definido usando um controle correspondente no designer. Para obter mais informações sobre o esquema, consulte VSIX Extension Schema 2.0 Reference.

Para abrir o VSIX Manifest Designer, localize um arquivo source.extension.vsixmanifest no Gerenciador de Soluções e abra o arquivo. Se o arquivo não contiver XML válido, o designer de manifesto não será aberto.

Observação

O arquivo source.extension.vsixmanifest é enviado para extension.vsixmanifest quando o pacote é criado.

Lista de elementos de interface do usuário

O VSIX Manifest Designer contém quatro seções que correspondem a esses elementos de nível superior do esquema:

  • Metadados
  • Destinos de instalação
  • Ativos
  • Dependências

A área de título contém os seguintes controles:

  • Nome do Produto descreve o nome da extensão.
  • A ID do Produto especifica as informações de identificação exclusivas para este pacote.
  • Author especifica o nome do autor da extensão.
  • Version especifica o número da versão da extensão.

A guia Metadados contém os seguintes controles:

  • Descrição fornece uma descrição de texto da extensão, a ser exibida no Extension Manager.
  • Language especifica o idioma padrão do pacote, que corresponde aos dados textuais no manifesto. O Language atributo segue a convenção de código de localidade CLR (Common Language Runtime) para assemblies de recursos, por exemplo, en-us, en, fr-fr. Por padrão, o valor é neutro, o que significa que o pacote será executado em qualquer versão de idioma do Visual Studio.
  • License especifica o arquivo de texto que contém a licença do usuário, se houver uma.
  • Icon especifica o arquivo gráfico (.png, .bmp, .jpeg .ico) que contém o ícone a ser exibido no Extension Manager, se um ícone estiver presente. A imagem do ícone deve ter 32x32 pixels ou é redimensionada para essas dimensões. Se nenhum ícone for especificado, o Extension Manager usará um ícone padrão.
  • A imagem de visualização especifica o arquivo gráfico (.png, .bmp, .jpeg .ico) que contém a imagem de visualização a ser exibida no Gerenciador de Extensões, se uma imagem de visualização estiver presente. A imagem de visualização deve ter 200x200 pixels. Se nenhuma imagem de visualização for especificada, o Extension Manager usará uma imagem padrão.
  • Tags adiciona tags de texto a serem usadas para dicas de pesquisa.
  • As Notas de Versão especificam um arquivo (.txt, .rtf) que contém notas de versão. Também usa a URL de um site que exibe as notas de versão.
  • Guia de Introdução especifica um arquivo (.txt, .rtf) que contém informações sobre como usar a extensão ou o conteúdo no pacote VSIX. Este guia é exibido quando a instalação da extensão é concluída. Também pega a URL de um site que exibe o guia.
  • Mais informações URL especifica a URL de um site que contém informações adicionais sobre o produto.

A guia Instalar destinos contém os seguintes controles:

  • O tipo de instalação lista a extensão do Visual Studio e o SDK de extensão como tipos de instalação de destino. As opções diferem, dependendo do tipo escolhido.

    • Visual Studio Extension lista os elementos InstallationTarget que descrevem como o pacote pode ser instalado e em quais produtos do Visual Studio essa extensão pode ser instalada. Cada produto é identificado separadamente pelo nome e por uma versão ou intervalo de versões. Os produtos podem ser adicionados à lista, modificados e excluídos. O nome e a versão de um produto correspondem aos atributos Id e Version do elemento InstallationTarget associado.

      • O intervalo de versões é [12.0, 14.0] e usa a seguinte notação:
        • [ - versão mínima inclusive
        • ] - versão máxima inclusive
        • ( - versão mínima exclusiva
        • ) - versão máxima exclusiva
        • Versão única # - somente a versão especificada

    • O SDK de extensão especifica uma instalação global que não tem escopo para um produto e uma versão específicos. O Identificador de Plataforma de Destino é a plataforma, como "Windows", que você está segmentando. Target Platform Version é a versão, como 8.0, da sua plataforma de destino. Nome do SDK e Versão do SDK são o nome e o número da versão do SDK, respectivamente.

  • Este VSIX é instalado para todos os usuários (requer elevação na instalação). Se você marcar essa caixa de seleção, a extensão será instalada para todos os usuários; caso contrário, ele será instalado apenas para o usuário atual.

  • Este VSIX é instalado pelo Windows Installer. Se você marcar essa caixa de seleção, a extensão será instalada pelo Windows Installer (arquivo .msi), caso contrário, será instalada como um pacote VSIX típico (arquivo .vsix).

A guia Ativos contém os seguintes controles:

  • Lista de ativos lista os elementos Asset que descrevem a extensão ou os elementos de conteúdo que este pacote apresenta. Cada extensão ou elemento de conteúdo é listado separadamente por origem, tipo e caminho. Extensões e elementos de conteúdo podem ser adicionados à lista, modificados e excluídos. O tipo e o Type caminho de uma extensão ou elemento de conteúdo correspondem aos atributos e Path do elemento associado Asset . Os seguintes tipos são conhecidos:

    • Microsoft.VisualStudio.Package
    • Microsoft.VisualStudio.MefComponent
    • Microsoft.VisualStudio.ToolboxControl
    • Microsoft.VisualStudio.Samples
    • Microsoft.VisualStudio.ProjectTemplate
    • Microsoft.VisualStudio.ItemTemplate
    • Microsoft.VisualStudio.Assembly
    • Microsoft.ExtensionSDK

    Para adicionar ou editar um ativo, você deve especificar o tipo de ativo, se o ativo é um projeto na solução atual ou um arquivo no sistema de arquivos e o nome do projeto. Você também pode especificar o nome da pasta na qual será incorporado.

    Você também pode criar seus próprios tipos e dar-lhes nomes exclusivos.

A guia Dependências contém os seguintes controles :

  • Name, Source e Version Range lista os elementos Dependency deste pacote, que são outros pacotes dos quais este pacote depende. Se um pacote de dependência for especificado, ele deverá ser instalado antes que esse pacote seja instalado; caso contrário, este pacote deve instalá-lo.

    Os pacotes de dependência são especificados por identificador, nome, intervalo de versão, origem e como a dependência deve ser resolvida. Cada pacote de dependência é listado separadamente por nome, versão e origem. Os pacotes de dependência podem ser adicionados à lista, modificados e excluídos.

    O identificador deve corresponder ao ID atributo dos metadados do pacote de dependência. A origem pode ser um projeto na solução atual, uma extensão atualmente instalada ou um arquivo. A configuração Como a dependência é resolvida pode ser o caminho relativo de um pacote aninhado ou a URL do local de download da dependência. O ID, a versão e a resolução do pacote de dependência correspondem aos Idatributos , Versione Location do elemento associado Dependency .

Confira também