Implantação de VSIX
Você pode usar o formato VSIX no pacote de modelos de projeto, item de componentes de modelos, pacotes de integração de Visual Studio, Managed Extensibility Framework (MEF), caixa de ferramentas controles, assemblies e tipos personalizados (Isso inclui páginas de inicialização personalizada). O formato VSIX usa a implantação baseada em arquivo e não suporta gravação no Global Assembly Cache (GAC) ou no registro do sistema. Recomendamos que você use a implantação de VSIX para os tipos de extensões que ele suporta.
Ao carregar as extensões que tenham o formato do pacote VSIX para o Galeria de Visual Studio site da Web, os usuários podem usar Extension Manager para localizar e instalá-las. Para obter mais informações sobre Extension Manager, consulte Gerenciando extensões e atualizações para Visual Studio.
O formato VSIX não oferece suporte para a instalação de macros, suplementos ou trechos de código. Ele também não suporta outros cenários como, por exemplo, gravando chaves de registro durante a instalação. Para uma comparação de outras estratégias de implantação disponíveis, consulte Implantação de extensão do Visual Studio.
Para evitar conflitos quando você está desenvolvendo uma extensão, recomendamos que você desinstale as versões anteriores da extensão e desinstalar ou desativa as extensões potencialmente conflitantes.
O pacote VSIX
Um pacote VSIX é um arquivo compactado que segue o padrão Open Packaging Conventions (OPC). O pacote contém os binários e arquivos de suporte, junto com um [Content_Types]. XML de arquivo e um arquivo de manifesto do .vsix. Um pacote VSIX pode conter a saída de vários projetos, ou até mesmo vários pacotes que possuem seus próprios manifestos. Para obter mais informações sobre o conteúdo de um pacote VSIX, consulte Anatomia de um pacote VSIX.
A maioria dos modelos de projeto na SDK do Visual Studio criar um pacote VSIX para você quando você compila seu projeto. Você também pode criar um pacote VSIX em torno de sua extensão, criando um projeto de VSIX em branco e, em seguida, adicionando a sua extensão a ele. Para obter mais informações sobre como criar um pacote VSIX, consulte Modelo de projeto VSIX.
Dica
Nomes dos arquivos que estão incluídos em pacotes VSIX não devem incluir espaços nem caracteres reservados na especificação Uniform Resource Identifiers (URI), como definido em [RFC2396].
Local de instalação
Durante a instalação, Extension Manager descompacta o arquivo .vsix e coloca o seu conteúdo em %LocalAppData%\Microsoft\VisualStudio\10.0\Extensions\Manual\produto\versão\. Empresa, produto, e versão são especificados no arquivo extension.vsixmanifest e corresponde ao espaço para nome, nome do projeto e número de versão são definidas nas propriedades do projeto.
Por padrão, a instalação se aplica somente ao usuário atual, como % LocalAppData % é um diretório específico do usuário. No entanto, se você definir a AllUsers elemento do manifesto para True, a extensão será instalada em.. \Da pasta de instalação Visual Studio\Common7\IDE\Extensions\empresa\produto\versão\ e estará disponível para todos os usuários do sistema.
Tratamento de dependência
Se um usuário tentar instalar uma extensão que possui dependências, o instalador verifica se os assemblies necessários estão instalados no sistema de usuário. Se os assemblies necessários não forem encontrados, Extension Manager mostra ao usuário uma lista dos assemblies ausentes.
Se o manifesto de extensão inclui um ou mais referência elementos, Extension Manager compara o manifesto de cada referência para as extensões que estão instalados no sistema e instala o extensão referenciados, se já não estiver instalado. Se uma versão anterior de uma extensão referenciada estiver instalada, a versão mais recente substitui-lo.
Por padrão em uma solução multi-projetos, se um projeto que produz a um pacote VSIX inclui uma referência a outro projeto na mesma solução, ele inclui as dependências do projeto. Você pode substituir esse comportamento clicando-se a referência para o projeto interno e, em seguida, no Propriedades janela, definindo a Saída grupos incluídos em VSIX propriedade para BuiltProjectOutputGroup.
Publicação
Você pode distribuir um pacote VSIX, colocando- Galeria de Visual Studio , de modo que ele está disponível para usuários de Visual Studio por meio do site Extension Manager. Como alternativa, você pode carregar o pacote para outro site ou para um compartilhamento de rede, para que os usuários podem instalar a extensão duas vezes no arquivo .vsix e seguindo as instruções.
Galerias de Private
Você pode compartilhar os controles, modelos e ferramentas para que desenvolver dentro de uma organização através de uma intranet, postando-os a uma galeria particular. Para obter mais informações, consulte Galerias de Private.
Tópicos relacionados
Título |
Descrição |
|---|---|
Descreve os componentes de um pacote VSIX. |
|
Fornece instruções passo a passo sobre como empacotar e publicar uma extensão. |
|
Explica como fornecer texto localizado para o processo de instalação usando arquivos de extension.vsixlangpack. |
|
Descreve como atualizar uma extensão em seu sistema e como implantar uma atualização para uma extensão de Visual Studio existente. |
|
Descreve como adicionar referências a pacotes de implantação VSIX. |