Pré-requisitos de implantação de aplicativo (área de trabalho do Windows)

  • Artigo

Para instalar e executar com êxito o aplicativo na área de trabalho do Windows, primeiro instale no computador de destino todos os componentes necessários para o aplicativo. Por exemplo, a maioria dos aplicativos criados usando o Visual Studio tem dependência do .NET Framework. Neste caso, a versão correta do Common Language Runtime deve estar presente no computador de destino antes da 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. 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, confira Caixa de diálogo Pré-requisitos.

Cada pré-requisito é um pacote de bootstrapper. Um pacote de bootstrapper é um grupo de diretórios e arquivos contendo os arquivos de manifesto que descrevem como os pré-requisitos são instalados. 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, confira Criar pacotes de bootstrapper.

Por padrão, a inicialização está habilitada na implantação do Windows Installer (usando os projetos de instalação no Visual Studio) e implantação do ClickOnce. O bootstrapper gerado para a implantação do Windows Installer não está assinado, mas na implantação do ClickOnce ele está 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 tem os requisitos especificados no manifesto do aplicativo. Isso incluem os seguintes requisitos:

  • A versão mínima necessária do runtime 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>. (Confira <dependência> elemento.)

  • A versão mínima de todos os assemblies que devem ser pré-instalados no GAC (cache do assembly global), 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, confira Como instalar pré-requisitos com um aplicativo ClickOnce.

Observação

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, confira Como assinar novamente manifestos de aplicativo e implantação.

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 sim 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, confira 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 pelo Visual Studio e as tarefas do MSBuild oferecem suporte ao conjunto de argumentos da linha de comando a seguir. Todos os outros argumentos são encaminhados para o instalador do aplicativo.

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

Argumento de 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. Essa configuração substitui a configuração -componentsurl. Quando false, baixe as dependências da URL especificada por -componentsurl.

Suporte do sistema operacional

O bootstrapper do Visual Studio não é compatível com o Windows Server 2008 Server Core ou o Windows Server 2008 R2 Server Core, pois eles fornecem 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, que não pode executar os recursos do Visual Studio que dependem do .NET Framework completo.

Conteúdo relacionado