Compartilhar via


Pré-requisitos de implantação de aplicativos

Para garantir que seu aplicativo será instalado e executará com êxito, você deve primeiro garantir que todos os componentes dos quais o aplicativo depende já estejam instalados no computador de destino. Por exemplo, a maioria dos aplicativos criados usando o Visual Studio tem uma dependência sobre o .NET Framework; a versão correta do tempo de execução de linguagem comum deve estar presente no computador de destino antes a instalação do aplicativo.

Você pode selecionar esses pré-requisitos na Caixa de Diálogo Pré-requisitos e instalar o .NET Framework e outros redistribuíveis como parte da instalação. Essa prática é conhecida como inicialização. Em seguida, o Visual Studio gera um programa executável do Windows chamado Setup.exe, também conhecido como bootstrapper. O bootstrapper é responsável pela instalação desses pré-requisitos antes de executar o aplicativo. Para obter mais informações sobre como selecionar esses pré-requisitos, consulte Caixa de diálogo Pré-requisitos.

Cada pré-requisito é um pacote de bootstrapper. Um pacote de bootstrapper é um grupo de diretórios e arquivos que contém arquivos de manifesto que descrevem como o pré-requisito deve ser instalado. Se os pré-requisitos do aplicativo não estiverem listados na Caixa de Diálogo de Pré-requisito, você poderá criar pacotes de bootstrapper personalizados e adicioná-los ao Visual Studio. Em seguida, você pode selecionar os pré-requisitos na Caixa de Diálogo Pré-requisitos. Para obter mais informações, consulte Criando pacotes de bootstrapper.

Por padrão, a inicialização está habilitada para implantação do ClickOnce. O bootstrapper gerado para implantação do ClickOnce é assinado. Você pode desabilitar a inicialização de um componente, mas deve fazer isso somente se tiver certeza de que a versão correta do componente já esteja instalada em todos os computadores de destino.

Inicialização e implantação do ClickOnce

Antes de instalar um aplicativo em um computador cliente, o ClickOnce examinará o cliente para garantir que ele tenha determinados requisitos especificados no manifesto do aplicativo. Eles incluem o seguinte:

  • A versão mínima necessária do tempo de execução da linguagem comum, que está especificada como uma dependência do assembly no manifesto do aplicativo.

  • A versão mínima necessária do sistema operacional Windows exigida pelo aplicativo, conforme especificado no manifesto do aplicativo usando o elemento <osVersionInfo>. (Consulte Elemento <dependency>(aplicativo ClickOnce))

  • A versão mínima de todos os assemblies que devem ser pré-instalados no cache do assembly global (GAC), conforme especificado pelas declarações de dependência do assembly no manifesto do assembly.

O ClickOnce pode detectar pré-requisitos ausentes e você pode instalar pré-requisitos usando um bootstrapper. Para obter mais informações, consulte Como instalar pré-requisitos com um aplicativo ClickOnce.

Dica

Para alterar os valores nos manifestos gerados pelas ferramentas, tais como Visual Studio e MageUI.exe, você precisa editar o manifesto do aplicativo em um editor de texto e assinar novamente os manifestos do aplicativo e de implantação.Para obter mais informações, consulte Como assinar manifestos de aplicativo e implantação novamente.

Se você usar o Visual Studio e o ClickOnce para implantar seu aplicativo, os pacotes do bootstrapper selecionados por padrão dependerão da versão do .NET Framework na solução. No entanto, se você alterar a versão do .NET Framework de destino, deverá atualizar as opções na Caixa de Diálogo Pré-requisitos manualmente.

.NET Framework de Destino

Pacotes do Bootstrapper Selecionados

.NET Framework 4 Client Profile

.NET Framework 4 Client Profile

Windows Installer 3.1

.NET Framework 4

.NET Framework 4

Windows Installer 3.1

Com a implantação do ClickOnce, a página Publish.htm gerada pelo Assistente de Publicação do ClickOnce aponta para um link que instala somente o aplicativo ou para um link que instala o aplicativo e os componentes inicializados.

Se você gerar o bootstrapper usando o Assistente de Publicação do ClickOnce ou a Página de Publicação no Visual Studio, o Setup.exe será assinado automaticamente. No entanto, se desejar usar o certificado do cliente para assinar o bootstrapper, você poderá assinar o arquivo mais tarde.

Inicialização e MSBuild

Se você não usar o Visual Studio, mas compilar seus aplicativos na linha de comando, poderá criar o aplicativo de inicialização do ClickOnce usando uma tarefa do Microsoft Build Engine (MSBuild). Para obter mais informações, consulte Tarefa GenerateBootstrapper.

Como alternativa para a inicialização, você pode pré-implantar componentes usando um sistema de distribuição de software eletrônico, tal como o Microsoft Systems Management Server (SMS).

Argumentos da linha de comando do bootstrapper (Setup.exe)

O Setup.exe gerado por Visual Studio e as tarefas do MSBuild oferecem suporte ao pequeno conjunto de argumentos da linha de comando a seguir. Quaisquer argumentos fornecidos ao aplicativo de inicialização além desses são encaminhados ao instalador do aplicativo.

Se você alterar quaisquer opções do bootstrapper, deverá alterar o bootstrapper não assinado e assinar o arquivo de bootstrapper posteriormente.

Argumento da linha de comando

Descrição

-?, -h, -help

Exibe uma caixa de diálogo de Ajuda.

-url, -componentsurl

Mostra a URL armazenada e a URL dos componentes para esta configuração.

-url=location

Configura a URL em que Setup.exe consultará o aplicativo ClickOnce.

-componentsurl=location

Configura a URL em que Setup.exe consultará as dependências, tais como o .NET Framework.

-homesite=true|false

Quando true, baixe as dependências do local preferido no site do fornecedor. Isso substitui a configuração de -componentsurl. Quando false, baixe as dependências da URL especificada por -componentsurl.

Suporte a sistemas operacionais

O bootstrapper do Visual Studio não é compatível com o Windows Server 2008 Server Core ou o Windows Server 2008 R2 Server Core, que fornece um ambiente de servidor de baixa manutenção com funcionalidade limitada. Por exemplo, a opção de instalação do Server Core oferece suporte somente ao perfil do .NET Framework 3.5 Server Core, de modo que os recursos do Visual Studio que dependem do .NET Framework completo não poderão ser executados.

Consulte também

Conceitos

Escolhendo uma estratégia de implantação do ClickOnce

Segurança e implantação do ClickOnce