Compartilhar via

Passo a passo: implantar manualmente um aplicativo ClickOnce

Se você não puder usar o Visual Studio para implantar seu aplicativo ClickOnce ou precisar usar recursos avançados de implantação, como a Implantação de Aplicativo Confiável, deverá usar a Mage.exe ferramenta de linha de comando para criar seus manifestos do 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, confira 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.

  • Instalar Mage.exe e MageUI.exe.

    Mage.exe e MageUI.exe fazem parte do SDK (Kit de Desenvolvimento de Software) do Windows. 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 implantar.

    Este passo a passo pressupõe que você tenha um aplicativo do Windows que está pronto para implantar. Esse aplicativo será chamado de 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 Segurança e Implantação do ClickOnce.

  • Determine se o aplicativo requer um nível elevado de confiança.

    Se o aplicativo exigir confiança total, por exemplo, acesso total ao sistema do usuário, você poderá usar a opção -TrustLevel de Mage.exe definir isso. Se você quiser definir um conjunto de permissões personalizado para seu aplicativo, poderá copiar a seção de permissão da Internet ou intranet de outro manifesto, modificá-la para atender às suas necessidades e adicioná-la ao manifesto do aplicativo usando um editor de texto ou MageUI.exe. Para obter mais informações, consulte a visão geral da Implantação de Aplicativos Confiáveis.

  • Obtenha um certificado Authenticode.

    Você deve assinar sua implantação com um certificado Authenticode. Você pode gerar um certificado de teste usando o Visual Studio, MageUI.exe, ou as ferramentas MakeCert.exe e Pvk2Pfx.exe, ou obter um certificado de uma AC (Autoridade de Certificação). 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 cliente. Para obter mais informações, consulte Visão geral da implantação de aplicativo confiável.

    Observação

    Você também pode assinar sua implantação com um certificado CNG obtido de uma Autoridade de Certificação.

  • Certifique-se de que o aplicativo não tenha um manifesto com informações do UAC.

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

    Se o aplicativo contiver um manifesto com detalhes do UAC, você deverá compilá-lo novamente sem as informações do UAC. Para um projeto em C# no Visual Studio, abra as propriedades do projeto e selecione a guia Aplicativo. Na lista suspensa Manifesto , selecione Criar aplicativo sem um 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 único <asmv1:assembly> elemento.

  • Determine se o aplicativo requer pré-requisitos no computador cliente.

    Os aplicativos ClickOnce implantados a partir do Visual Studio podem incluir um bootstrapper de instalação de pré-requisitos (setup.exe) com a sua implantação. Este passo a passo cria os dois manifestos necessários para uma implantação do ClickOnce. Você pode criar um bootstrapper de pré-requisitos usando a tarefa GenerateBootstrapper.

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

  1. Crie um diretório em que você armazenará os arquivos de implantação do ClickOnce.

  2. 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 implantação pode ser distinta da versão do aplicativo.

  3. Copie todos os arquivos do aplicativo para o subdiretório de versão, incluindo arquivos executáveis, assemblies, recursos e arquivos de dados. Se necessário, você pode criar subdiretórios adicionais que contêm arquivos adicionais.

  4. Abra o prompt de comando do SDK do Windows ou do Visual Studio e altere para o subdiretório de versão.

  5. Crie o manifesto do aplicativo com uma chamada para Mage.exe. A instrução a seguir cria um manifesto do aplicativo para o código compilado para ser 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 opção -FromDirectory , que indica o diretório atual. Se você não incluir o ponto, deverá especificar o caminho para os arquivos do aplicativo.

  6. Assine o manifesto do aplicativo com o 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 o Windows SDK, mage.exe assina manifestos com CNG e certificados Authenticode. Use os mesmos parâmetros de linha de comando que com certificados Authenticode.

  7. Mude para a raiz do diretório de implantação.

  8. 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 ele possa ser executado online e offline. Para disponibilizar o aplicativo somente quando o usuário estiver online, use a opção -Install com um valor igual falsea . Se você usar o padrão e os usuários instalarem seu aplicativo de um site ou compartilhamento de arquivos, verifique se o valor da opção -ProviderUrl 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

  9. Assine o manifesto de implantação com seu certificado Authenticode ou CNG.

    mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd

  10. 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 uma CD-ROM.

  11. 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 implantado http://webserver01/ no diretório AppToDeploy, o caminho de URL completo será http://webserver01/AppToDeploy/AppToDeploy.application.

Para implantar um aplicativo usando a ferramenta gráfica MageUI.exe

  1. Crie um diretório em que você armazenará os arquivos de implantação do ClickOnce.

  2. 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 implantação provavelmente é distinta da versão do seu aplicativo.

  3. Copie todos os arquivos do aplicativo para o subdiretório de versão, incluindo arquivos executáveis, assemblies, recursos e arquivos de dados. Se necessário, você pode criar subdiretórios adicionais que contêm arquivos adicionais.

  4. Inicie a MageUI.exe ferramenta gráfica.

    MageUI.exe

  5. Crie um novo manifesto do aplicativo selecionando Arquivo, Novo, Manifesto do Aplicativo no menu.

  6. 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.

  7. Selecione a guia Arquivos e, em seguida, selecione o botão de reticências (...) ao lado da caixa de texto do Diretório do Aplicativo. Uma caixa de diálogo Procurar Pasta é exibida.

  8. Selecione o subdiretório de versão que contém os arquivos do aplicativo e selecione OK.

  9. Se você implantar pelos Serviços de Informações da Internet (IIS), selecione a caixa de seleção Adicionar a extensão .deploy a qualquer arquivo que não a tenha ao preencher.

  10. 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 essa implantação como o aplicativo de inicialização selecionando o Ponto de Entrada na lista suspensa Tipo de Arquivo . (Se o aplicativo contiver apenas um arquivo executável, MageUI.exe marcará para você.)

  11. 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.

  12. Selecione Arquivo, Salvar como no menu. Uma caixa de diálogo Opções de Assinatura é exibida solicitando que você assine o manifesto do aplicativo.

  13. 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 no sistema de arquivos usando o botão de reticências (...). Em seguida, digite sua senha de certificado.

    - ou -

    Se o certificado for mantido em um repositório de certificados acessível no computador, selecione a opção Assinar com certificado armazenado e selecione o certificado na lista fornecida.

  14. Selecione OK para assinar o manifesto do aplicativo. A caixa de diálogo Salvar como é exibida.

  15. Na caixa de diálogo Salvar como , especifique o diretório de versão e selecione Salvar.

  16. Selecione Arquivo, Novomanifesto de implantação no menu para criar seu manifesto de implantação.

  17. 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.

  18. Selecione a guia Descrição e especifique valores para Publicador e Produto. (Produto é o nome fornecido ao seu aplicativo no menu Iniciar do Windows quando seu aplicativo é instalado em um computador cliente para uso offline.)

  19. Selecione a guia Opções de Implantação e, na caixa de texto Local de Início, especifique o local do manifesto do aplicativo no servidor Web ou no compartilhamento de rede. Por exemplo, \\myServer\myShare\AppToDeploy.application.

  20. Se você adicionou a .deploy extensão em uma etapa anterior, selecione também Usar a extensão de nome de arquivo .deploy aqui.

  21. Selecione a guia Opções de Atualização e especifique com que frequência você gostaria que este aplicativo fosse atualizado. Se o aplicativo usar UpdateCheckInfo para verificar se há atualizações por conta própria, desmarque a caixa de seleção Este aplicativo deve verificar se há atualizações.

  22. Selecione a guia Referência do Aplicativo e vá para o botão Selecionar Manifesto . Uma caixa de diálogo aberta é exibida.

  23. Selecione o manifesto do aplicativo que você criou anteriormente e selecione Abrir.

  24. Selecione Arquivo, Salvar como no menu. Uma caixa de diálogo Opções de Assinatura é exibida solicitando que você assine o manifesto de implantação.

  25. 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 no sistema de arquivos usando o botão de reticências (...). Em seguida, digite sua senha de certificado.

    - ou -

    Se o certificado for mantido em um repositório de certificados acessível no computador, selecione a opção Assinar com certificado armazenado e selecione o certificado na lista fornecida.

  26. Vá para OK para assinar o manifesto de implantação. A caixa de diálogo Salvar como é exibida.

  27. Na caixa de diálogo Salvar como , mova um diretório para a raiz da implantação e selecione Salvar.

  28. 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 uma CD-ROM.

  29. 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 uma UNC, deverá fornecer aos usuários o caminho completo do manifesto de implantação. Por exemplo, se o AppToDeploy for implantado http://webserver01/ no diretório AppToDeploy, o caminho de URL completo será http://webserver01/AppToDeploy/AppToDeploy.application.

Próximas etapas

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 de aplicativo para o novo diretório. Em seguida, você precisa seguir as etapas anteriores para criar e assinar um novo manifesto do aplicativo, 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 só atualiza versões mais altas, com o inteiro mais à esquerda sendo o mais significativo. Se você usou MageUI.exe, pode atualizar o manifesto de implantação abrindo-o, selecionando a guia Referência do Aplicativo , acesse o botão Selecionar Manifesto e, em seguida, selecionando o manifesto do aplicativo atualizado.

Conteúdo relacionado