Walkthrough: Manualmente, implantando um aplicativo de ClickOnce

Artigo
08/04/2011

Se você não pode usar Visual Studio para implantar seu ClickOnce aplicativo, ou você precisa usar os recursos de implantação avançada como, por exemplo, a implantação de aplicativos confiáveis, você deve usar a ferramenta de linha de comando Mage para criar seu ClickOnce manifestos. Esta explicação passo a passo descreve como criar um ClickOnce implantação usando a versão de linha de comando (Mage) ou a versão gráfica (MageUI.exe) da geração de manifesto e ferramenta de edição.

Pré-requisitos

Esta explicação passo a passo tem alguns pré-requisitos e as opções que você precisa escolher antes de criar uma implantação.

Instale Mage e MageUI.exe.

Mage e MageUI.exe fazem parte do Windows Software Development Kit (SDK). É necessário que ambos têm o Windows SDK instalado ou a versão do Windows SDK incluído com o Visual Studio. Para obter mais informações, consulte O SDK do Windows no MSDN.
Fornece um aplicativo ser implantado.

Esta explicação passo a passo presume que você tenha um aplicativo do Windows que você está pronto para implantar. Este aplicativo será ser conhecido como AppToDeploy.
Determine como a implantação será distribuída.

As opções de distribuição incluem: Web, compartilhamento de arquivos ou CD. Para obter mais informações, consulte ClickOnce Segurança e implantação.
Determine se o aplicativo requer um nível elevado de confiança.

Se seu aplicativo requer confiança total — por exemplo, acesso total ao sistema do usuário — você pode usar o -TrustLevel opção de Mage para defini-la. Se você deseja definir uma permissão personalizada definida para seu aplicativo, pode copiar a seção de permissão de Internet ou intranet do manifesto de outro, modificá-lo para atender às suas necessidades e adicioná-lo ao manifesto do aplicativo usando um editor de texto ou o MageUI.exe. Para obter mais informações, consulte Visão geral sobre implantação de aplicativos confiáveis.
Obter um certificado Authenticode.

Você deve autenticar sua implantação com um certificado Authenticode. Você pode gerar um certificado de teste usando as ferramentas de Visual Studio, MageUI.exe, ou o Makecert. exe e Pvk2Pfx.exe, ou você pode obter um certificado 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 instalação única do certificado em todos os computadores de clientes. Para obter mais informações, consulte Visão geral sobre implantação de aplicativos confiáveis.
Certifique-se de que o aplicativo não tem um manifesto com informações do UAC.

Você precisará determinar se seu aplicativo contém um manifesto com informações de controle de conta de usuário (UAC), como um <dependentAssembly> elemento. Para examinar um manifesto de aplicativo, você pode usar o Windows Sysinternals o Sigcheck utilitário.

Se seu aplicativo contém um manifesto com detalhes do UAC, você deve ser reconstruirá sem as informações do UAC. Para um projeto C# em Visual Studio, abra as propriedades do projeto e selecione a guia do aplicativo. No manifesto lista suspensa, selecione criar um aplicativo sem um manifesto. Para um projeto de Visual Basic em Visual Studio, abra as propriedades do projeto, selecione a guia de aplicativo e clique em Exibir configurações UAC. No arquivo de manifesto aberto, remova todos os elementos dentro do único <asmv1:assembly> elemento.
Determine se o aplicativo necessita de pré-requisitos no computador cliente.

ClickOnceaplicativos implantados a partir de Visual Studio podem incluir um bootstrapper de pré-requisito de instalação (Setup. exe) com sua implantação. Esta explicação passo a passo cria os manifestos de dois exigidos para um ClickOnce implantação. Você pode criar um bootstrapper pré-requisito usando o Tarefa de GenerateBootstrapper.

Implantar um aplicativo com a ferramenta de linha de comando Mage

Criar um diretório onde você armazenará seus ClickOnce arquivos de implantação.
No diretório de implantação que você acabou de criar, crie um subdiretório de versão. Se esta for a primeira vez que você estiver implantando o aplicativo, nomeie o subdiretório de versão 1.0.0.0.

Observação

A versão da sua implantação pode ser diferente da versão do seu aplicativo.
Copie todos os seus arquivos de aplicativo para o subdiretório de versão, incluindo arquivos executáveis, assemblies, recursos e arquivos de dados. Se necessário, você pode criar subpastas adicionais que contêm arquivos adicionais.
Abrir o Windows SDK ou Visual Studio do prompt de comando e a alteração para o subdiretório de versão.

Observação
A versão da sua implantação pode ser diferente da versão do seu aplicativo.

Crie o manifesto do aplicativo com uma chamada para Mage. A instrução a seguir cria um manifesto de aplicativo para o código compilado para ser executado no processador Intel x86.

mage -New Application -Processor x86 -ToFile AppToDeploy.exe.manifest -name "My App" -Version 1.0.0.0 -FromDirectory .

Observação
Certifique-se de incluir o ponto (.) após a -FromDirectory opção, que indica o diretório atual. Se você não incluir o ponto, você deve especificar o caminho para os arquivos de aplicativo.

Assinar o manifesto de aplicativo com o seu certificado Authenticode. Substitua mycert.pfx com o caminho para o arquivo de certificado. Substitua passwd com a senha para o arquivo de certificado.
```
mage -Sign AppToDeploy.exe.manifest -CertFile mycert.pfx -Password passwd
```
Alterar para a raiz do diretório de implantação.
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 -Install opção com um valor de false. Se você usar o padrão e os usuários instalarão o seu aplicativo a partir de um site ou compartilhamento de arquivo, certifique-se de que o valor de -ProviderUrl pontos de opção para o local do manifesto do aplicativo no servidor Web ou compartilhamento.
```
mage -New Deployment -Processor x86 -Install true -Publisher "My Co." -ProviderUrl "\\myServer\myShare\AppToDeploy.application" -AppManifest 1.0.0.0\AppToDeploy.exe.manifest -ToFile AppToDeploy.application
```

Assinar o manifesto de implantação com o seu certificado Authenticode.

mage -Sign AppToDeploy.application -CertFile mycert.pfx -Password passwd

Copie todos os arquivos no diretório de implantação para a mídia ou o destino de implantação. Isso pode ser uma pasta em um site da Web ou site FTP, um compartilhamento de arquivo ou um CD-ROM.
Fornece aos usuários com a URL, UNC ou mídia física necessária para instalar o aplicativo. Se você fornecer uma URL ou um UNC, você deve dar aos usuários o caminho completo para o manifesto de implantação. Por exemplo, se AppToDeploy for implantado para http://webserver01/ no diretório AppToDeploy, o caminho completo do URL seria http://webserver01/AppToDeploy/AppToDeploy.application.

Para implantar um aplicativo com a ferramenta gráfica de MageUI.exe

Criar um diretório onde você armazenará seus ClickOnce arquivos de implantação.
No diretório de implantação que você acabou de criar, crie um subdiretório de versão. Se esta for a primeira vez que você estiver implantando o aplicativo, nomeie o subdiretório de versão 1.0.0.0.

Observação

A versão da implantação é provavelmente distinta da versão do seu aplicativo.
Copie todos os seus arquivos de aplicativo para o subdiretório de versão, incluindo arquivos executáveis, assemblies, recursos e arquivos de dados. Se necessário, você pode criar subpastas adicionais que contêm arquivos adicionais.
Inicie a ferramenta gráfica de 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. Especifique também o processador que o aplicativo é criado, como, por exemplo, x86.
Selecione o arquivos guia e clique nas reticências (...) botão ao lado do diretório de aplicativo caixa de texto. Aparece uma caixa de diálogo Procurar pasta.
Selecione o subdiretório de versão que contém os arquivos do aplicativo e clique em OK.
Se você implantará a partir do Internet Information Services (IIS), selecione o quando estiver preenchendo adiciona a extensão. Deploy a qualquer arquivo que não o tenha caixa de seleção.
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 é FullTrust, que será adequado para a maioria dos aplicativos.
Selecione arquivo, Salvar como no menu. Uma caixa de diálogo Opções de assinatura será exibida solicitando que você assinar o manifesto de aplicativo.
Se você tiver um certificado armazenado como um arquivo no seu sistema de arquivos, use o sinal com o arquivo de certificado opção e selecione o certificado do sistema de arquivos usando as reticências (...) botão. Digite sua senha do certificado.

- ou -

Se o seu certificado é mantido em um armazenamento de certificados acessível a partir de seu computador, selecione o assinar com certificado armazenado opção e selecione o certificado na lista fornecida.
Clique em OK para assinar seu manifesto de aplicativo. Aparece a caixa de diálogo Salvar como.
Na caixa de diálogo Salvar como, especifique o diretório de versão e, em seguida, clique em Salvar.
Selecione arquivo, nova, O manifesto de implantação no menu para criar o manifesto de implantação.
Sobre o nome especifique um nome e número de versão para essa implantação (1.0.0.0 neste exemplo). Especifique também o processador que o aplicativo é criado, como, por exemplo, x86.
Selecione o Descrição guia e, em seguida, especifique valores para Publisher e reconhecesset. (Produto é o nome dado ao seu aplicativo no menu Iniciar do Windows quando seu aplicativo for instalado em um computador cliente para uso offline.)
Selecione o Opções de implantação guia e de Local iniciar texto, especifique o local do manifesto do aplicativo no servidor Web ou compartilhamento. Por exemplo, \\myServer\myShare\AppToDeploy.application.
Se você adicionou a extensão. Deploy em uma etapa anterior, selecione também extensão de nome de arquivo. Deploy uso aqui.
Selecione o Opções de atualização de guia e, em seguida, especifique a freqüência na qual você deseja que este aplicativo para atualizar. Se seu aplicativo usa UpdateCheckInfo para verificar atualizações próprio, desmarque o esse aplicativo deve verificar as atualizações caixa de seleção.
Selecione o Aplicativo referência guia e clique o Selecione manifesto botão. Aparece uma caixa de diálogo Abrir.
Selecione o manifesto do aplicativo que você criou anteriormente e clique em Abrir.
Selecione arquivo, Salvar como no menu. Uma caixa de diálogo Opções de assinatura será exibida solicitando que você assinar o manifesto de implantação.
Se você tiver um certificado armazenado como um arquivo no seu sistema de arquivos, use o sinal com o arquivo de certificado opção e selecione o certificado do sistema de arquivos usando as reticências (...) botão. Digite sua senha do certificado.

- ou -

Se o seu certificado é mantido em um armazenamento de certificados acessível a partir de seu computador, selecione o assinar com certificado armazenado opção e selecione o certificado na lista fornecida.
Clique em OK para assinar seu manifesto de implantação. Aparece a caixa de diálogo Salvar como.
No Salvar como caixa de diálogo, mover um diretório para a raiz da sua implantação e clique Salvar.
Copie todos os arquivos no diretório de implantação para a mídia ou o destino de implantação. Isso pode ser uma pasta em um site da Web ou site FTP, um compartilhamento de arquivo ou um CD-ROM.
Fornece aos usuários com a URL, UNC ou mídia física necessária para instalar o aplicativo. Se você fornecer uma URL ou um UNC, você deve dar aos usuários o caminho completo, o manifesto de implantação. Por exemplo, se AppToDeploy for implantado para http://webserver01/ no diretório AppToDeploy, o caminho completo do URL seria http://webserver01/AppToDeploy/AppToDeploy.application.

Observação
A versão da implantação é provavelmente distinta da versão do seu aplicativo.

Próximas etapas

Quando você precisa implantar uma nova versão do aplicativo, criar um novo diretório chamado após a nova versão — por exemplo, 1.0.0.1—and copiar os novos arquivos de aplicativo para o novo diretório. Em seguida, você precisa seguir as etapas anteriores para criar e assinar um novo manifesto de aplicativo e atualizar e assinar o manifesto de implantação. Tenha cuidado para especificar a mesma versão superior em ambas as Mage -New e –Update chamadas, como ClickOnce atualiza apenas as versões superiores, com o inteiro mais à esquerda mais significativo. Se você usou o MageUI.exe, você poderá atualizar o manifesto de implantação ao abri-lo, selecionando o Aplicativo referência guia, clicando no Selecione manifesto botão e, em seguida, selecionando o manifesto de aplicativo atualizado.