Passo a passo: Implantando manualmente um aplicativo que não requer Re-Signing e que preserva informações de identidade visual do ClickOnce

Artigo
02/25/2013

Quando você cria um ClickOnce aplicativo e dê a ele a um cliente para publicar e implantar, o cliente teve tradicionalmente atualizar o manifesto de implantação e assinar novamente a ele. Enquanto ainda é o método preferencial na maioria dos casos, o.NET Framework 3.5 permite que você crie ClickOnce implantações que podem ser implantadas por clientes, sem a necessidade de gerar um novo manifesto de implantação.Para obter mais informações, consulte A implantação de aplicativos de ClickOnce para teste e servidores de produção sem desistir.

Quando você cria um ClickOnce aplicativo e dê a ele a um cliente para publicar e implantar, o aplicativo pode usar a identificação de marca do cliente ou pode preservar a sua marca.Por exemplo, se o aplicativo for um único aplicativo proprietário, você talvez queira preservar sua marca.Se o aplicativo é altamente personalizado para cada cliente, convém usar a identificação de marca do cliente.A.NET Framework 3.5 permite preservar sua marca, informações sobre a editora e assinatura de segurança ao conceder para implantar um aplicativo para uma organização.Para obter mais informações, consulte Criação de aplicativos de ClickOnce para outras pessoas para implantar.

Observação
Esta explicação passo a passo você cria implantações manualmente usando a ferramenta de linha de comando Mage ou a ferramenta gráfica MageUI.exe.Para obter mais informações sobre implantações manuais, consulte Passo a passo: Manualmente implantando um aplicativo de ClickOnce.

Pré-requisitos

Para executar as etapas nesta explicação passo a passo, você precisa do seguinte:

Um aplicativo Windows Forms que você está pronto para implantar.Este aplicativo será ser conhecido como WindowsFormsApp1.
Visual Studio ou o SDK do Windows.

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

Abra um prompt de comando Visual Studio ou um Windows SDK prompt de comando e altere para o diretório no qual você armazenará seus ClickOnce arquivos.
Crie um diretório chamado após a versão atual da sua implantação.Se esta for a primeira vez que você estiver implantando o aplicativo, você provavelmente escolherá 1.0.0.0.

Observação

A versão da sua implantação pode ser distinta da versão de seus arquivos de aplicativo.
Crie uma subpasta chamada bin e copiar todos os arquivos do aplicativo aqui, incluindo arquivos executáveis, assemblies, recursos e arquivos de dados.

Observação
A versão da sua implantação pode ser distinta da versão de seus arquivos de aplicativo.

Gere o manifesto de aplicativo com uma chamada para Mage.

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"

Assinar o manifesto do aplicativo com o seu certificado digital.
```
mage -Sign WindowsFormsApp1.exe.manifest -CertFile mycert.pfx
```
Gere o manifesto de implantação com uma chamada para Mage.Por padrão, o Mage marcará seu ClickOnce implantação como um aplicativo instalado, de modo que ele pode ser executado tanto on-line e off-line.Para tornar o aplicativo disponível somente quando o usuário está online, use o -i argumento com um valor de f.Uma vez que este aplicativo será aproveitar o recurso de implantação de vários, excluir o -providerUrl argumento para Mage.(Nas versões do.NET Framework anterior à versão 3.5, excluindo -providerUrl para um aplicativo offline resultará em erro.)
```
mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest 
```
Não assine o manifesto de implantação.
Forneça todos os arquivos para o cliente, quem irá implantar o aplicativo em sua rede.
Neste ponto, o cliente deve assinar o manifesto de implantação com o seu próprio certificado gerado automaticamente.Por exemplo, se o cliente trabalha para uma empresa chamada Adventure Works, ele pode gerar um certificado auto-assinado usando a ferramenta Makecert.Em seguida, use a ferramenta Pvk2pfx.exe para combinar os arquivos criados pelo Makecert em um arquivo PFX que pode ser passado para Mage.
```
makecert -r -pe -n "CN=Adventure Works" -sv MyCert.pvk MyCert.cer
pvk2pfx.exe -pvk MyCert.pvk -spc MyCert.cer -pfx MyCert.pfx
```
Em seguida, o cliente usa esse certificado para assinar o manifesto de implantação.
```
mage -Sign WindowsFormsApp1.application -CertFile MyCert.pfx
```
O cliente implanta o aplicativo para seus usuários.

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

Abra um prompt de comando Visual Studio ou um Windows SDK prompt de comando e navegue até o diretório no qual você armazenará seus ClickOnce arquivos.
Crie uma subpasta chamada bin e copiar todos os arquivos do aplicativo aqui, incluindo arquivos executáveis, assemblies, recursos e arquivos de dados.
Crie um subdiretório nomeado de acordo com a versão atual da sua implantação.Se esta for a primeira vez que você estiver implantando o aplicativo, você provavelmente escolherá 1.0.0.0.

Observação

A versão da sua implantação pode ser distinta da versão de seus arquivos de aplicativo.
Mova o diretório \bin para o diretório que você criou na etapa 2.
Inicie a ferramenta gráfica MageUI.exe.
```
MageUI.exe
```
Criar um novo manifesto de aplicativo selecionando arquivo, nova, O manifesto de aplicativo no menu.
No padrão nome Insira o nome e número de versão desta implantação.Além disso, fornecer um valor para Publisher, que será usado como o nome da pasta para o link de atalho do aplicativo no menu Iniciar quando ele for implantado.
Selecione o Opções de aplicativos guia e clique em O manifesto de aplicativo de uso para confiar em informações.Isso permitirá a identificação de marca de terceiros para este ClickOnce aplicativo.
Selecione o arquivos guia e clique no Procurar o botão ao lado da caixa de texto do diretório de aplicativo.
Selecione o diretório que contém seus arquivos de aplicativo que você criou na etapa 2 e, em seguida, clique em OK na caixa de diálogo de seleção de pasta.
Clique no popular botão para adicionar todos os seus arquivos de aplicativo à lista de arquivos.Se seu aplicativo contém mais de um arquivo executável, marcar o arquivo executável para essa implantação como o aplicativo de inicialização principal selecionando Ponto de entrada da Tipo de arquivo na lista suspensa.(Se seu aplicativo contém apenas um arquivo executável, MageUI.exe será marcá-la para você.)
Selecione o as permissões necessárias e selecione o nível de confiança que você precisa declarar seu aplicativo.O padrão é Confiança total, que poderão ser apropriado para a maioria dos aplicativos.
Selecione arquivo, Salvar no menu e salvar o manifesto do aplicativo.Você será solicitado para assinar o manifesto de aplicativo quando você salvá-lo.
Se você tiver um certificado armazenado como um arquivo no seu sistema de arquivos, use o sinal que o arquivo de certificado opção e selecione o certificado do sistema de arquivos usando as reticências (...) botão.

- ou -

Se o seu certificado é mantido em um armazenamento de certificados que pode ser acessado a partir do seu computador, selecione o sinal com opção de certificado armazenadoe selecione o certificado da lista fornecida.
Selecione arquivo, nova, O manifesto de implantação no menu para criar seu manifesto de implantação e no nome da sala, forneça um nome e número de versão (1.0.0.0 neste exemplo).
Alterne para o atualização guia e especificar com que freqüência você deseja que este aplicativo para atualizar.Se seu aplicativo usa a ClickOnce API de implantação para verificar se há atualizações propriamente dito, desmarque a caixa de seleção esse aplicativo deve verificar as atualizações.
Alterne para o Aplicativo referência guia.Você pode preencher previamente todos os valores nesta guia clicando o Selecione manifesto botão e selecionando o manifesto do aplicativo que você criou nas etapas anteriores.
Escolha Salvar e salvar o manifesto de implantação em disco.Você será solicitado para assinar o manifesto de aplicativo quando você salvá-lo.Clique em Cancelar para salvar o manifesto sem assiná-lo.
Forneça todos os arquivos do aplicativo para o cliente.
Neste ponto, o cliente deve assinar o manifesto de implantação com o seu próprio certificado gerado automaticamente.Por exemplo, se o cliente trabalha para uma empresa chamada Adventure Works, ele pode gerar um certificado auto-assinado usando a ferramenta Makecert.Em seguida, use a ferramenta Pvk2pfx.exe para combinar os arquivos criados pelo Makecert 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
```
Com o certificado gerado, o cliente agora assina o manifesto de implantação abrindo o manifesto de implantação em MageUI.exe e, em seguida, salvá-lo.Quando for exibida a caixa de diálogo de assinatura, o cliente seleciona sinal que o arquivo de certificado opção e escolhe o arquivo PFX, ele foi salvo no disco.
O cliente implanta o aplicativo para seus usuários.

Observação
A versão da sua implantação pode ser distinta da versão de seus arquivos de aplicativo.

Consulte também

Referência

Mage (geração de manifesto e ferramenta de edição)

MageUI.exe (geração de manifesto e edição da ferramenta, o cliente gráfico)

Makecert (ferramenta de criação de certificado)

Compartilhar via