Partilhar via

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

  • Artigo

              Aplica-se a: Visual Studio 2022

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

Erros gerais

Quando você tenta localizar um arquivo de aplicativo, nada ocorre ou renderizações XML na Internet Explorer ou você recebe uma caixa de diálogo Executar ou Salvar Como

O possível motivo para esse erro é que os tipos de conteúdo (também conhecidos como tipos MIME) não estão sendo registrados corretamente no servidor ou no 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, marcar que o .NET Framework 2.0 esteja instalado em seu 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, marcar para erros de rede e tente novamente mais tarde"

Esta mensagem indica que um ou mais arquivos que a referência de manifestos do ClickOnce não podem ser baixados. A maneira mais fácil de depurar esse erro é tentar baixar a URL que o ClickOnce diz que não pode ser baixada. Aqui estã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 que ele não bloqueie o download deste arquivo. Para obter mais informações, confira Problemas de Configuração do Servidor e do Cliente em Implantações do ClickOnce.
  • Se o arquivo .config estiver sendo bloqueado pelo servidor, consulte Baixar erro ao tentar instalar um aplicativo ClickOnce que tenha um arquivo .config.
  • Determine se esse erro ocorreu porque a deploymentProvider URL no manifesto de implantação está apontando para um local diferente da URL usada para ativação.
  • Verifique se todos os arquivos estão presentes no servidor; O log do ClickOnce deve informar qual arquivo não foi encontrado.
  • Confira se há problemas de conectividade de rede; você pode receber essa mensagem se o computador cliente ficar offline durante o download.

Baixar erro ao tentar instalar um aplicativo ClickOnce que tenha um arquivo .config

Por padrão, um aplicativo baseado em Windows do Visual Basic inclui um arquivoApp.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 permitir que o arquivo .config seja instalado, selecione Usar a extensão de arquivo ".deploy" na caixa de diálogo Publicar Opções .

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 é formatado incorretamente; O arquivo de log contém "A assinatura XML é inválida"

Verifique se você atualizou o arquivo de manifesto e o assinou novamente. Republice 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 deploymentProvider URL no manifesto de implantação. Verifique se você está atualizando os bits no mesmo local que 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 examinará uma atualização até que esse intervalo tenha passado. Você pode alterar o manifesto para verificar uma atualização sempre que o aplicativo for iniciado. Alterar o intervalo de atualização é uma opção conveniente durante o tempo de desenvolvimento para verificar se as atualizações estão sendo instaladas, mas reduz a velocidade da ativação do aplicativo.
  • Tente iniciar o aplicativo novamente no menu Iniciar. 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 que tem 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 sincronização com a outra. A identidade de um assembly consiste em seu nome, versão, cultura e token de chave pública. Examine as descrições de identidade em seus manifestos e corrija as diferenças.

A ativação pela primeira vez do disco local ou cd-ROM é bem-sucedida, mas a ativação subsequente do Menu Iniciar não é bem-sucedida

ClickOnce usa a URL do Provedor de Implantação para receber atualizações para o aplicativo. Verifique se o local ao 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 em instalar esse aplicativo no repositório ClickOnce. O aplicativo tem um erro ou o repositório está corrompido. O arquivo de log pode dizer onde o erro ocorreu.

Para resolver esse problema, siga estas etapas:

  1. Verifique se a identidade do manifesto de implantação, a identidade do manifesto do aplicativo e a identidade do EXE do aplicativo main são todos exclusivos.
  2. Verifique se os caminhos de arquivo não são mais de 100 caracteres. Se seu aplicativo contiver caminhos de arquivo muito longos, você poderá exceder as limitações no caminho máximo que pode armazenar. Tente encurtar os caminhos e reinstalar.

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

Para usar o PrivatePath (caminhos de sondagem 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 aparece dizendo: "Falha ao desinstalar o aplicativo"

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

Durante a instalação, aparece uma mensagem que diz 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.

Publicação com o Visual Studio

Falha na publicação no Visual Studio

Verifique se você tem o direito de publicar no servidor que está direcionando. Por exemplo, se você estiver conectado a um computador de 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 extensões do FrontPage Server habilitadas.

Erro: não é possível criar o site '<site>'. Os componentes para comunicação com extensões do FrontPage Server não estão instalados

Verifique se você tem o Componente de Criação 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 estilos visuais habilitados. Para resolve esse problema, consulte Como: Publicar um aplicativo WPF com estilos visuais habilitados.

Usando o Mage

Você tentou assinar com um certificado no repositório de certificados e uma caixa de mensagens em branco recebida

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

  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 são necessários para serem assinados. Basta selecionar uma das opções de assinatura e selecione 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 de aplicativos.

Não é possível iniciar o aplicativo. Entre em contato com o fornecedor de aplicativos para obter assistência.		 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. Frequentemente, isso significa que o aplicativo está de alguma forma corrompido ou que o repositório ClickOnce está corrompido.
Não é possível continuar. O aplicativo é formatado incorretamente. Entre em contato com o editor de aplicativos para obter assistência.

A validação do aplicativo não foi bem-sucedida. Não é possível continuar.

Não é possível recuperar arquivos de aplicativo. Arquivos corrompidos na implantação.		 Um dos arquivos de manifesto na implantação não é sintáticamente válido 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 está corrompido. Crie novamente sua implantação e recompile seu aplicativo ou localize e corrija os erros manualmente em seus manifestos.
Não é possível recuperar o aplicativo. Erro de autenticação.

A instalação do aplicativo não teve êxito. Não é possível localizar arquivos de aplicativos no servidor. Entre em contato com o editor de aplicativos ou seu 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 por um erro 403 Proibido sendo retornado por um servidor Web, que pode ocorrer se um dos arquivos em sua implantação terminar com uma extensão que faz com que o servidor Web o trate como um arquivo protegido. Além disso, um diretório que contém um ou mais arquivos do aplicativo pode exigir um nome de usuário e uma senha para acessar.
Não é possível baixar o aplicativo. O aplicativo está ausente dos arquivos necessários. Entre em contato com o fornecedor de aplicativos 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 teve êxito. 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 sua rede.
A URLDownloadToCacheFile falhou com o '<número>' HRESULT. Ocorreu um erro ao tentar baixar o '<arquivo>'. Se um usuário tiver definido a opção Internet Explorer Advanced Security "Avisar se a alteração entre o modo seguro e não seguro" no computador de destino de implantação e se a URL de instalação do aplicativo ClickOnce que está sendo instalado for redirecionada de um não seguro para um site seguro (ou vice-versa), a instalação falhará porque o aviso do Explorer da Internet o interromperá.

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

– Desmarque a opção de segurança.
- Verifique se a URL de instalação não é redirecionada de forma que altere os modos de segurança.
– Remova o redirecionamento completamente e aponte para a URL de configuração real.
Ocorreu um erro ao gravar no disco rígido. Pode haver espaço insuficiente disponível no disco. Entre em contato com o fornecedor de aplicativos 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 ao tentar 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. Desmarque o espaço e tente executar o aplicativo novamente.
Muitas ativações implantadas estão tentando carregar de uma só vez. ClickOnce limita o número de aplicativos diferentes que podem começar ao mesmo tempo. Isso é em grande parte para ajudar a proteger contra tentativas mal-intencionadas de instigar ataques de negação de serviço contra o serviço local clickOnce; os usuários que tentam 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. 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 de aplicativos ou o administrador do sistema para obter assistência. Um aplicativo executado em confiança parcial não pode ser maior que metade do tamanho da cota de aplicativo online, que por padrão é de 250 MB.

Referências