Demonstra Passo a passo: Implantando um aplicativo ClickOnce manualmente

Artigo
08/25/2010

Esta explicação passo a passo descreve as etapas necessárias para criar um total ClickOnce implantação usando a versão de linha de comando ou gráfica da ferramenta de geração de manifesto e edição (Mage).

Se você não usar Visual Studio regularmente, precisa automatizar o processo de implantação, ou precisar usar recursos de implantação avançada sistema autônomo confiáveis aplicativo Deployment, você deve usar a ferramenta de linha de comando Mage.exe para criar o seu ClickOnce manifestos. A seguinte explicação passo a passo leva você por todas as etapas necessárias para gerar um completo ClickOnce implantação usando a versão de linha de comando (Mage.exe) ou a versão dos Windows Forms (MageUI.exe) a ferramenta de edição e geração de manifesto do.

Pré-requisitos

Esta explicação passo a passo foram gravada sob a suposição de que um aplicativo Windows Forms que você está pronto para implantar; esse aplicativo será referido sistema autônomo WindowsFormsApp1.Você também deve instalar o Windows Software Development Kit (SDK).

Há uma série de problemas, que você precisa decidir antes de criar uma implantação.Em primeiro lugar é como você distribuirá a implantação: Pela Web, em um compartilhamento de arquivo, ou instalado de um CD.Para obter mais informações, consulte Visão geral sobre a implantação do ClickOnce.

Em seguida, você precisará determinar se seu aplicativo será executado em um nível elevado de confiança.Conforme discutido em Confiável aplicativo implantação visão geral, por padrão ClickOnce aplicativos serão executados em uma região parcialmente confiável, com suas permissões exatos determinadas pela que são hospedados em uma intranet ou da Internet. Se um aplicativo precisar acessar dados no computador cliente, se comunicar com dispositivos locais, chamar funções da API do Windows ou executar outras operações potencialmente perigosas, ele precisa declarar um nível mais alto de confiança.Se seu aplicativo requer confiança total — por exemplo, acesso completo ao sistema do usuário — você pode usar o Mage.exe para defini-la com com facilidade.Se você deseja conjunto uma permissão personalizada definida para seu aplicativo, pode copiar a seção de permissão de Internet ou intranet de outro manifesto, modificá-lo para atender às suas necessidades e adicioná-lo ao manifesto do aplicativo usando um editor de texto ou MageUI.exe.

Os dois métodos para declarar mais alto de confiança em um ClickOnce manifesto são confiáveis aplicativo implantação e a elevação de permissões. Em ambos os casos, a implantação deve ser assinada com um certificado Authenticode gerada usando a ferramenta MakeCert.exe ou obtido de uma autoridade de certificação (CA).Se você optar por usar a implantação de aplicativos confiáveis, você também deve executar uma-time instalação de certificado para todos os computadores cliente.Para obter mais informações, consulte Confiável aplicativo implantação visão geral.

Implantar um aplicativo com a ferramenta de linha de comando Mage.exe

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

Observação:

A versão da implantação do pode ser diferente da versão dos arquivos de aplicativo.
Crie uma subdiretório dessa pasta chamada bandeja e coloque todos os arquivos de aplicativo aqui, incluindo arquivos executável, assemblies, recursos e arquivos de dados

Observação:
A versão da implantação do pode ser diferente da versão dos arquivos de aplicativo.

gerar manifesto do aplicativo com uma telefonar 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

Assinar o manifesto do aplicativo com o certificado digital:

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

gerar o manifesto de implantação com uma telefonar para Mage.exe.Mage.exe irá, por padrão, marcar sua implantação de ClickOnce sistema autônomo um aplicativo instalado, para que ele possa ser executado tanto online e off-line.Para disponibilizar o aplicativo apenas quando o usuário está online, use o -i Sinalizar com um valor de f.Se você usar o padrão e os usuários instalarão o aplicativo de um site ou compartilhamento de arquivos, certifique-se o valor de - providerUrl sinalizar pontos para o local do manifesto do aplicativo no servidor Web ou compartilhamento.
```
mage -New Deployment -ToFile WindowsFormsApp1.application -Name "Windows Forms App 1" -Version 1.0.0.0 -AppManifest 1.0.0.0\WindowsFormsApp1.manifest -providerUrl http://www.adatum.com/WindowsFormsApp1/WindowsFormsApp1.application
```

Assinar o manifesto de implantação com o seu certificado:

mage -Sign WindowsFormsApp1.application -CertFile mycert.pfx

Copiar todos os arquivos no diretório corrente — incluindo a pasta de versão e a pasta \bin — para o destino de implantação.Isso pode ser qualquer uma pasta em um site ou site FTP, um compartilhamento de arquivo ou um CD.
Forneça os usuários com a URL, UNC ou mídia física necessárias para instalar o seu aplicativo.Se você estiver fornecendo um URL ou UNC, você deve dar aos usuários o caminho completo o manifesto de implantação.Por exemplo, se WindowsFormsApp1 http://webserver01/ no diretório WindowsFormsApp1 é implantado, o caminho de URL completo deverá ser http://webserver01/WindowsFormsApp1/WindowsFormsApp1.implantar.

Implantar o aplicativo com a ferramenta gráfica MageUI.exe

Abra um Windows SDK aviso de comando e navegar até o diretório no qual você armazenará seus ClickOnce arquivos.
Crie uma subdiretório chamada bandeja e coloque todos os arquivos de aplicativo aqui, incluindo arquivos executável, assemblies, recursos e arquivos de dados.
Crie um subdiretório nomeado de acordo com a versão corrente da sua implantação.Se esta for a primeira vez que você estiver implantando o aplicativo, você deverá escolher provavelmente 1.0.0.0.

Observação:

A versão da implantação do pode ser diferente da versão dos arquivos de aplicativo.
Mover no diretório \bin para o diretório que você criou na etapa 2 e inicie a ferramenta gráfica:
```
MageUI.exe
```
Criar um novo manifesto do aplicativo selecionando Arquivo, Novo, manifesto do aplicativo no menu.
Sobre o padrão de Nome guia, digite o nome e o número da versão essa implantação.
selecionar o Arquivos guia e clicar no Procure... botão Próxima para a caixa de texto diretório do aplicativo.
selecionar o diretório que contém os arquivos de aplicativo que você criou na etapa 2 e clicar OK na caixa de diálogo de seleção de pasta.
clicar no popular botão para adicionar todos os arquivos de aplicativo à lista de arquivos.Se seu aplicativo contém mais de um arquivo executável, marcar o arquivo executável principal para essa implantação sistema autônomo o aplicativo de inicialização, de Ponto de entrada from the Tipo de arquivo na lista suspensa.(Se o seu aplicativo contém apenas um arquivo executável, MageUI.exe irá marcá-lo para você.)
selecionar o Permissões necessárias guia e selecionar o nível de confiança que você precisa declarar seu aplicativo.O padrão é Confiança total, que será adequado para a maioria dos aplicativos.
selecionar Arquivo, Salvar de menu e salva o manifesto do aplicativo.Você será solicitado a assinar o manifesto do aplicativo quando você salvá-lo.
Se você tiver um certificado armazenado sistema autônomo um arquivo em seu sistema de arquivos, use o Conectar-se sistema autônomo arquivo de certificado opção e selecionar o certificado do sistema de arquivos usando o ... botão.

- ou -

Se o certificado é mantido em um armazenamento de certificados acessível a partir de seu computador, selecionar o Assinar com certificado armazenado opção e selecionar o certificado da lista fornecida.
selecionar Arquivo, Novo, Manifesto de implantação de menu para criar o manifesto de implantação e, em seguida, sobre o Nome guia, forneça um nome e o número da versão (1.0.0.0 neste exemplo).
selecionar o publicador guia e valores de fonte para publicador and Produto.(Produto é o nome dado seu aplicativo em que o Windows Iniciar menu quando você instala o aplicativo localmente.)
Alterne para o Atualização guia e especifique a freqüência na qual você deseja que este aplicativo para atualizar.Se o seu aplicativo utiliza o ClickOnce Implantação API para verificar se há atualizações, desmarcar a caixa de seleção rotulada Este aplicativo deve verificar se há atualizações.
Alterne para o Referência do aplicativo guia.Você pode popular previamente todos os valores nesta guia clicando o selecionar manifest botão e selecionando o manifesto do aplicativo que você criou nas etapas anteriores.
escolher Salvar e salve o manifesto de implantação em disco.Você será solicitado a assinar o manifesto do aplicativo quando você salvá-lo.
Se você tiver um certificado armazenado sistema autônomo um arquivo em seu sistema de arquivos, use o Conectar-se sistema autônomo arquivo de certificado opção e selecionar o certificado do sistema de arquivos usando o ... botão.

- ou -

Se o certificado é mantido em um armazenamento de certificados acessível a partir de seu computador, selecionar o Assinar com certificado armazenado opção e selecionar o certificado da lista fornecida.
Copiar todos os arquivos no diretório corrente — incluindo a pasta de versão e a pasta \bin — para o destino de implantação.Isso pode ser qualquer uma pasta em um site ou site FTP, um compartilhamento de arquivo ou um CD.
Forneça os usuários com a URL, UNC ou mídia física necessárias para instalar o seu aplicativo.Se você estiver fornecendo um URL ou UNC, você deve dar aos usuários o caminho completo o manifesto de implantação.Por exemplo, se WindowsFormsApp1 http://webserver01/ no diretório WindowsFormsApp1 é implantado, o caminho de URL completo deverá ser http://webserver01/WindowsFormsApp1/WindowsFormsApp1.implantar.

Observação:
A versão da implantação do pode ser diferente da versão dos arquivos de aplicativo.

Próximas etapas

Quando você precisar implantar uma nova versão do aplicativo, você precisará criar um novo diretório chamado após a nova versão — por exemplo, 1.1.0.0—and mover os novos arquivos de aplicativo para uma pasta \bin no novo diretório.Você deve gerar um novo manifesto do aplicativo e armazená-lo em um novo diretório e ter o publicador assinar o manifesto de novo.Depois de obter o manifesto assinado novamente, você pode usar o Mage.exe para atualizar o manifesto de implantação e aponte-o novo manifesto do aplicativo:

mage -Update WindowsFormsApp1.application -Version 1.1.0.0 -AppManifest 1.1.0.0\WindowsFormsApp1.exe.manifest

Usuários MageUI.exe podem efetuar a mesma operação, abrindo o seu manifesto de implantação, selecionando o Referência do aplicativo guia e selecionando o selecionar manifest botão novamente.

Depois de atualizar o aplicativo de manifesto de referência, será necessário assinar novamente o manifesto de implantação, pois alterar um manifesto de qualquer maneira invalida a assinatura digital.