Passo a passo: implantar manualmente um aplicativo ClickOnce que não exija nova assinatura e que preserve as informações de identidade visual

Quando você cria um aplicativo ClickOnce e, em seguida, dá-lo a um cliente para publicar e implantar, o cliente tradicionalmente tem que atualizar o manifesto de implantação e assiná-lo novamente. Embora esse ainda seja o método preferido na maioria dos casos, o .NET Framework 3.5 permite que você crie implantações ClickOnce que podem ser implantadas pelos clientes sem ter que regenerar um novo manifesto de implantação. Para obter mais informações, consulte Implantar aplicativos ClickOnce para servidores de teste e produção sem renunciar.

Quando você cria um aplicativo ClickOnce e, em seguida, dá-lo a um cliente para publicar e implantar, o aplicativo pode usar a marca do cliente ou pode preservar sua marca. Por exemplo, se o aplicativo for um único aplicativo proprietário, convém preservar sua marca. Se a aplicação for altamente personalizada para cada cliente, pode querer usar a marca do cliente. O .NET Framework 3.5 permite que você preserve sua marca, informações do editor e assinatura de segurança quando você dá um aplicativo para uma organização implantar. Para obter mais informações, consulte Criar aplicativos ClickOnce para outros implantarem.

Pré-requisitos

Para executar as etapas neste passo a passo, você precisa do seguinte:

• Um aplicativo do Windows Forms que você está pronto para implantar. Este aplicativo será referido como WindowsFormsApp1.

• Visual Studio ou o SDK do Windows.

Para implantar um aplicativo ClickOnce com vários suportes de implantação e identidade visual usando Mage.exe

1. Abra um prompt de comando do Visual Studio ou um prompt de comando do SDK do Windows e mude para o diretório no qual você armazenará seus arquivos ClickOnce.

2. Crie um diretório com o nome da versão atual da sua implantação. Se esta for a primeira vez que você está implantando o aplicativo, você provavelmente escolherá 1.0.0.0.

   Observação

   A versão da implantação pode ser distinta da versão dos arquivos do aplicativo.

3. Crie um subdiretório chamado bin e copie todos os seus arquivos de aplicativo aqui, incluindo arquivos executáveis, assemblies, recursos e arquivos de dados.

4. Gere o manifesto do aplicativo com uma chamada para Mage.exe.

   mage -New Application -ToFile 1.0.0.0\WindowsFormsApp1.exe.manifest -Name "Windows Forms App 1" -Version 1.0.0.0 -FromDirectory 1.0.0.0\bin -UseManifestForTrust true -Publisher "A. Datum Corporation"
   

5. Assine o manifesto do aplicativo com seu certificado digital.

   mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx
   

6. 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 o aplicativo somente quando o usuário estiver online, use o -i argumento com um valor de f. Como esse aplicativo aproveitará o recurso de implantação múltipla, exclua o -providerUrl argumento para Mage.exe. (Em versões do .NET Framework anteriores à versão 3.5, excluir -providerUrl para um aplicativo offline resultará em um erro.)

   mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest
   

7. Não assine o manifesto de implantação.

8. Forneça todos os arquivos ao cliente, que implantará o aplicativo em sua rede.

9. Neste ponto, o cliente deve assinar o manifesto de implantação com seu próprio certificado autogerado. Por exemplo, se o cliente trabalha para uma empresa chamada Adventure Works, ele pode gerar um certificado autoassinado usando a ferramenta MakeCert.exe . Em seguida, use a ferramenta Pvk2pfx.exe para combinar os arquivos criados por MakeCert.exe em um arquivo PFX que pode ser passado para Mage.exe.

   makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
   pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
   

10. Em seguida, o cliente usa esse certificado para assinar o manifesto de implantação.

    mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx
    

11. O cliente implanta o aplicativo para seus usuários.

Para implantar um aplicativo ClickOnce com suporte para múltiplas implantações e suporte de marca usando MageUI.exe

1. Abra um prompt de comando do Visual Studio ou um prompt de comando do SDK do Windows e navegue até o diretório no qual você armazenará seus arquivos ClickOnce.

2. Crie um subdiretório chamado bin e copie todos os seus arquivos de aplicativo aqui, incluindo arquivos executáveis, assemblies, recursos e arquivos de dados.

3. Crie um subdiretório com o nome da versão atual da sua implantação. Se esta for a primeira vez que você está implantando o aplicativo, você provavelmente escolherá 1.0.0.0.

   Observação

   A versão da implantação pode ser distinta da versão dos arquivos do aplicativo.

4. Mova o diretório \bin para o diretório criado na etapa 2.

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

   MageUI.exe
   

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

7. Na guia Nome padrão, insira o nome e o número da versão desta implantação. Além disso, forneça um valor para o Publisher, que será usado como o nome da pasta para o link de atalho do aplicativo no menu Iniciar quando ele for implantado.

8. Selecione a guia Opções do aplicativo e clique em Usar manifesto do aplicativo para informações de confiança. Isso permitirá a identidade visual de terceiros para este aplicativo ClickOnce.

9. Selecione a guia Arquivos e clique no botão Procurar ao lado da caixa de texto Diretório de aplicativos .

10. Selecione o diretório que contém os arquivos do aplicativo que você criou na etapa 2 e clique em OK na caixa de diálogo de seleção de pasta.

11. Clique no botão Preencher para adicionar todos os arquivos do 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 o marcará para você.)

12. 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 é Full Trust, que será apropriado para a maioria dos aplicativos.

13. Selecione Arquivo, Salvar no menu e salve o manifesto do aplicativo. Você será solicitado a assinar o manifesto do aplicativo quando salvá-lo.

14. Se você tiver um certificado armazenado como um arquivo em seu sistema de arquivos, use a opção Assinar como arquivo de certificado e selecione o certificado do sistema de arquivos usando o botão de reticências (...).

    -ou-

    Se o certificado for mantido em um armazenamento de certificados que possa ser acessado a partir do computador, selecione a opção Assinar com certificado armazenado e selecione o certificado na lista fornecida.

15. Selecione Arquivo, Novo, Manifesto de Implantação no menu para criar seu manifesto de implantação e, na guia Nome , forneça um nome e um número de versão (1.0.0.0 neste exemplo).

16. Mude para o separador Atualizar e especifique a frequência com que pretende que esta aplicação seja atualizada. Se seu aplicativo usa a API de implantação ClickOnce para verificar se há atualizações, desmarque a caixa de seleção Este aplicativo deve verificar se há atualizações.

17. Alterne para a guia Referência do aplicativo . Você pode preencher previamente todos os valores nesta guia clicando no botão Selecionar manifesto e selecionando o manifesto do aplicativo criado nas etapas anteriores.

18. Escolha Salvar e salve o manifesto de implantação no disco. Você será solicitado a assinar o manifesto do aplicativo quando salvá-lo. Clique em Cancelar para salvar o manifesto sem assiná-lo.

19. Forneça todos os arquivos do aplicativo ao cliente.

20. Neste ponto, o cliente deve assinar o manifesto de implantação com seu próprio certificado autogerado. Por exemplo, se o cliente trabalha para uma empresa chamada Adventure Works, ele pode gerar um certificado autoassinado usando a ferramenta MakeCert.exe . Em seguida, use a ferramenta Pvk2pfx.exe para combinar os arquivos criados por MakeCert.exe em um arquivo PFX que pode ser passado para MageUI.exe.

    makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
    pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
    

21. Com o certificado gerado, o cliente agora assina o manifesto de implantação abrindo o manifesto de implantação em MageUI.exee, em seguida, salvando-o. Quando a caixa de diálogo de assinatura aparece, o cliente seleciona a opção Assinar como arquivo de certificado e escolhe o arquivo PFX que ele salvou no disco.

22. O cliente implanta o aplicativo para seus usuários.

Conteúdo relacionado

• Mage.exe (Ferramenta de Geração e Edição de Manifestos)
• MageUI.exe (Ferramenta de Geração e Edição de Manifestos, Cliente Gráfico)
• MakeCert