Demonstra Passo a passo: Usando uma ação personalizada para um assembly na instalação Pre-compilar

Custom actionsallow you to specify additional actions to be performed on the target computer at the end of an installation.Por exemplo, nesta explicação passo a passo, você passar o nome do caminho de uma DLL para o CustomActionDatapropriedade para pré-compilar o assembly para código nativo durante a instalação.

Observação:
As caixas de diálogo e comandos de menu demonstradas podem ser diferentes daqueles descritas na Ajuda, dependendo das configurações ativas ou configurações de edição.Para alterar as configurações, escolher Importar e exportar configurações on the Ferramentas menu.Para obter mais informações, consulte Configurações do Visual Studio.

Observação:
As instruções a seguir demonstram a criação de um projeto de implantação usando um projeto Visual Basic; os princípios Geral se aplicam a todos os projetos de linguagem do Visual Studio que suppor t Implantando aplicativos do Windows.

Para criar a classe de ação personalizada

1. No menu File clique em NewProject.

2. No Novo projeto caixa de diálogo de de seleçãoProjetos do Visual Basic in the Tipo de projeto painel e, em seguida, escolher biblioteca de classes in the Modelos painel.No Nome box, type InstallClass.

3. No menu Project, escolha Add New Item.

4. No Adicionar novo item caixa de diálogo, choose Classe de instalador.No Nome box, type InstallClass.vb.clicar Adicionar para adicionar a classe para o projeto.

Adicionar código para a ação personalizada

1. clicar com o botão direito do mouse InstallClass.vb O gerenciador de soluções (ou a área de design) e clique em Exibir código para em em aberto o Editor de código.Adicione o seguinte código na parte superior do módulo, abaixo de Imports System.Configuration.Install:

   Imports System.Runtime.InteropServices
   Imports System.Text
   

2. Em InstallClass.vb, adicione a declaração a seguir abaixo Public Class InstallClass:

   Private Declare Function GetCORSystemDirectory Lib "mscoree.dll" _
     (<Runtime.InteropServices.MarshalAs( _
     System.Runtime.InteropServices.UnmanagedType.LPWStr)> _
     ByVal Buffer As System.Text.StringBuilder, _
     ByVal BufferLength As Integer, ByRef Length As Integer) As Integer
   

3. Em InstallClass.vb após o End Sub demonstrativo para MyBase.New, adicione o seguinte procedimento para substituir o Install procedimento da classe base:

   <Security.Permissions.SecurityPermission(Security.Permissions.SecurityAction.Demand)> _
   Public Overrides Sub Install(ByVal savedState As _
     System.Collections.IDictionary)
   
      MyBase.Install(savedState)
      Dim Args As String = Me.Context.Parameters.Item("Args")
   
      If Args = "" Then
         Throw New InstallException("No arguments specified")
      End If
   
      ' Gets the path to the Framework directory.
      Dim Path As New System.Text.StringBuilder(1024)
      Dim Size As Integer
      GetCORSystemDirectory(Path, Path.Capacity, Size)
   
      Dim P As Process
      ' Quotes the arguments, in case they have a space in them.
      Dim Si As New ProcessStartInfo(Path.ToString() & "ngen.exe", Chr(34) _
        & Args & Chr(34))
      Si.WindowStyle = ProcessWindowStyle.Hidden
      Try
         P = Process.Start(Si)
         P.WaitForExit()
      Catch e As Exception
         Throw New InstallException(e.Message)
      End Try
   End Sub
   

Para adicionar um projeto de implantação

1. Sobre o Arquivo menu, escolher Adicionare, em seguida, clicar Novo projeto.

2. No Adicionar novo projeto caixa de diálogo , selecionar O programa de instalação e projetos de implantação in the Tipo de projeto painel e, em seguida, escolher Projeto de instalação in the Modelos painel.No Nome box, type InstallClass Installer.

3. No Propriedades janela, selecionar o ProductName propriedade e tipo de InstallClass.

4. No Editor de arquivo do sistema, selecionar o Pasta de aplicativo.Sobre o Ação menu, escolher Adicionare, em seguida, clicar Saída do projeto.

5. No Adicionar Project Output agrupar caixa de diálogo, selecionar a saída primária para o projeto InstallClass e, em seguida, clicar OK para fechar a caixa de diálogo.

Para adicionar ação personalizada

1. selecionar o InstallClass Installer projeto em O gerenciador de soluções.Sobre o Modo de exibição , aponte para Editore o clicar Ações personalizadas.

2. No Editor de ações personalizadas, selecionar o Ações personalizadas nó.Sobre o Ação menu, escolher Adicionar ação personalizada.

3. No selecionar o item in projeto diálogo caixa, clicar duas vezes o Pasta de aplicativoe, em seguida, selecionar Saída primária do InstallClass (ativo).clicar OK para adicionar a ação personalizada InstallClass a todos os quatro nós de ação personalizada.

4. selecionar o Saída primária do InstallClass (ativo) nó sob o Instalar nó.

5. No Propriedades janela, selecionar o CustomActionData propriedade e tipo de / Args="[TARGETDIR]InstallClass.dll".Inclua as aspas.

6. Repetir para cada uma das três outras instâncias de Saída primária do InstallClass (ativo).

7. Sobre o Compilação menu, escolher Criar InstallClass Installer.

Para instalar o seu computador de desenvolvimento

• selecionar o InstallClass Installer projeto em O gerenciador de soluções.Sobre o Projeto menu, escolher Instalar.

  Observação:
  Você deve ter as permissões de instalar no computador para executar o instalador.

Para implantar em outro computador

1. In Windows Explorer, navegar para o diretório de projeto e localize o instalador integrado.O caminho padrão será \Documents and Settings\ yourloginname\Meus Documentos\Visual studio 2005\Projects\Nome da pasta de solução\Meus Installer\ notepadconfiguração de projeto \Meus Installer.msi o bloco de notas.O padrão de configuração de projeto is Depurar or Versão.

2. Copie InstallClass Installer.msi, Setup.exe, todos os outros arquivos e subdiretórios no diretório para outro computador.

   Observação:
   Para instalar em um computador que não esteja em uma rede, copie arquivos t o mídia tradicional, sistema autônomo CD-ROM.

3. No computador de destino, clicar duas vezes em Setup.exe para executar o instalador.

   Observação:
   Você deve ter as permissões de instalar no computador para executar o instalador.

Para testar a instalação

• navegar até a pasta de assembly %windir%\assembly (por exemplo, C:\Windows\assembly) e localizar InstallClass. No Tipo coluna, seu tipo deve ser marcado sistema autônomo Imagens nativas.

Para desinstalar o aplicativo

1. No Windows Painel de controle, clicar duas vezes em Adicionar ou remover programas.

2. No Adicionar ou remover programas caixa de diálogo de de seleçãoInstallClass Installer e clicar Removere, em seguida, clicar OK para fechar a caixa de diálogo.

   Dica:
   Desinstalar de seu computador de desenvolvimento, nas Projeto menu, escolher Desinstalar o.

Consulte também

Conceitos

Compilação MSIL para código nativo

Referência

Propriedade CustomActionData

Nativo Gerador de Imagem (Ngen.exe)

Outros recursos

Gerenciamento de ações personalizadas no implantação