Walkthrough: Manualmente, implantando um aplicativo de ClickOnce , que não exigem Re-de assinatura e que preserva as informações de identificação de marca

Artigo
08/04/2011

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 marca do cliente ou pode preservar a sua marca. Por exemplo, se o aplicativo for um aplicativo proprietário único, convém preservar sua marca. Se o aplicativo é altamente personalizado para cada cliente, convém usar a marca do cliente. A.NET Framework 3.5 permite preservar sua marca, informações sobre a editora e assinatura de segurança ao fornecer um aplicativo como uma organização para implantar. 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ê criar 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 Walkthrough: Manualmente, implantando um aplicativo de ClickOnce.

Pré-requisitos

Para executar as etapas nesta explicação, 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 do Visual Studio ou um Windows SDK prompt de comando e altere 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 de 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. Desde que este aplicativo será aproveitar o recurso de implantação de vários, excluir o -providerUrl argumento para Mage. (Em versões do.NET Framework anterior à versão 3.5, excluindo -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 
```
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 funciona para uma empresa chamada Adventure Works, ele pode gerar um certificado auto-assinado usando a ferramenta Makecert. exe. Em seguida, use a ferramenta Pvk2pfx.exe para combinar os arquivos criados pelo Makecert. exe 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 do 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 guia, digite 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 aplicativo guia e clique em O manifesto de aplicativo de uso para obter informações de confiança. 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 o popular o 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 O ponto de entrada do O tipo de arquivo na lista suspensa. (Se o 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 a 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 o sinal como 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 o manifesto de implantação e na nome guia, forneça um nome e número de versão (1.0.0.0 neste exemplo).
Alterne para o atualização guia e especificar a freqüência deseja que este aplicativo para atualizar. Se seu aplicativo usa a ClickOnce API de implantação para verificar as atualizações, 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 no Selecione manifesto botão e selecionando o manifesto do aplicativo que você criou nas etapas anteriores.
Escolha Salvar e salve o manifesto de implantação para o disco. Você será solicitado a 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 funciona para uma empresa chamada Adventure Works, ele pode gerar um certificado auto-assinado usando a ferramenta Makecert. exe. Em seguida, use a ferramenta Pvk2pfx.exe para combinar os arquivos criados pelo 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
```
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 como 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)

O Makecert. exe (ferramenta de criação de certificado)

Compartilhar via