Risolvere gli errori specifici nelle distribuzioni ClickOnce

  • Articolo

Si applica a: Visual Studio

Questo articolo introduce errori comuni che possono verificarsi durante la distribuzione dell'applicazione ClickOnce e fornisce la procedura per risolvere ogni problema.

Errori generali

Quando si tenta di individuare un file dell'applicazione, non si verifica nulla o viene eseguito il rendering XML in Internet Explorer oppure si riceve una finestra di dialogo Esegui o Salva con nome

Il possibile motivo di questo errore è che i tipi di contenuto (noti anche come tipi MIME) non vengono registrati correttamente nel server o nel client.

Assicurarsi innanzitutto che il server sia configurato per associare l'estensione .application al tipo di contenuto "application/x-ms-application".

Se il server è configurato correttamente, verificare che .NET Framework 2.0 sia installato nel computer. Se .NET Framework 2.0 è installato e questo problema persiste, provare a disinstallare e reinstallare .NET Framework 2.0 per registrare nuovamente il tipo di contenuto nel client.

Errore: "Impossibile recuperare l'applicazione. File mancanti nella distribuzione" o "Il download dell'applicazione è stato interrotto, verificare la presenza di errori di rete e riprovare in un secondo momento"

Questo messaggio indica che non è possibile scaricare uno o più file di riferimento ai manifesti ClickOnce. Il modo più semplice per eseguire il debug di questo errore consiste nel provare a scaricare l'URL che ClickOnce indica di non poter scaricare. Ecco alcune possibili cause:

  • Se il file di log indica "(403) Non consentito" o "(404) Non trovato", verificare che il server Web sia configurato in modo che non blocchi il download del file. Per altre informazioni, vedere Problemi di configurazione del server e del client in Distribuzioni ClickOnce.
  • Se il file .config viene bloccato dal server, vedere Errore di download quando si tenta di installare un'applicazione ClickOnce con un file .config.
  • Determinare se questo errore si è verificato perché l'URL deploymentProvider nel manifesto della distribuzione punta a una posizione diversa rispetto all'URL usato per l'attivazione.
  • Assicurarsi che tutti i file siano presenti nel server; Il log ClickOnce dovrebbe indicare quale file non è stato trovato.
  • Verificare se sono presenti problemi di connettività di rete; è possibile ricevere questo messaggio se il computer client è andato offline durante il download.

Errore di download quando si tenta di installare un'applicazione ClickOnce con un file .config

Per impostazione predefinita, un'applicazione basata su Windows di Visual Basic include un file App.config . È possibile che si verifichi un problema se si tenta di eseguire l'installazione da un server Web che usa Windows Server 2003, perché il sistema operativo blocca l'installazione dei file .config per motivi di sicurezza. Per abilitare l'installazione del file .config , selezionare Usa estensione di file ".deploy" nella finestra di dialogo Opzioni di pubblicazione .

È anche necessario impostare i tipi di contenuto (noti anche come tipi MIME) in modo appropriato per i file con estensione application, manifest e deploy . Per altre informazioni, vedere la documentazione del server Web.

Per altre informazioni, vedere Windows Server: Tipi di contenuto bloccati.

Errore: l'applicazione è formattata in modo non corretto; Il file di log contiene "Firma XML non valida"

Assicurarsi di aver aggiornato il file manifesto e di firmarlo di nuovo. Ripubblicare l'applicazione usando Visual Studio o usare Mage per firmare di nuovo l'applicazione.

L'applicazione è stata aggiornata nel server, ma il client non scarica l'aggiornamento

Questo problema può essere risolto completando una delle attività seguenti:

  • Esaminare l'URL deploymentProvider nel manifesto della distribuzione. Assicurarsi di aggiornare i bit nella stessa posizione a cui deploymentProvider punta.
  • Verificare l'intervallo di aggiornamento nel manifesto della distribuzione. Se questo intervallo è impostato su un intervallo periodico, ad esempio una volta ogni sei ore, ClickOnce non eseguirà l'analisi di un aggiornamento fino al superamento di questo intervallo. È possibile modificare il manifesto per cercare un aggiornamento ogni volta che viene avviata l'applicazione. La modifica dell'intervallo di aggiornamento è un'opzione utile durante il tempo di sviluppo per verificare che gli aggiornamenti vengano installati, ma rallenta l'attivazione dell'applicazione.
  • Provare a riavviare l'applicazione dal menu Start. ClickOnce potrebbe aver rilevato l'aggiornamento in background, ma richiederà di installare i bit all'attivazione successiva.

Durante l'aggiornamento viene visualizzato un errore con la voce di log seguente: "Il riferimento nella distribuzione non corrisponde all'identità definita nel manifesto dell'applicazione"

Questo errore può verificarsi perché sono stati modificati manualmente i manifesti di distribuzione e dell'applicazione e la descrizione dell'identità di un assembly in un manifesto non è stata sincronizzata con l'altro. L'identità di un assembly è costituita dal nome, dalla versione, dalle impostazioni cultura e dal token di chiave pubblica. Esaminare le descrizioni delle identità nei manifesti e correggere eventuali differenze.

La prima attivazione da disco locale o CD-ROM ha esito positivo, ma l'attivazione successiva dal menu Start non ha esito positivo

ClickOnce usa l'URL del provider di distribuzione per ricevere gli aggiornamenti per l'applicazione. Verificare che il percorso a cui punta l'URL sia corretto.

Errore: impossibile avviare l'applicazione

Questo messaggio di errore indica in genere che si è verificato un problema durante l'installazione dell'applicazione nell'archivio ClickOnce. L'applicazione presenta un errore o l'archivio è danneggiato. Il file di log potrebbe indicare dove si è verificato l'errore.

Per risolvere questo problema, attenersi alla seguente procedura:

  1. Assicurarsi che l'identità del manifesto della distribuzione, l'identità del manifesto dell'applicazione e l'identità dell'EXE dell'applicazione principale siano univoche.
  2. Assicurarsi che i percorsi dei file non siano più lunghi di 100 caratteri. Se l'applicazione contiene percorsi di file troppo lunghi, è possibile superare le limitazioni del percorso massimo che è possibile archiviare. Provare ad abbreviare i percorsi e quindi reinstallare.

Le impostazioni di PrivatePath nel file di configurazione dell'applicazione non vengono rispettate

Per usare PrivatePath (percorsi di probe fusion), l'applicazione deve richiedere l'autorizzazione di attendibilità completa. Provare a modificare il manifesto dell'applicazione per richiedere l'attendibilità completa e quindi riprovare.

Durante la disinstallazione viene visualizzato un messaggio che indica che non è stato possibile disinstallare l'applicazione

Questo messaggio indica in genere che l'applicazione è già stata rimossa o che l'archivio è danneggiato. Dopo aver selezionato OK, la voce Aggiungi/Rimuovi programma verrà rimossa.

Durante l'installazione viene visualizzato un messaggio che indica che le dipendenze della piattaforma non sono installate

Manca un prerequisito nella GAC (Global Assembly Cache) necessario per l'esecuzione dell'applicazione.

Pubblicazione con Visual Studio

La pubblicazione in Visual Studio non riesce

Assicurarsi di avere il diritto di pubblicare nel server di destinazione. Ad esempio, se si è connessi a un computer server terminal come utente normale, non come amministratore, probabilmente non si avranno i diritti necessari per pubblicare nel server Web locale.

Se si esegue la pubblicazione con un URL, assicurarsi che nel computer di destinazione siano abilitate le estensioni del server di FrontPage.

Errore: impossibile creare il sito Web '<site>'. I componenti per la comunicazione con le estensioni del server di FrontPage non sono installati

Assicurarsi di avere installato il componente di creazione Web di Microsoft Visual Studio nel computer da cui si sta pubblicando. Per gli utenti Express, questo componente non è installato per impostazione predefinita.

Errore: Impossibile trovare il file 'Microsoft.Windows.Common-Controls, Version=6.0.0.0, Culture=*, PublicKeyToken=6595b64144ccf1df, ProcessorArchitecture=*, Type=win32'

Questo messaggio di errore viene visualizzato quando si tenta di pubblicare un'applicazione WPF con gli stili di visualizzazione abilitati. Per risolvere questo problema, vedere Procedura: Pubblicare un'applicazione WPF con stili di visualizzazione abilitati.

Uso di Mage

Si è tentato di firmare con un certificato nell'archivio certificati e una finestra di messaggio vuota ricevuta

Nella finestra di dialogo Firma è necessario:

  1. Selezionare Firma con un certificato archiviato.
  2. Selezionare un certificato dall'elenco; il primo certificato non è la selezione predefinita.

Facendo clic sul pulsante "Non firmare" viene generata un'eccezione

Questo problema è un bug noto. Tutti i manifesti ClickOnce devono essere firmati. È sufficiente selezionare una delle opzioni di firma e quindi selezionare OK.

Altri errori

La tabella seguente mostra alcuni messaggi di errore comuni che un utente client-computer può ricevere quando l'utente installa un'applicazione ClickOnce. Ogni messaggio di errore è elencato accanto a una descrizione della causa più probabile per l'errore.

Messaggio di errore Descrizione
Impossibile avviare l'applicazione. Contattare l'editore dell'applicazione.

Impossibile avviare l'applicazione. Per assistenza, contattare il fornitore dell'applicazione.		 Si tratta di messaggi di errore generici che si verificano quando non è possibile avviare l'applicazione e non è possibile trovare altri motivi specifici. Spesso questo significa che l'applicazione è in qualche modo danneggiata o che l'archivio ClickOnce è danneggiato.
Impossibile continuare. La formattazione dell'applicazione non è corretta. Per assistenza, contattare l'editore dell'applicazione.

La convalida dell'applicazione non ha avuto esito positivo. Impossibile continuare.

Impossibile recuperare i file dell'applicazione. File danneggiati nella distribuzione.		 Uno dei file manifesto nella distribuzione non è sintatticamente valido o contiene un hash che non può essere riconciliato con il file corrispondente. Questo errore può anche indicare che il manifesto incorporato in un assembly è danneggiato. Ricreare la distribuzione e ricompilare l'applicazione oppure trovare e correggere manualmente gli errori nei manifesti.
Impossibile recuperare l'applicazione. Errore di autenticazione.

L'installazione dell'applicazione non è riuscita. Impossibile individuare i file delle applicazioni nel server. Per assistenza, contattare l'editore dell'applicazione o l'amministratore.		 Non è possibile scaricare uno o più file nella distribuzione perché non si dispone dell'autorizzazione per accedervi. Questo problema può essere causato da un errore 403 Non consentito restituito da un server Web, che può verificarsi se uno dei file nella distribuzione termina con un'estensione che fa in modo che il server Web lo consideri come un file protetto. Inoltre, una directory che contiene uno o più file dell'applicazione potrebbe richiedere un nome utente e una password per accedere.
Impossibile scaricare l'applicazione. All'applicazione mancano i file necessari. Per assistenza, contattare il fornitore dell'applicazione o l'amministratore di sistema. Non è possibile trovare nel server uno o più file elencati nel manifesto dell'applicazione. Verificare di aver caricato tutti i file dipendenti della distribuzione e riprovare.
Il download dell'applicazione non ha avuto esito positivo. Controllare la connessione di rete o contattare l'amministratore di sistema o il provider di servizi di rete. ClickOnce non è in grado di stabilire una connessione di rete al server. Esaminare la disponibilità del server e lo stato della rete.
URLDownloadToCacheFile non riuscito con HRESULT '<number>'. Errore durante il tentativo di scaricare '<file>'. Se un utente ha impostato l'opzione Sicurezza avanzata di Internet Explorer "Avvisa se si passa dalla modalità sicura a quella non sicura" nel computer di destinazione della distribuzione e se l'URL di installazione dell'applicazione ClickOnce installata viene reindirizzato da un sito non sicuro a un sito sicuro (o viceversa), l'installazione avrà esito negativo perché l'avviso di Internet Explorer lo interrompe.

Per risolvere questo errore, è possibile eseguire una delle attività seguenti:

- Deselezionare l'opzione di sicurezza.
- Verificare che l'URL di installazione non venga reindirizzato in modo da modificare le modalità di sicurezza.
- Rimuovere completamente il reindirizzamento e puntare all'URL di installazione effettivo.
Si è verificato un errore durante la scrittura nel disco rigido. Lo spazio disponibile sul disco potrebbe essere insufficiente. Per assistenza, contattare il fornitore dell'applicazione o l'amministratore di sistema. Questo potrebbe indicare spazio su disco insufficiente per l'archiviazione dell'applicazione, ma potrebbe anche indicare un errore di I/O più generale quando si tenta di salvare i file dell'applicazione nell'unità.
Impossibile avviare l'applicazione. Lo spazio disponibile sul disco non è sufficiente. Il disco rigido è pieno. Cancellare lo spazio e provare a eseguire di nuovo l'applicazione.
Troppe attivazioni distribuite stanno tentando di caricare contemporaneamente. ClickOnce limita il numero di applicazioni diverse che possono essere avviate contemporaneamente. Ciò è in gran parte utile per proteggere da tentativi dannosi di istigare attacchi Denial of Service contro il servizio ClickOnce locale; gli utenti che tentano di avviare ripetutamente la stessa applicazione, in rapida successione, finiranno con una singola istanza dell'applicazione.
I collegamenti non possono essere attivati in rete. I collegamenti a un'applicazione ClickOnce possono essere avviati solo sul disco rigido locale. Non è possibile avviarli aprendo un URL che punta a un file di collegamento in un server remoto.
L'applicazione è troppo grande per essere eseguita online con attendibilità parziale. Per assistenza, contattare il fornitore dell'applicazione o l'amministratore di sistema. Un'applicazione eseguita con attendibilità parziale non può essere superiore alla metà della dimensione della quota dell'applicazione online, che per impostazione predefinita è 250 MB.

Riferimenti