Compartilhar via

Solucionar erros específicos em implantações do ClickOnce

  • Artigo

Aplica-se a: Visual Studio

Este artigo apresenta erros comuns que podem ocorrer quando você implanta o aplicativo ClickOnce e fornece etapas para resolver cada problema.

Erros gerais

Quando você tenta localizar um arquivo de aplicativo, nada ocorre, o XML é renderizado no Internet Explorer ou você recebe a caixa de diálogo Executar ou Salvar como

O possível motivo desse erro é que os tipos de conteúdo (também conhecidos como tipos MIME) não estão sendo registrados corretamente no servidor ou cliente.

Primeiro, verifique se o servidor está configurado para associar a extensão .application ao tipo de conteúdo "application/x-ms-application".

Se o servidor estiver configurado corretamente, verifique se o .NET Framework 2.0 está instalado no computador. Se o .NET Framework 2.0 estiver instalado e você ainda estiver vendo esse problema, tente desinstalar e reinstalar o .NET Framework 2.0 para registrar novamente o tipo de conteúdo no cliente.

Erro: "Não é possível recuperar o aplicativo. Arquivos ausentes na implantação" ou "O download do aplicativo foi interrompido, verifique se há erros de rede e tente novamente mais tarde"

Essa mensagem indica que um ou mais arquivos aos quais os manifestos do ClickOnce fazem referência não podem ser baixados. A maneira mais fácil de depurar esse erro é tentar baixar o URL que o ClickOnce diz que não pode baixar. Estas são algumas causas possíveis:

  • Se o arquivo de log disser "(403) Proibido" ou "(404) Não encontrado", verifique se o servidor Web está configurado para não bloquear o download desse arquivo. Para obter mais informações, consulte Problemas de configuração de servidor e cliente em implantações do ClickOnce.
  • Se o arquivo .config estiver sendo bloqueado pelo servidor, consulte Erro de download ao tentar instalar um aplicativo ClickOnce que tenha um arquivo .config.
  • Determine se esse erro ocorreu porque a URL deploymentProvider no manifesto de implantação está apontando para um local diferente da URL usada para ativação.
  • Certifique-se de que todos os arquivos estejam presentes no servidor; o log do ClickOnce deve informar qual arquivo não foi encontrado.
  • Veja se há problemas de conectividade de rede. Você poderá receber essa mensagem, se o computador cliente ficar offline durante o download.

Erro de download ao tentar instalar um aplicativo ClickOnce que tem um arquivo .config

Por padrão, um aplicativo baseado no Windows do Visual Basic inclui um arquivo App.config . Você pode encontrar um problema se tentar instalar a partir de um servidor Web que usa o Windows Server 2003, pois esse sistema operacional bloqueia a instalação de arquivos .config por motivos de segurança. Para habilitar o arquivo .config a ser instalado, selecione Usar extensão de arquivo ".deploy" na caixa de diálogo Opções de Publicação.

Você também deve definir os tipos de conteúdo (também conhecidos como tipos MIME) adequadamente para arquivos .application, .manifest e .deploy . Para obter mais informações, confira a documentação do servidor Web.

Para obter mais informações, consulte Windows Server: tipos de conteúdo bloqueados.

Erro: O aplicativo está formatado incorretamente; O arquivo de log contém "A assinatura XML é inválida"

Verifique se você atualizou e assinou novamente o arquivo de manifesto. Republique seu aplicativo usando o Visual Studio ou use o Mage para assinar o aplicativo novamente.

Você atualizou seu aplicativo no servidor, mas o cliente não baixa a atualização

Esse problema pode ser resolvido concluindo uma das seguintes tarefas:

  • Examine a URL deploymentProvider no manifesto de implantação. Verifique se você está atualizando os bits no mesmo local para o qual deploymentProvider aponta.
  • Verifique o intervalo de atualização no manifesto de implantação. Se esse intervalo for definido como um intervalo periódico, como uma vez a cada seis horas, o ClickOnce não verificará se há uma atualização até que esse intervalo tenha passado. Você pode alterar o manifesto para verificar se há uma atualização, sempre que o aplicativo for iniciado. Alterar o intervalo de atualização é uma opção prática durante o tempo de desenvolvimento, para verificar se as atualizações estão sendo instaladas, mas reduz a ativação do aplicativo.
  • Tente iniciar o aplicativo novamente no menu Iniciar. O ClickOnce pode ter detectado a atualização em segundo plano, mas solicitará que você instale os bits na próxima ativação.

Durante a atualização, você recebe um erro com a seguinte entrada de log: "A referência na implantação não corresponde à identidade definida no manifesto do aplicativo"

Esse erro pode ocorrer porque você editou manualmente os manifestos de implantação e aplicativo e fez com que a descrição da identidade de um assembly em um manifesto ficasse fora de sincronia com o outro. A identidade de um assembly consiste em nome, versão, cultura e token de chave pública. Examine as descrições de identidade nos seus manifestos e corrija as diferenças.

A primeira ativação do disco local ou CD-ROM é bem-sucedida, mas a ativação subsequente do menu Iniciar não é bem-sucedida

O ClickOnce usa a URL do Provedor de Implantação para receber atualizações do aplicativo. Verifique se o local para o qual a URL está apontando está correto.

Erro: Não é possível iniciar o aplicativo

Essa mensagem de erro geralmente indica que há um problema ao instalar esse aplicativo no repositório ClickOnce. O aplicativo tem um erro ou o repositório foi corrompido. O arquivo de log pode informar onde ocorreu o erro.

Para resolver esse problema, siga estas etapas:

  1. Certifique-se de que a identidade do manifesto de implantação, a identidade do manifesto do aplicativo e a identidade do EXE do aplicativo principal sejam exclusivas.
  2. Verifique se os caminhos de arquivo não têm mais de 100 caracteres. Se o aplicativo contiver caminhos de arquivo muito longos, você pode exceder as limitações no caminho máximo que pode armazenar. Tente encurtar os caminhos e reinstale.

As configurações de PrivatePath no arquivo de configuração do aplicativo não são respeitadas

Para usar o PrivatePath (caminhos de investigação do Fusion), o aplicativo deve solicitar permissão de confiança total. Tente alterar o manifesto do aplicativo para solicitar confiança total e tente novamente.

Durante a desinstalação, uma mensagem é exibida dizendo: "Falha ao desinstalar o aplicativo"

Essa mensagem geralmente indica que o aplicativo já foi removido ou que o repositório foi corrompido. Depois de selecionar OK, a entrada Adicionar /Remover Programa será removida.

Durante a instalação, é exibida uma mensagem informando que as dependências da plataforma não estão instaladas

Você está perdendo um pré-requisito no GAC (cache de assembly global) que o aplicativo precisa para ser executado.

Como publicar com o Visual Studio

Falha na publicação com o Visual Studio

Verifique se você tem o direito de publicar no servidor que está direcionando. Por exemplo, se você estiver conectado a um computador servidor de terminal como um usuário comum, não como administrador, provavelmente não terá os direitos necessários para publicar no servidor Web local.

Se você estiver publicando com uma URL, verifique se o computador de destino tem as Extensões de Servidor do FrontPage habilitadas.

Erro: Não é possível criar o site '<site>'. Os componentes para comunicação com as Extensões de Servidor do FrontPage não estão instalados

Verifique se você tem o Componente de Criação na Web do Microsoft Visual Studio instalado no computador do qual você está publicando. Para usuários do Express, esse componente não é instalado por padrão.

Erro: Não foi possível encontrar o arquivo 'Microsoft.Windows.Common-Controls, Version=6.0.0.0, Culture=*, PublicKeyToken=6595b64144ccf1df, ProcessorArchitecture=*, Type=win32'

Essa mensagem de erro é exibida quando você tenta publicar um aplicativo WPF com os estilos visuais habilitados. Para resolver esse problema, confira Como publicar um aplicativo WPF com os estilos visuais habilitados.

Como usar o Mage

Você tentou assinar com um certificado no seu repositório de certificados e recebeu uma caixa de mensagem em branco

Na caixa de diálogo Assinatura, você deve fazer o seguinte:

  1. Selecione Assinar com um certificado armazenado.
  2. Selecione um certificado na lista; O primeiro certificado não é a seleção padrão.

Clicar no botão "Não Assinar" causa uma exceção

Esse problema é um bug conhecido. Todos os manifestos do ClickOnce precisam ser assinados. Basta selecionar uma das opções de assinatura e, em seguida, selecionar OK.

Mais erros

A tabela a seguir mostra algumas mensagens de erro comuns que um usuário cliente-computador pode receber quando o usuário instala um aplicativo ClickOnce. Cada mensagem de erro é listada ao lado de uma descrição da causa mais provável para o erro.

Mensagem de erro Descrição
O aplicativo não pode ser iniciado. Entre em contato com o editor do aplicativo.

Não é possível iniciar o aplicativo. Entre em contato com o fornecedor do aplicativo para obter assistência.		 Essas são mensagens de erro genéricas que ocorrem quando o aplicativo não pode ser iniciado e nenhum outro motivo específico pode ser encontrado. Muitas vezes, isso significa que o aplicativo foi corrompido de alguma forma ou que o repositório ClickOnce foi corrompido.
Não é possível continuar. O aplicativo foi formatado incorretamente. Entre em contato com o editor do aplicativo para obter assistência.

A validação do aplicativo não funcionou. Não é possível continuar.

Não foi possível recuperar os arquivos do aplicativo. Arquivos corrompidos na implantação.		 Um dos arquivos de manifesto na implantação é inválido sintaticamente ou contém um hash que não pode ser reconciliado com o arquivo correspondente. Esse erro também pode indicar que o manifesto inserido dentro de um assembly foi corrompido. Recrie sua implantação e recompile seu aplicativo ou localize e corrija os erros manualmente nos seus manifestos.
Não é possível recuperar o aplicativo. Erro de autenticação.

A instalação do aplicativo não funcionou. Não é possível localizar os arquivos de aplicativos no servidor. Entre em contato com o editor do aplicativo ou o administrador para obter assistência.		 Um ou mais arquivos na implantação não podem ser baixados porque você não tem permissão para acessá-los. Isso pode ser causado porque um erro 403 Proibido foi retornado por um servidor Web, o que pode ocorrer se um dos arquivos na sua implantação terminar com uma extensão que faz com que o servidor Web o trate como arquivo protegido. Além disso, um diretório que contém um ou mais arquivos de aplicativo pode exigir um nome de usuário e uma senha para acessar.
Não é possível baixar o aplicativo. O aplicativo não tem os arquivos necessários. Entre em contato com o fornecedor do aplicativo ou o administrador do sistema para obter assistência. Um ou mais dos arquivos listados no manifesto do aplicativo não podem ser encontrados no servidor. Verifique se você carregou todos os arquivos dependentes da implantação e tente novamente.
O download do aplicativo não funcionou. Verifique sua conexão de rede ou entre em contato com o administrador do sistema ou o provedor de serviços de rede. O ClickOnce não pode estabelecer uma conexão de rede com o servidor. Examine a disponibilidade do servidor e o estado da rede.
O URLDownloadToCacheFile falhou com HRESULT '<number>'. Ocorreu um erro ao tentar baixar o '<arquivo>'. Se um usuário tiver definido a opção Segurança Avançada do Internet Explorer "Avisar se estiver alternando entre o modo seguro e não seguro" no computador de destino da implantação e se a URL de instalação do aplicativo ClickOnce que está sendo instalado for redirecionada de um site não seguro para um site seguro (ou vice-versa), a instalação falhará porque o aviso do Internet Explorer a interrompe.

Para resolver esse erro, você pode fazer uma das seguintes tarefas:

- Desmarque a opção de segurança.
- Verifique se o URL de configuração não é redirecionado de forma a alterar os modos de segurança.
- Remova completamente o redirecionamento e aponte para a URL de configuração real.
Ocorreu um erro ao gravar no disco rígido. Pode não haver espaço suficiente disponível no disco. Entre em contato com o fornecedor do aplicativo ou o administrador do sistema para obter assistência. Isso pode indicar espaço em disco insuficiente para armazenar o aplicativo, mas também pode indicar um erro de E/S mais geral quando você está tentando salvar os arquivos do aplicativo na unidade.
Não é possível iniciar o aplicativo. Não há espaço disponível suficiente no disco. O disco rígido está cheio. Limpe o espaço e tente executar o aplicativo novamente.
Muitas ativações implantadas estão tentando carregar de uma só vez. O ClickOnce limita o número de aplicativos diferentes que podem ser iniciados ao mesmo tempo. Isso ocorre principalmente para ajudar a proteger contra tentativas mal-intencionadas de instigar ataques de negação de serviço contra o serviço local do ClickOnce. Os usuários que tentarem iniciar o mesmo aplicativo repetidamente, em rápida sucessão, acabarão apenas com uma única instância do aplicativo.
Os atalhos não podem ser ativados pela rede. Os atalhos para um aplicativo ClickOnce só podem ser iniciados no disco rígido local. Eles não podem ser iniciados abrindo uma URL que aponta para um arquivo de atalho em um servidor remoto.
O aplicativo é muito grande para ser executado online em confiança parcial. Entre em contato com o fornecedor do aplicativo ou o administrador do sistema para obter assistência. Um aplicativo executado em confiança parcial não pode ser maior que a metade do tamanho da cota de aplicativos online, que, por padrão, é de 250 MB.

Referências