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

Quando você cria um aplicativo ClickOnce e o dá a um cliente para publicar e implantar, o cliente tradicionalmente precisa atualizar o manifesto de implantação e reassiná-lo. Embora esse ainda seja o método preferencial na maioria dos casos, o .NET Framework 3.5 permite criar implantações do ClickOnce que podem ser implantadas pelos clientes sem precisar 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, o concede a um cliente para publicar e implantar, o aplicativo pode usar a identidade visual do cliente ou preservar sua identidade visual. Por exemplo, se o aplicativo for um único aplicativo proprietário, talvez você queira preservar sua identidade visual. Se o aplicativo for altamente personalizado para cada cliente, talvez você queira usar a identidade visual do cliente. O .NET Framework 3.5 permite que você preserve sua identidade visual, informações do editor e assinatura de segurança ao fornecer um aplicativo para uma organização implantar. Para obter mais informações, consulte Criar aplicativos ClickOnce para que outras pessoas implantem.

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. Esse aplicativo será chamado de WindowsFormsApp1.

• Visual Studio ou o SDK do Windows.

Para implantar um aplicativo ClickOnce com suporte a múltiplas implantações 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 altere para o diretório no qual você armazenará seus arquivos ClickOnce.

2. Crie um diretório com o nome da versão atual da implantação. Se esta for a primeira vez que você está implantando o aplicativo, 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 arquivos do 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 ele possa ser executado online e offline. Para disponibilizar o aplicativo somente quando o usuário estiver online, use o -i argumento com um valor igual fa . 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, a exclusão -providerUrl de 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 várias implantações e suporte à identidade visual 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 arquivos do 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, 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 que você criou 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 dessa 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 habilitará 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 do aplicativo .

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

11. Clique no 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 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 é a Confiança Total, que será apropriada para a maioria dos aplicativos.

13. Selecione Arquivo, Salve no menu e salve o manifesto do aplicativo. Você será solicitado a assinar o manifesto do aplicativo ao 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 no sistema de arquivos usando o botão de reticências (...).

    - ou -

    Se o certificado for mantido em um repositório de certificados que pode ser acessado no 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. Alterne para a guia Atualizar e especifique a frequência com que deseja que esse aplicativo seja atualizado. Se o aplicativo usar a API de Implantação clickOnce para verificar se há atualizações em si, desmarque a caixa de seleção rotulada Este aplicativo deve verificar se há atualizações.

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

18. Escolha Salvar e salvar o manifesto de implantação em disco. Você será solicitado a assinar o manifesto do aplicativo ao 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 no MageUI.exee salvando-o. Quando a caixa de diálogo de assinatura é exibida, o cliente seleciona a opção Assinar como arquivo de certificado e escolhe o arquivo PFX que ele salvou em disco.

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

Conteúdo relacionado

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