Partilhar via

Passo a passo: Implantando um VSPackage

  • Artigo

Esta explicação passo a passo, você pode examinar uma forma básica para implantar um VSPackage.

Guia de Introdução

Use os dois computadores para esta explicação, da seguinte forma:

  • Um computador de desenvolvimento que possui Visual Studio e SDK do Visual Studio instalado.

  • Um computador de destino que tenha Visual Studio instalado, mas não tem SDK do Visual Studio instalado.

Dica

Se você tiver apenas um computador, você pode desenvolver e implantar no mesmo computador.No entanto, se fizer isso, você não pode limpar o registro do sistema usando o Redefinir a instância Visual Studio 2010 Experimental utilitário.Se você tiver instalado no computador do Virtual PC, você pode implantar em uma imagem virtual.

Para concluir este passo a passo, você deve instalar o SDL do Visual Studio 2010. Para obter mais informações sobre o SDK de Visual Studio, consulte Ampliando a visão geral de Visual Studio. Para descobrir como fazer o download do SDK do Visual Studio, consulte Visual Studio extensibilidade Developer Center no site do MSDN.

Locais para o modelo de projeto de pacote de Visual Studio

O modelo de projeto do pacote de Visual Studio pode ser encontrado em três locais diferentes de Novo projeto caixa de diálogo:

  1. Em Visual Basic extensibilidade. O idioma padrão do projeto é Visual Basic.

  2. Em C# extensibilidade. O idioma padrão do projeto é C#.

  3. Em outra extensibilidade de tipos de projeto. O idioma padrão do projeto é C++.

Criando um VSPackage básico

Primeiro, crie um VSPackage básico para implantar. Este VSPackage apenas abre uma caixa de diálogo em resposta a um comando de menu.

Para criar um VSPackage básico

  1. Criar um VSPackage chamado DeployPackage com o modelo de projeto do pacote de Visual Studio. Clique em OK.

  2. Sobre o Select a Programming Language , selecione Visual C# ou Visual Basic.

  3. Não altere os valores padrão sobre o Informações básicas de VSPackage página.

  4. Sobre o Selecionar opções de VSPackage , selecione Comando de Menu. Clique em Next.

  5. Alterar nome do comando para Meu comando implantar. Clique em Next.

  6. Clear projeto de teste de integração. Clique em Finish.

    O modelo gera a solução de DeployPackage.

Implantação do xcopy usando CodeBase

Uma forma de implantar um VSPackage é por meio da implantação do xcopy, o que é chamada após a ferramenta DOS que copia um arquivo para um local. Você apenas copia seu VSPackage para a pasta de sua preferência no computador de destino. Uma implantação como, por exemplo, isso certamente falhará, pois as chaves de registro do sistema apropriado não foram inicializadas no computador de destino.

Você pode inicializar o registro do sistema usando um arquivo. reg que contém os valores e as teclas desejadas. Você pode gerar o arquivo. reg para seu VSPackage usando o utilitário regpkg. exe.

Dica

A melhor maneira de registrar os pacotes em Visual Studio está usando arquivos de .pkgdef.Isso permite que a implantação de extensão sem precisar acessar o registro do sistema.Pkgdef arquivos são criados usando o Utilitário de CreatePkgDef.

Para gerar o arquivo de registro do sistema

  1. No System Definition Modelcomando janela, navegue até a pasta que contém DeployPackage.dll. Ele está localizado normalmente no diretório de \bin\Debug\ do projeto.

  2. Digite a seguinte linha no prompt de comando.

    regpkg /regfile:DeployPackage.reg /codebase DeployPackage.dll

  3. Abra o arquivo resultante de DeployPackage.reg no bloco de notas.

DeployPackage.reg deve ser semelhante o código a seguir:

REGEDIT4

[HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\10.0\InstalledProducts\DeployPackage]
@="#110"
"Package"="{bad3390c-b2a2-4bfc-a3ad-87e8119df413}"
"ProductDetails"="#112"
"PID"="1.0"
"LogoID"="#400"
[HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\9.0\Packages\{bad3390c-b2a2-4bfc-a3ad-87e8119df413}]
@="Company.DeployPackage.DeployPackage, DeployPackage, Version=1.0.2796.21244, Culture=neutral, PublicKeyToken=125cdbd1e07e0d79"
"InprocServer32"="C:\\Windows\\system32\\mscoree.dll"
"Class"="Company.DeployPackage.DeployPackage"
"CodeBase"="D:\\DeployPackage\\DeployPackage\\bin\\Debug\\DeployPackage.dll"
[HKEY_LOCAL_MACHINE\Software\Microsoft\VisualStudio\9.0\Menus]
"{bad3390c-b2a2-4bfc-a3ad-87e8119df413}"=", 1000, 1"

A chave CodeBase é gerada quando o regpkg. exe é executado com o /codebase switch, da seguinte maneira.

"CodeBase"="D:\\DeployPackage\\DeployPackage\\bin\\Debug\\DeployPackage.dllL"

Para implantar seu VSPackage em um computador de destino, você deve executar as seguintes tarefas:

  • Atualize o caminho da Base de código.

  • Copie os arquivos do VSPackage. dll e. reg no computador de destino.

  • Atualize o registro do sistema no computador de destino.

  • Inicializar o Visual Studio o sistema de menus no computador de destino.

Para implantar o computador de destino usando xcopy

  1. Altere o caminho de base de código em DeployPackage.reg para o caminho onde DeployPackage.dll será instalado no computador de destino. Por exemplo, se você instalar o DeployPackage.dll para o diretório raiz da unidade D, a base de código chave e valor devem lembrar o seguinte:

    "CodeBase"="D:\\DeployPackage.dll"

  2. Certifique-se de que o caminho de InprocServer32 é o local de mscoree. dll no computador de destino. Por exemplo, se o sistema operacional estiver instalado na unidade D, o valor e chave InprocServer32 devem lembrar o seguinte:

    "InprocServer32"="D:\\Windows\\system32\\mscoree.dll"

  3. Salvar as alterações para DeployPackage.reg e copie o DeployPackage.reg e o DeployPackage.dll para o computador de destino. Certifique-se de copiar DeployPackage.dll no caminho apresentado na chave CodeBase.

  4. Execute o Visual Studiocomando janela no computador de destino como administrador. 

  5. No prompt de comando, navegue até onde você instalou o DeployPackage.dll e digite as duas linhas seguintes:

    deploypackage.reg do Regedit /s

    /nosetupvstemplates do devenv /setup

    A primeira linha instala várias chaves e valores no registro do sistema. A segunda linha inicializa Visual Studio e seu sistema de menus no computador de destino.

    Dica

    Porque não estamos adicionando modelos de projeto ou item, podemos usar a opção /nosetupvstemplates para diminuir o tempo de preparação.

  6. Iniciar Visual Studio no computador de destino.

  7. Sobre o Ferramentas menu, clique em Meu comando implantar. Você verá uma caixa de mensagem que tem a seguinte mensagem:

    Company.DeployPackage.DeployPackage.MenuItemCallback() Inside

Parabéns! Você implantou com sucesso seu VSPackage!

CodeBase Versus a implantação do Assembly

Para usar a implantação da Base de código, você pode instalar o VSPackage na pasta dada pela chave CodeBase. Esta pasta é geralmente denominada depois de uma empresa ou tecnologia, por exemplo, D:\MyCompany.

Implantação do assembly é outra maneira de implantar seu VSPackage. Usando a implantação do assembly, você pode instalar seu VSPackage na Visual Studio PrivateAssemblies pasta ou subpasta.

Normalmente você escolheria CodeBase implantação quando seu VSPackage é usado principalmente por seu próprio produto e não for conhecido para outros produtos. Você escolheria a implantação do assembly quando seu VSPackage é destinado a ser compartilhada por outros produtos. Por exemplo, um verificador ortográfico provavelmente seria implantado na pasta PrivateAssemblies.

Dica

Conflitos de nome de arquivo do assembly são possíveis na pasta PrivateAssemblies.

Porque cada versão do Visual Studio tem sua própria pasta de PrivateAssemblies, você pode usar a implantação do assembly para VSPackage projetada para cenários de lado a lado. Se você tiver um VSPackage projetado para ser executado em várias versões do Visual Studio, e em seguida, você deve considerar a instalá-lo no GAC.

Dica

Por motivos de desempenho, não os assemblies de nome forte sinal que você coloca na pasta PrivateAssemblies, ou qualquer local diferente do GAC.

Implantação do xcopy usando PrivateAssemblies

Implantação do assembly VSPackage para a pasta PrivateAssemblies usa o registro de um sistema diferente de implantação do CodeBase. Você pode usar o utilitário regpkg. exe para criar as chaves necessárias, subchaves e valores para a implantação do assembly.

Para gerar o arquivo de registro do sistema

  1. No System Definition Modelcomando janela, navegue até a pasta que contém DeployPackage.dll. Ele está localizado normalmente no diretório de \bin\Debug\ do projeto.

  2. Digite a seguinte linha no prompt de comando:

    regpkg /regfile:DeployPackage.reg /assembly DeployPackage.dll

  3. Abra o arquivo resultante de DeployPackage.reg no bloco de notas.

A chave CodeBase é substituída com a chave do Assembly, da seguinte maneira:

"Assembly"="DeployPackage, Version=1.0.2796.21244, Culture=neutral, PublicKeyToken=125cdbd1e07e0d79"

Para implantar seu VSPackage em um computador de destino, você deve copiar arquivos VSPackage. dll para a pasta PrivateAssemblies do computador de destino. Você também deve copiar os arquivos. reg no computador de destino, atualizar o registro do sistema no computador de destino e inicializar o Visual Studio o sistema de menus no computador de destino.

Para implantar na pasta PrivateAssemblies

  1. Certifique-se de que o caminho de InprocServer32 é o local de mscoree. dll no computador de destino. Por exemplo, se o sistema operacional estiver instalado na unidade D, o valor e chave InprocServer32 devem lembrar o seguinte:

    "InprocServer32"="D:\\Windows\\system32\\mscoree.dll"

  2. Se você já tiver instalado o VSPackage usando CodeBase, exclua a pasta e seu conteúdo.

  3. Copie o DeployPackage.reg e DeployPackage.dll para a pasta PrivateAssemblies no computador de destino. O local típico para esta pasta é caminho de instalação do Visual Studio\Common7\IDE\PrivateAssemblies\.

    Dica

    Credenciais administrativas podem ser necessárias para copiar essa pasta.

  4. Execute o Visual Studiocomando janela no computador de destino como administrador. 

  5. No prompt de comando, navegue até a pasta PrivateAssemblies e digite as duas linhas seguintes:

    Regedit deploypackage.reg

    devenv /setup

    A primeira linha instala várias chaves e valores no registro do sistema. A segunda linha inicializa Visual Studio e seu sistema de menus no computador de destino.

    Deploypackage.reg não é mais necessário. Você pode excluí-lo.

  6. Iniciar Visual Studio no computador de destino.

  7. Sobre o Ferramentas menu, clique em Meu comando implantar. Você verá uma caixa de mensagem que tem a seguinte mensagem:

    Company.DeployPackage.DeployPackage.MenuItemCallback() Inside

Parabéns! Você implantou o VSPackage para a pasta de PrivateAssemblies!

Implantação usando um projeto de instalação

Uma abordagem mais fácil de implantar um VSPackage é usar um Visual Studio projeto de instalação. Projetos de instalação produzem arquivos do Windows Installer (. msi), que lidam com muitas tarefas de implantação para você, por exemplo:

  • Certificando-se de que os pré-requisitos forem atendidos, como instalar o common language runtime (CLR) no computador de destino.

  • Fornecendo uma interface de usuário para ativar a seleção da pasta de destino para a instalação.

  • Executando as etapas de compilação personalizada, como, por exemplo, mesclagem de menus.

Para obter mais informações, consulte Setup Projects.

O procedimento de projeto de instalação a seguir importa informações de registro de um arquivo. reg criado para implantação da Base de código. Se você já não criou este arquivo, conclua o procedimento a seguir primeiro.

Para gerar o arquivo de registro do sistema

  1. No System Definition Modelcomando janela, navegue até a pasta que contém DeployPackage.dll. Ele está localizado normalmente no diretório de \bin\Debug\ do projeto.

  2. Digite a seguinte linha no prompt de comando:

    regpkg /regfile:DeployPackage.reg /codebase DeployPackage.dll

Agora você está pronto para criar e configurar o projeto de instalação.

Para criar e configurar o projeto de instalação

  1. Abra a solução de DeployPackage em Visual Studio no computador de desenvolvimento.

  2. Clique com o botão direito no nó da solução, clique em Adde, em seguida, clique em Novo projeto.

  3. Expanda Other Project Types e, em seguida, selecione Setup and Deployment.

  4. Criar um Setup Project chamado Setup.

    O modelo adiciona o projeto de instalação à sua solução.

  5. Clique com o botão direito no nó do projeto de instalação, clique em Adde, em seguida, clique em Project Output.

  6. Clique em OK para adicionar o a saída primária do projeto DeployPackage.

    O verificador de dependência é executado e adiciona as dependências para o projeto de instalação. A maioria dessas dependências Consulte binários que já estão presentes em um computador de destino que tenha Visual Studio instalado.

  7. Selecione detectadas todas as dependências, exceto o Microsoft.NET Framework, a seleção com o botão direito e, em seguida, clique em Excluir.

  8. Clique no nó do projeto de instalação.

    As propriedades do projeto aparecem na janela Propriedades.

  9. Altere a propriedade ProductName para meu pacote de implantação.

  10. Altere a propriedade Title para minha instalação do pacote de implantar.

  11. Clique no ícone do Editor do Registro sobre o Solution Explorer barra de ferramentas.

    O editor do registro é exibido.

  12. Com o botão direito registro na máquina de destino e, em seguida, clique em importação.

    O Do registro de importação caixa de diálogo aparece.

  13. Navegue até a pasta \bin\Debug\ do projeto DeployPackage e selecione DeployPackage.reg. Clique em Open.

    As chaves de registro que é gerado para a implantação da Base de código são adicionadas ao nó no editor do Registro HKEY_LOCAL_MACHINE.

Se você examinar as chaves do registro no nó de \Software\Microsoft\VisualStudio\9.0\Packages\, você pode encontrar dois caminhos embutidos. Eles devem ser substituídos por caminhos são determinados durante a instalação.

Para remover os caminhos embutidos

  1. No editor do registro, selecione a chave CodeBase e selecione a propriedade Value na Propriedades janela.

  2. Altere o caminho para ser relativo ao diretório de instalação de destino, da seguinte forma:

    [TARGETDIR]deploypackage.dll

  3. No editor do registro, selecione a chave InProcServer32 e, em seguida, selecione a propriedade Value na janela Propriedades.

  4. Altere o caminho para ser relativo ao diretório de sistema de destino, da seguinte forma:

    [SystemFolder]mscoree.dll

Após a instalação no computador de destino, você deve executar devenv. exe com a opção /setup. Você pode adicionar isso para a instalação como uma ação personalizada. Para criar uma ação personalizada, você deve primeiro adicionar um projeto para criar uma classe que deriva de Installer classe.

Para adicionar um projeto de classe de instalador

  1. No menu File, aponte para New e clique Project.

    A caixa de diálogo New Project será exibida.

  2. Criar um C# Visual ou biblioteca de classes de Visual Basic chamado DevenvSetupCustomAction.

  3. Exclua o arquivo Class1. cs ou Class1. vb.

  4. Clique com o botão direito no nó do projeto DevenvSetupCustomAction, clique em Adde, em seguida, clique em Novo Item.

  5. Criar uma nova Classe de instalador chamado DevenvSetup.

  6. Clique com o botão direito no nó de DevenvSetup.cs ou DevencSetup.vb e clique em Exibir código.

  7. Adicione as seguintes linhas para o using ou Imports instruções:

  8. Substitua o método de instalação, adicionando o seguinte código à classe DevenvSetup, logo após o construtor:

    Esse código procura o registro no computador de destino para o valor da chave \Software\Microsoft\VisualStudio\9.0\Setup\VS\ nomeado de EnvironmentPath. O valor de EnvironmentPath é o caminho completo para devenv. exe. O método de instalação é executado devenv. exe com a opção /setup e aguarda a sua conclusão.

    Dica

    Se você não estiver instalando modelos de projeto ou item, você pode reduzir significativamente o tempo de instalação adicionando que alternar o /nosetupvstemplates, da seguinte maneira:

Agora que você tem uma ação personalizada, você pode adicioná-lo ao projeto de instalação.

Para adicionar uma ação personalizada ao projeto de instalação

  1. Clique com o botão direito no nó do projeto de instalação, clique em Adde, em seguida, clique em Project Output.

    A caixa de diálogo Add Project Output Group aparece.

  2. Selecione DevenvSetupCustomAction sobre o projeto lista.

    Saída primária da DevenvSetupCustomAction (ativo) é adicionado ao nó dependências detectado.

  3. Selecione o nó do projeto de instalação e clique o Custom Actions Editor ícone na Solution Explorer barra de ferramentas.

    O editor Custom Actions aparece.

  4. Clique com o botão direito no nó de instalação e clique em Add Custom Action.

    A caixa de diálogo Select Item in Project aparece.

  5. Clique duas vezes na pasta do aplicativo e, em seguida, selecione saída primária do DevenvSetupCustomAction (ativo). Clique em OK.

    A ação personalizada é adicionada ao nó de instalação.

Para testar o projeto de instalação

  1. Crie a solução de DeployPackage.

    DeployPackage.dll e DevenvSetupCustomAction.dll são criados.

  2. Compile o projeto de instalação.

    Setup. exe e Setup. msi são criados.

  3. Close Visual Studio.

  4. Copie o arquivo Setup. exe no computador de destino. Você pode executar o Setup. exe no computador de desenvolvimento se nenhum computador de destino estiver disponível.

    Dica

    O computador deve ter Visual Studio instalado.A versão do Visual Studio deve coincidir com a chave do registro que é usada pela ação personalizada.

  5. Execute Setup. exe no computador de destino.

    Dica

    Executar devenv /setup pode demorar um pouco.Você pode seguir o seu progresso usando o Gerenciador de tarefas.

  6. Instale o DeployPackage e aceite todos os padrões.

  7. Execute Visual Studio.

  8. Sobre o Ferramentas menu, clique em Meu comando implantar. Você verá uma caixa de mensagem que tem a seguinte mensagem:

    Company.DeployPackage.DeployPackage.MenuItemCallback() Inside

  9. Feche a caixa de mensagem e sair Visual Studio.

  10. No Painel de controle, (Windows Vista), selecione programas e recursos ou (Windows XP) Adicionar ou remover programas.

  11. Desinstale o meu pacote de implantação.

  12. Execute Visual Studio.

  13. Verifique Meu comando implantar não aparece mais na Ferramentas menu.

Implantação usando o conjunto de ferramentas do Windows Installer XML

Outra abordagem para implantar um VSPackage é usar o conjunto de ferramentas do Windows Installer XML. O conjunto de ferramentas compila os arquivos de .wxs para produzir arquivos. msi. Ações personalizadas, como a mesclagem de menus, são mais fáceis de criar usando arquivos de .wxs de projetos de instalação do Windows Installer.

Para obter mais informações sobre o conjunto de ferramentas, consulte http://wix.sourceforge. NET /.

Você pode usar o utilitário RegPkg para criar um arquivo de .wxs para registrar um VSPackage no registro do sistema. Você insere esse arquivo em um arquivo de .wxs mais completo que implanta seu VSPackage e mescla os seus menus em Visual Studio. Você então compila este arquivo de .wxs com as ferramentas de Candle. exe e light.exe para produzir um arquivo. msi para sua implantação VSPackage.

Primeiro, crie o arquivo de DeployPackage.wxs externo e adicioná-lo para o projeto DeployPackage.

Para criar o arquivo DeployPackage.wxs

  1. Em Solution Explorer, o botão direito do mouse no nó do projeto DeployPackage, clique em Add, em seguida, clique em Novo Item.

    A caixa de diálogo Add New Item é exibida.

  2. Selecione o modelo de item do arquivo de texto, nomeie o arquivo DeployPackage.wxse, em seguida, clique em Add.O arquivo vazio aparece no editor.

  3. Adicione essas linhas no arquivo:

<?xml version='1.0' encoding='windows-1252'?>

<?define VisualStudioRegistryRoot = "Software\Microsoft\VisualStudio\9.0" ?>

<Wix xmlns='https://schemas.microsoft.com/wix/2003/01/wi'>
  <Product Name='DeployPackage' Id='54748C47-DC70-43ec-A296-ECD7F30A548C'
    Language='1033' Codepage='1252' Version='1.0.0' Manufacturer='My Company'>

    <Package Id='????????-????-????-????-????????????' Keywords='Installer'
      Description="Deploy Package Installer"
      Comments='Demonstrates VSPackage deployment' Manufacturer='My Company'
      InstallerVersion='100' Languages='1033' Compressed='yes' SummaryCodepage='1252' />

    <Media Id='1' Cabinet='Sample.cab' EmbedCab='yes' />

    <!-- Properties -->
    <Property Id="DEVENV_EXE_PATH">
      <RegistrySearch Id="RegSearch_DevenvExe_Path" Root="HKLM" Key="$(var.VisualStudioRegistryRoot)\Setup\VS" Name="EnvironmentPath" Type="raw" />
    </Property>

    <!-- Launch conditions -->
    <Condition Message="An administrator must approve or install [ProductName]."> Privileged </Condition>
    <Condition Message="[ProductName] requires Visual Studio 2010."> DEVENV_EXE_PATH </Condition>

    <!-- Root directories -->
    <Directory Id="TARGETDIR" Name="SourceDir">
      <Directory Id="ProgramFilesFolder" Name="PFILES">
        <Directory Id="INSTALLDIR" Name="MyFolder" >

          <Component Guid="7D6D266D-4197-439b-ADB4-D51876269055" Id="MainExecutable">
            <File Id="Deploy.dll" Name="Deploy.dll" LongName="DeployPackage.dll" Source="bin\Debug\DeployPackage.dll" Vital="yes" DiskId="1" />
            <?include DeployFragment.wxs ?>
          </Component>
        </Directory>
      </Directory>
    </Directory>

    <Feature Id='Complete' Level='1'>
      <ComponentRef Id='MainExecutable' />
    </Feature>

    <InstallExecuteSequence>
      <Custom Action="CA_DeployPackage" Before="InstallFinalize" />
    </InstallExecuteSequence>

    <CustomAction Id="CA_DeployPackage" Property="DEVENV_EXE_PATH" ExeCommand="/setup /nosetupvstemplates" Impersonate="no" Execute="deferred" />

  </Product>
</Wix>
  1. Salve suas alterações.

O arquivo de DeployPackage.wxs externo se refere a um arquivo intermediário chamado DeployFragment.wxs, que você gera DeployPackage.dll.

Para gerar o arquivo DeployFragment.wxs

  1. No System Definition Modelcomando janela, navegue até a pasta que contém DeployPackage.dll. Ele está localizado normalmente no diretório de \bin\Debug\ do projeto.

  2. Digite a seguinte linha no prompt de comando:

    regpkg /wixfile:.. \.. \DeployFragment.wxs /codebase DeployPackage.dll

    RegPkg cria o arquivo DeployPackage.wxs na pasta do projeto DeployPackage.

  3. No Visual Studio, clique com o botão direito no nó do projeto DeployPackage, aponte para Adde, em seguida, clique em Item existente.

    O Add Existing Item bos da caixa de diálogo é exibida.

  4. Navegue até a pasta do projeto DeployPackage.

  5. Definir o filtro de arquivo para mostrar Todos os arquivos, selecione o arquivo DeployFragment.wxs e, em seguida, clique em Add.

    O arquivo de DeployFragment.wxs é adicionado ao projeto DeployPackage.

  6. Abra o arquivo DeployFragment.wxs para edição.

  7. Altere o valor do elemento do registro denominado CodeBase exatamente como o atributo Name do elemento DeployPackage.wxs File.

    <Registry Name="CodeBase" Value="[#Deploy.dll]" Type="string" />

  8. Salve suas alterações.

Enquanto uma explicação completa sobre os elementos do arquivo .wxs está além do escopo desta explicação passo a passo, aqui estão alguns pontos fundamentais para começar.

  • Muitos elementos do conjunto de ferramentas levam um GUID como uma identificação. Esses GUIDs devem ser substituídas quando você cria um novo arquivo de .wxs. GUIDs nas marcas Include não devem ser substituídos porque eles pertencem ao VSPackage.

  • O elemento do arquivo tem um atributo Name que usa um nome de formatada (DOS 8.3) curto e é usado apenas para fins de identificação. O VSPackage real é fornecido pelos atributos LongName e fonte. Por convenção, o atributo Id é o mesmo que o atributo Name.

  • O atributo Name do elemento DeployPackage.wxs File deve corresponder ao valor do elemento DeployFragment.wxs registro denominado CodeBase. Lembre-se de que o atributo Name é um nome de arquivo com formato curto (DOS 8.3).

  • O elemento CustomAction Especifica a ação personalizada. Os atributos de representar e executar são definidos para que Visual Studio possui elevados privilégios no Windows Vista durante as execuções de ação personalizada. O atributo ExeCommand usa a opção /nosetupvstemplates para tirar proveito do fato de que você não está instalando modelos de item ou projeto. Isso reduz significativamente o tempo de preparação.

Agora que seu arquivo de .wxs estiver concluído, você pode compilá-lo para criar o arquivo de instalação. msi.

Para compilar o arquivo DeployPackage.wxs

  1. No System Definition Modelcomando janela, navegue até a pasta do projeto DeployPackage. Esta pasta contém o arquivo DeployPackage.wxs.

  2. Adicione o caminho completo do conjunto de ferramentas para a variável de ambiente Path. Por exemplo,

    set Path=%Path%;C:\Program Files\Microsoft Visual Studio 2010 SDK\VisualStudioIntegration\Tools\Toolset

  3. Digite a seguinte linha no prompt de comando.

    candle DeployPackage.wxs

    Isso cria o arquivo de objeto DeployPackage.wixobj.

  4. Digite a seguinte linha no prompt de comando.

    light DeployPackage.wixobj

    Isso cria o arquivo de objeto DeployPackage.msi.

Para testar o arquivo de implantação. msi:

  • Instale o VSPackage no computador de destino.

  • Teste o VSPackage é executado no computador de destino.

  • Desinstale o VSPackage do computador de destino.

Para testar o projeto de instalação

  1. Copie DeployPackage.msi para o computador de destino. Você pode executá-lo no computador de desenvolvimento, se nenhum computador de destino estiver disponível.

    Dica

    O computador deve ter Visual Studio instalado.A versão do Visual Studio deve coincidir com a chave do registro que é usada pela condição de inicialização e pela ação personalizada.

  2. Execute DeployPackage.msi no computador de destino.

    Dica

    Nenhum assistente é exibido.É possível que light.exe adicionar um assistente usando uma biblioteca de conjunto de ferramentas.Para obter mais informações, consulte http://wix.sourceforge.NET /.

  3. Execute Visual Studio.

  4. Sobre o Ferramentas menu, clique em Meus distribuir encapsulamento. Você verá uma caixa de mensagem que tem a seguinte mensagem:

    Company.DeployPackage.DeployPackage.MenuItemCallback() Inside

  5. Feche a caixa de mensagem e feche Visual Studio.

  6. No Painel de controle, (Windows Vista), selecione programas e recursos ou (Windows XP) Adicionar ou remover programas.

  7. Desinstale o DeployPackage.

  8. Execute Visual Studio.

  9. Verifique Meu comando implantar não aparece mais na Ferramentas menu.

Consulte também

Outros recursos

Instalando os VSPackages

Instalando os VSPackages usando o Windows Installer