How to: Componentes do pacote para usar o Visual Studio Content Installer

Artigo
08/04/2011

O instalador de conteúdo Visual Studio fornece uma maneira de implantar as macros, suplementos e código trechos de código para estender o Visual Studio. Para obter mais informações sobre outras estratégias de implantação, consulte Implantação de extensão do Visual Studio.

Para tornar uma extensão instalável usando o Visual Studio Content Installer, o pacote de extensão em um arquivo. vsi, que é normalmente conhecido como um componente de comunidade. O Visual Studio Content Installer copia automaticamente os itens componentes da comunidade para os diretórios corretos no computador de um desenvolvedor para que os itens são exibidos nas caixas de diálogo correto no Visual Studio.

Para usar o Visual Studio Content Installer para instalar os componentes da comunidade, você deve criar um arquivo. vscontent para o componente. Depois de criar o arquivo. vscontent, você compacta os arquivos de componente e o arquivo. vscontent em um arquivo. zip e alterar a extensão de nome de arquivo do. zip para. vsi. Em seguida, você pode distribuir o arquivo. vsi para outros desenvolvedores usando qualquer método que você decidir como disponibilizar o arquivo para download da Web, enviando o arquivo como um anexo de email ou enviar o arquivo em um compartilhamento de rede.

.Arquivos de vscontent

.Vscontent arquivos usam XML que se baseia o Referência de esquema de instalador Visual Studio conteúdo para descrever os componentes que você criou e pretende compartilhar. No mínimo, o arquivo. vscontent identifica o tipo de componentes e a versão do Visual Studio que o componens deve ser usado com. Após você ter criado um arquivo. vscontent, você pode criar o arquivo. vsi que Visual Studio Content Installer usará para instalar os componentes no computador de. um desenvolvedor

Para criar um arquivo básico vscontent

Sobre o arquivo , aponte para nova e, em seguida, clique em arquivo.
No Geral categoria, selecione Arquivo XML e, em seguida, clique em Abrir.
Criar um arquivo. vscontent de válido usando o Referência de esquema de instalador Visual Studio conteúdo.

Observação

XML de exemplo para os arquivos. vscontent pode ser encontrada nas seções de exemplo deste tópico.
Salve o arquivo. vscontent no mesmo diretório dos arquivos que estão relacionadas ao componente de comunidade.

Observação
XML de exemplo para os arquivos. vscontent pode ser encontrada nas seções de exemplo deste tópico.

Arquivos .VSI

Visual StudioConteúdo de arquivos do Installer (. vsi) são usados para trocar Visual Studio o conteúdo a comunidade de desenvolvedores. Um arquivo .vsi é um arquivo .zip renomeado que contém:

Um arquivo. vscontent XML que descreve o componente de comunidade.
Os arquivos para o componente.

O Visual Studio o instalador de conteúdo usa arquivos. vsi para instalar o conteúdo compartilhado para o local correto. Para obter mais informações sobre como instalar arquivos .VSI, consulte Como: Localizar e instalar componentes comunitários.

Alguns recursos do Visual Studio Content Installer exigem ferramentas adicionais ou serviços para implementar.

Para exibir informações do seu componente de comunidade no Editor de Visual Studio o instalador de conteúdo, você deve assinar o arquivo. vsi. Para obter mais informações, consulte Serviços de criptografia.
Para exibir um contrato de licença de usuário final (EULA) na Visual Studio o instalador de conteúdo, você deve incorporar essas informações no arquivo. zip. WinZip oferece suporte, incluindo informações incorporadas através do recurso de comentário. Para obter mais informações sobre o WinZip, consulte http://www.winzip.com. Para obter mais informações sobre o recurso de comentário, consulte o arquivo de Ajuda do WinZip.

Para criar um arquivo. vsi de básico

Se você não tiver feito isso, crie um arquivo. vscontent de válido para o componente. Para obter mais informações, consulte a seção.Arquivos de VSCONTENT encontradas anteriormente neste tópico.
Em Windows Explorer, selecione os arquivos que são necessários para o componente, incluindo o arquivo. vscontent.
Os arquivos selecionados com o botão direito, aponte para Enviar parae clique em pasta compactada (zipada).

csharp , jsharp , vb ou xml
Content with a FileContentType value of Addin , Macro Project , and Toolbox Control do not require any attributes.

Exemplo

O exemplo a seguir mostra um arquivo. vscontent para um arquivo. vsi que contém um add-in. O <ContentVersion> elemento está definido como 2.0, que significa que o suplemento só é compatível com versões de Visual Studio 9.0 e 10.0.

Os seguintes arquivos devem ser incluídos no arquivo .vsi para este conteúdo:

Um arquivo .vscontent com um código XML como o mostrado neste exemplo.
O arquivo de registro do add-in MyAddin.Addin.
O arquivo .dll compilado do add-in MyAddin.dll.

Os arquivos do add-in são instalados no seguinte diretório:

n:\... Documentos\Visual studio <versão> \Addins\

Para exemplos adicionais, consulte Como: Publicar modelos de projeto e Como: Publicar trechos de código.

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005"> 
    <Content>
        <FileName>MyAddin.Addin</FileName>
        <FileName>MyAddin.dll</FileName>
        <DisplayName>Example Add-in</DisplayName>
        <Description>An add-in created for this example.</Description>
        <FileContentType>Addin</FileContentType>
        <ContentVersion>2.0</ContentVersion>
    </Content>
</VSContent>

O exemplo a seguir mostra um arquivo. vscontent para um arquivo. vsi que contenha um projeto de macro que pode ser usado com versões de Visual Studio 8.0, 9.0 e 10.0. Os seguintes arquivos devem ser incluídos no arquivo .vsi para este conteúdo:

Um arquivo .vscontent com um código XML como o mostrado neste exemplo.
O arquivo da macro MyMacroProject.vsmacros.

O arquivo da macro é instalado no seguinte diretório:

n:\... Documentos\Visual studio <versão> \Projects\VSMacros80\

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
    <Content>
        <FileName>MyMacroProject.vsmacros</FileName>
        <DisplayName>My Macro Project</DisplayName>
        <Description> A macro project created for this example.</Description>
        <FileContentType>Macro Project</FileContentType>
        <ContentVersion>1.0</ContentVersion>
    </Content>
</VSContent>