Passo a passo: Implantar manualmente um aplicativo ClickOnce

Caso não consiga usar o Visual Studio para implantar a sua aplicação ClickOnce ou precise utilizar funcionalidades avançadas de implantação, como Implantação de Aplicação Confiável, deverá usar a ferramenta de linha de comandos Mage.exe para criar os seus manifestos ClickOnce. Este passo a passo descreve como criar uma implantação do ClickOnce usando a versão de linha de comando (Mage.exe) ou a versão gráfica (MageUI.exe) da Ferramenta de Geração e Edição de Manifesto.

Observação

No ClickOnce para .NET Core 3.1 e .NET 5 ou posterior, use dotnet-mage.exe em vez de Mage.exe. Para obter mais informações, consulte ClickOnce para .NET.

Pré-requisitos

Este passo a passo tem alguns pré-requisitos e opções que você precisa escolher antes de criar uma implantação.

Instale Mage.exe e MageUI.exe.

Mage.exe e MageUI.exe fazem parte do Windows Software Development Kit (SDK). Você deve ter o SDK do Windows instalado ou a versão do SDK do Windows incluída no Visual Studio.
Forneça um aplicativo para implantação.

Este passo a passo pressupõe que você tenha um aplicativo do Windows pronto para implantar. Este aplicativo será conhecido como AppToDeploy.
Determine como a implantação será distribuída.

As opções de distribuição incluem: Web, compartilhamento de arquivos ou CD. Para obter mais informações, consulte ClickOnce Security and Deployment.
Determine se o aplicativo requer um nível elevado de confiança.

Se o seu aplicativo exigir Confiança Total — por exemplo, acesso total ao sistema do usuário — você poderá usar a -TrustLevel opção de Mage.exe para definir isso. Se você quiser definir um conjunto de permissões personalizado para seu aplicativo, você pode copiar a seção de permissão da Internet ou intranet de outro manifesto, modificá-lo para atender às suas necessidades e adicioná-lo ao manifesto do aplicativo usando um editor de texto ou MageUI.exe. Para obter mais informações, consulte Visão geral da implantação de aplicativos confiáveis.
Obtenha um certificado Authenticode.

Você deve assinar sua implementação com um certificado Authenticode. Você pode gerar um certificado de teste usando o Visual Studio, MageUI.exeou MakeCert.exe e Pvk2Pfx.exe ferramentas, ou você pode obter um certificado de uma autoridade de certificação (CA). Se você optar por usar a Implantação de Aplicativo Confiável, também deverá executar uma instalação única do certificado em todos os computadores clientes. Para obter mais informações, consulte Visão geral da implantação de aplicativos confiáveis.

Observação

Você também pode assinar sua implantação com um certificado CNG que pode ser obtido de uma Autoridade de Certificação.
Certifique-se de que o aplicativo não tem um manifesto com informações do UAC.

Você precisa determinar se seu aplicativo contém um manifesto com informações de Controle de Conta de Usuário (UAC), como um <dependentAssembly> elemento . Para examinar um manifesto de aplicativo, você pode usar o utilitário Sigcheck do Windows Sysinternals.

Se seu aplicativo contiver um manifesto com detalhes do UAC, você deverá recriá-lo sem as informações do UAC. Para um projeto C# no Visual Studio, abra as propriedades do projeto e selecione a guia Aplicativo. Na lista suspensa Manifesto , selecione Criar aplicativo sem manifesto. Para um projeto do Visual Basic no Visual Studio, abra as propriedades do projeto, selecione a guia Aplicativo e clique em Exibir Configurações do UAC. No arquivo de manifesto aberto, remova todos os elementos dentro do <asmv1:assembly> único elemento.
Determine se o aplicativo requer pré-requisitos no computador cliente.

As aplicações ClickOnce implantadas a partir do Visual Studio podem incluir um instalador inicial de pré-requisitos (setup.exe) com a sua implementação. Este passo a passo cria os dois manifestos necessários para uma implantação do ClickOnce. Você pode criar um bootstrapper para pré-requisitos usando a tarefa GenerateBootstrapper.

Para implantar um aplicativo com a ferramenta de linha de comando Mage.exe

Crie um diretório onde você armazenará seus arquivos de implantação do ClickOnce.
No diretório de implantação que você acabou de criar, crie um subdiretório de versão. Se esta for a primeira vez que você está implantando o aplicativo, nomeie o subdiretório de versão 1.0.0.0.

Observação

A versão da sua implantação pode ser distinta da versão do seu aplicativo.
Copie todos os arquivos do aplicativo para o subdiretório version, incluindo arquivos executáveis, assemblies, recursos e arquivos de dados. Se necessário, você pode criar subdiretórios adicionais que contenham arquivos adicionais.
Abra o prompt de comando do SDK do Windows ou do Visual Studio e mude para o subdiretório version.
Crie o manifesto do aplicativo com uma chamada para Mage.exe. A instrução a seguir cria um manifesto do aplicativo para que o código compilado seja executado no processador Intel x86.
```
mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory .
```
Observação

Certifique-se de incluir o ponto (.) após a -FromDirectory opção, que indica o diretório atual. Se não incluires o ponto, deves especificar o caminho para os arquivos da aplicação.
Assine o manifesto do aplicativo com seu certificado Authenticode. Substitua mycert.pfx pelo caminho para o arquivo de certificado. Substitua passwd pela senha do arquivo de certificado.
```
mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd
```
A partir do SDK do .NET Framework 4.6.2, que é distribuído com o Visual Studio e com o SDK do Windows, mage.exe assina manifestos tanto com CNG como com assinaturas Authenticode. Use os mesmos parâmetros de linha de comando que os certificados Authenticode.
Vá para a raiz do diretório de implantação.
Gere o manifesto de implantação com uma chamada para Mage.exe. Por padrão, Mage.exe marcará sua implantação do ClickOnce como um aplicativo instalado, para que possa ser executado online e offline. Para disponibilizar a aplicação apenas quando o utilizador estiver online, utilize a opção -Install com o valor de false. Se você usar o padrão e os usuários instalarem seu aplicativo a partir de um site ou compartilhamento de arquivos, verifique se o valor da -ProviderUrl opção aponta para o local do manifesto do aplicativo no servidor Web ou compartilhamento.
```
mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application
```
Assine o manifesto de implantação com seu certificado Authenticode ou CNG.
```
mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd
```
Copie todos os arquivos no diretório de implantação para o destino ou mídia de implantação. Isso pode ser uma pasta em um site ou site FTP, um compartilhamento de arquivos ou um CD-ROM.
Forneça aos usuários a URL, UNC ou mídia física necessária para instalar seu aplicativo. Se você fornecer uma URL ou um UNC, deverá fornecer aos usuários o caminho completo para o manifesto de implantação. Por exemplo, se o AppToDeploy for desdobrado em http://webserver01/ no diretório AppToDeploy, o caminho de URL completo será http://webserver01/AppToDeploy/AppToDeploy.application.

Para implementar uma aplicação com a ferramenta gráfica MageUI.exe

Crie um diretório onde você armazenará seus arquivos de implantação do ClickOnce.
No diretório de implantação que você acabou de criar, crie um subdiretório de versão. Se esta for a primeira vez que você está implantando o aplicativo, nomeie o subdiretório de versão 1.0.0.0.

Observação

A versão da sua implantação é provavelmente distinta da versão do seu aplicativo.
Copie todos os arquivos do aplicativo para o subdiretório version, incluindo arquivos executáveis, assemblies, recursos e arquivos de dados. Se necessário, você pode criar subdiretórios adicionais que contenham arquivos adicionais.
Inicie a MageUI.exe ferramenta gráfica.
```
MageUI.exe
```
Crie um novo manifesto do aplicativo selecionando Arquivo, Novo, Manifesto do aplicativo no menu.
Na guia Nome padrão, digite o nome e o número da versão dessa implantação. Especifique também o processador para o qual seu aplicativo foi criado, como x86.
Selecione a guia Arquivos e, em seguida, selecione o botão de reticências (...) ao lado da caixa de texto Diretório de aplicativos. Uma caixa de diálogo Procurar pasta é exibida.
Selecione o subdiretório version que contém os arquivos do aplicativo e, em seguida, selecione OK.
Se fores desenvolver a partir dos Serviços de Informação da Internet (IIS), seleciona a caixa de verificação Quando preencher, adicionar a extensão .deploy a qualquer ficheiro que não a possua.
Vá para o botão Preencher para adicionar todos os seus arquivos de aplicativo à lista de arquivos. Se seu aplicativo contiver mais de um arquivo executável, marque o arquivo executável principal para esta implantação como o aplicativo de inicialização selecionando Ponto de entrada na lista suspensa Tipo de arquivo . (Se o seu aplicativo contiver apenas um arquivo executável, MageUI.exe irá marcá-lo para você.)
Selecione a guia Permissões necessárias e selecione o nível de confiança que você precisa que seu aplicativo afirme. O padrão é FullTrust, que será adequado para a maioria dos aplicativos.
Selecione Ficheiro, Guardar como no menu. Uma caixa de diálogo Opções de assinatura é exibida solicitando que você assine o manifesto do aplicativo.
Se você tiver um certificado armazenado como um arquivo em seu sistema de arquivos, use a opção Assinar com arquivo de certificado e selecione o certificado do sistema de arquivos usando o botão de reticências (...). Em seguida, digite a senha do certificado.

-ou-

Se o certificado for mantido em um armazenamento de certificados acessível a partir do computador, selecione a opção Assinar com certificado armazenado e selecione o certificado na lista fornecida.
Selecione OK para assinar o manifesto do aplicativo. A caixa de diálogo Salvar como é exibida.
Na caixa de diálogo Salvar como , especifique o diretório de versão e selecione Salvar.
Selecione Arquivo, Novo, Manifesto de Implantação no menu para criar seu manifesto de implantação.
Na guia Nome , especifique um nome e um número de versão para essa implantação (1.0.0.0 neste exemplo). Especifique também o processador para o qual seu aplicativo foi criado, como x86.
Selecione a guia Descrição e especifique valores para Publicador e Produto. (Produto é o nome dado ao seu aplicativo no menu Iniciar do Windows quando seu aplicativo é instalado em um computador cliente para uso offline.)
Selecione a guia Opções de Implantação e, na caixa de texto Local Inicial , especifique o local do manifesto do aplicativo no servidor Web ou compartilhamento. Por exemplo, \\myServer\myShare\AppToDeploy.application.
Se tiver adicionado a extensão .deploy numa etapa anterior, selecione também Usar extensão de nome de arquivo .deploy aqui.
Selecione a guia Opções de atualização e especifique com que frequência você gostaria que esse aplicativo fosse atualizado. Se o seu aplicativo usa UpdateCheckInfo para verificar se há atualizações em si, desmarque a caixa de seleção Este aplicativo deve verificar se há atualizações .
Selecione a guia Referência do aplicativo e, em seguida, vá para o botão Selecionar manifesto . Uma caixa de diálogo aberta é exibida.
Selecione o manifesto do aplicativo que você criou anteriormente e, em seguida, selecione Abrir.
Selecione Ficheiro, Guardar como no menu. Uma caixa de diálogo Opções de Assinatura é exibida solicitando que você assine o manifesto de implantação.
Se você tiver um certificado armazenado como um arquivo em seu sistema de arquivos, use a opção Assinar com arquivo de certificado e selecione o certificado do sistema de arquivos usando o botão de reticências (...). Em seguida, digite a senha do certificado.

-ou-

Se o certificado for mantido em um armazenamento de certificados acessível a partir do computador, selecione a opção Assinar com certificado armazenado e selecione o certificado na lista fornecida.
Vá para OK para assinar seu manifesto de implantação. A caixa de diálogo Salvar como é exibida.
Na caixa de diálogo Salvar como , mova um diretório para cima até a raiz da implantação e selecione Salvar.
Copie todos os arquivos no diretório de implantação para o destino ou mídia de implantação. Isso pode ser uma pasta em um site ou site FTP, um compartilhamento de arquivos ou um CD-ROM.
Forneça aos usuários a URL, UNC ou mídia física necessária para instalar seu aplicativo. Se você fornecer uma URL ou um UNC, deverá fornecer aos usuários o caminho completo do manifesto de implantação. Por exemplo, se o AppToDeploy for desdobrado em http://webserver01/ no diretório AppToDeploy, o caminho de URL completo será http://webserver01/AppToDeploy/AppToDeploy.application.

Próximos passos

Quando precisar implantar uma nova versão do aplicativo, crie um novo diretório com o nome da nova versão — por exemplo, 1.0.0.1 — e copie os novos arquivos do aplicativo para o novo diretório. Em seguida, você precisa seguir as etapas anteriores para criar e assinar um novo manifesto do aplicativo e atualizar e assinar o manifesto de implantação. Tenha cuidado para especificar a mesma versão superior nas chamadas Mage.exe, -New e -Update, pois o ClickOnce atualiza somente para versões superiores, com o inteiro mais à esquerda como o mais significativo. Se você usou MageUI.exe, você pode atualizar o manifesto de implantação abrindo-o, selecionando a guia Referência do aplicativo , vá para o botão Selecionar manifesto e, em seguida, selecionando o manifesto do aplicativo atualizado.

Comentários

Esta página foi útil?

Last updated on 2025-08-07