Risolvere i problemi di distribuzione della soluzione Office

Si applica a: Visual Studio

Questo articolo illustra come risolvere i problemi comuni che potrebbero verificarsi quando si distribuiscono soluzioni Di Office.

Le informazioni contenute in questo articolo si applicano ai progetti a livello di documento e ai progetti del componente aggiuntivo Visual Studio Tools per Office (VSTO). Vedere Funzionalità disponibili per l'applicazione e il tipo di progetto di Office.

Risolvere i problemi delle soluzioni Office usando il visualizzatore eventi

È possibile usare il Visualizzatore eventi in Windows per visualizzare i messaggi di errore acquisiti dal runtime di Visual Studio Tools per Office durante l'installazione o la disinstallazione di soluzioni Office. È possibile usare questi messaggi dal logger eventi per risolvere i problemi di installazione e distribuzione. Per altre informazioni, vedere Registrazione eventi per le soluzioni Office.

La modifica del nome dell'assembly causa conflitti

Se si modifica il valore nome assembly nella pagina Applicazione del progetto Designer dopo aver già distribuito una soluzione, gli strumenti di pubblicazione modificheranno il pacchetto di installazione in modo da avere un file Setup.exe e due manifesti di distribuzione. Se si distribuiscono due file manifesto, potrebbero verificarsi le condizioni seguenti:

  • Se l'utente finale installa entrambe le versioni, l'applicazione caricherà entrambi i componenti aggiuntivi VSTO.
  • Se il componente aggiuntivo VSTO è stato installato prima della modifica del nome dell'assembly, l'utente finale non riceverà mai gli aggiornamenti.

Per evitare queste condizioni, non modificare il valore nome assembly della soluzione dopo la distribuzione della soluzione.

La verifica della disponibilità di aggiornamenti richiede molto tempo

Il runtime di Visual Studio 2010 Tools per Office fornisce una voce del Registro di sistema che gli amministratori possono usare per impostare il valore di timeout per scaricare i manifesti e la soluzione.

Come impostare il valore di timeout

  1. Nel Registro di sistema passare alla chiave seguente:

    HKEY_CURRENT_USER\Software\Microsoft\VSTA

  2. Nella sottochiave AddInTimeout impostare il valore di timeout in millisecondi.

    Se la sottochiave AddInTimeout non esiste, crearla come DWORD.

Non è possibile aggiornare o pubblicare in una condivisione file di rete

Le soluzioni Office che si trovano in una condivisione file di rete potrebbero visualizzare un messaggio fuorviante durante gli aggiornamenti se il file Setup.exe della soluzione è bloccato in un processo durante la pubblicazione dell'aggiornamento. Il messaggio potrebbe essere il seguente: "Impossibile aggiungere 'setup.exe' al Web. Il file 'setup.exe' esiste già in questo Web."

Per impedire il blocco dei file, è possibile rendere la condivisione di sola lettura per gli utenti finali. Tuttavia, se i documenti sono nella condivisione, diventeranno anche di sola lettura per gli utenti finali.

I prerequisiti per Microsoft Office non sono installati

È possibile aggiungere .NET Framework, il runtime Visual Studio Tools per Office e gli assembly di interoperabilità primari di Office al pacchetto di installazione come prerequisiti distribuiti con la soluzione Office. Per informazioni su come installare gli assembly di interoperabilità primari, vedere Configurare un computer per sviluppare soluzioni Office e Procedura: Installare assembly di interoperabilità primari di Office.

La pubblicazione con Localhost può causare problemi di installazione

Quando si usa http://localhost come percorso di pubblicazione o installazione per soluzioni a livello di documento, la Pubblicazione guidata non converte la stringa nel nome del computer reale. In questo caso, la soluzione deve essere installata nel computer di sviluppo. Per fare in modo che le soluzioni distribuite usno IIS nel computer di sviluppo, usare il nome completo per tutti i percorsi HTTP/HTTPS/FTP anziché localhost.

Gli assembly memorizzati nella cache vengono caricati anziché assembly aggiornati

Fusion, il caricatore di assembly .NET Framework, carica la copia memorizzata nella cache degli assembly quando il percorso di output del progetto si trova in una condivisione file di rete, l'assembly viene firmato con un nome sicuro e la versione dell'assembly della personalizzazione non cambia. Se si aggiorna un assembly che soddisfa queste condizioni, l'aggiornamento non verrà visualizzato alla successiva esecuzione del progetto perché la copia memorizzata nella cache viene caricata.

È possibile configurare Visual Studio in modo che Fusion scarichi gli assembly ogni volta che viene eseguito il progetto.

Come scaricare gli assembly invece di caricare copie memorizzate nella cache

  1. Sulla barra dei menu selezionare Project, ProjectName Properties.On the menu bar, select Project, <ProjectName> Properties.
  2. Nella pagina Applicazione selezionare Informazioni assembly.
  3. Impostare il numero di revisione, terzo campo, della versione assembly, su un carattere jolly (*). Ad esempio, "1.0.*". Selezionare quindi il pulsante OK .

Dopo aver modificato la versione dell'assembly, è possibile continuare a firmare l'assembly con un nome sicuro e Fusion caricherà la versione più recente della personalizzazione.

Nota

A partire da Visual Studio 2017, se si prova a usare caratteri jolly nella versione assembly si verificherà un errore di compilazione. Questo perché i caratteri jolly nella versione dell'assembly interromperanno la funzionalità deterministica DI MSBuild. Verrà richiesto di rimuovere i caratteri jolly dalla versione dell'assembly o di disabilitare il determinismo. Per altre informazioni sulla funzionalità deterministica, vedere: Proprietà comuni del progetto MSBuild e Personalizzare la compilazione

L'installazione non riesce quando l'URI ha caratteri che non sono US-ASCII

Quando si pubblica una soluzione Office in un percorso HTTP/HTTPS/FTP, il percorso non può avere caratteri Unicode non presenti in US-ASCII. Tali caratteri possono causare un comportamento incoerente nel programma di installazione. Usare i caratteri US-ASCII per il percorso di installazione.

La richiesta di disinstallazione manuale viene visualizzata quando si pubblica e si installa una soluzione nel computer di sviluppo

Quando si compila una soluzione Office, la versione compilata viene registrata automaticamente. Se in precedenza è stata pubblicata e installata la stessa soluzione nel computer di sviluppo, Visual Studio Tools per Office runtime rileva che il percorso di installazione per la versione pubblicata e la versione compilata sono diversi dopo la successiva compilazione, ricompilata o pubblicazione della soluzione. Il messaggio di errore indica che la personalizzazione non può essere installata perché è attualmente installata un'altra versione e non può essere aggiornata da questo percorso. Le chiavi del Registro di sistema vengono aggiornate ogni volta che viene ricompilata una soluzione. È pertanto necessario disinstallare la versione precedente prima di pubblicare, eseguire il debug o eseguire la nuova versione.

Per impedire la visualizzazione del messaggio, creare un altro account utente nel computer di sviluppo per testare la distribuzione. In alternativa, è possibile disinstallare la versione dall'elenco dei programmi installati nel computer prima di pubblicare, eseguire il debug o ricompilare la soluzione.

Errore di eccezione o metodo non rilevato durante l'installazione di una soluzione

Quando si installano soluzioni Office aprendo il manifesto della distribuzione (un file vsto ), un'applicazione, un documento o una cartella di lavoro di Office, potrebbero essere visualizzati messaggi di errore per le condizioni seguenti:

  • Metodo non trovato.
  • Missingmethodexception.
  • Eccezione non rilevata.

Per evitare questi messaggi di errore, installare la soluzione eseguendo il programma di installazione.

Quando si installa la soluzione senza eseguire il programma di installazione, il programma di installazione non verifica né installa i prerequisiti. Il programma di installazione verifica la versione corretta dei prerequisiti e li installa in base alle esigenze.

Le chiavi del Registro di sistema manifesto per i componenti aggiuntivi cambiano dopo la compilazione di un progetto InstallShield Limited Edition

La chiave del Registro di sistema manifesto che fa parte di un programma di installazione del componente aggiuntivo VSTO a volte passa da vsto a .dll.manifest quando si compila un progetto InstallShield Limited Edition.

Per risolvere questo problema, creare il progetto InstallShield Limited Edition in una soluzione diversa oppure usare CompanyName.AddinName come valore della chiave del Registro di sistema che contiene il nome del componente aggiuntivo VSTO.

Il programma di installazione ClickOnce per la soluzione Office non installa gli assembly di interoperabilità primari

Quando si esegue il programma di installazione creato da ClickOnce per la soluzione Office, il programma di installazione per gli assembly di interoperabilità primari di Office viene eseguito solo se non sono già stati installati IPA.

Se il programma di installazione non installa correttamente i PIA, installarli manualmente eseguendo il file del programma di installazione denominato o2007pia.msi dalla directory di installazione.

Reinstallare le soluzioni di Office causa un'eccezione di argomento fuori intervallo

Quando si reinstalla una soluzione Office, potrebbe essere visualizzata un'eccezione ArgumentOutOfRangeException con il messaggio di errore seguente: L'argomento specificato non è compreso nell'intervallo di valori validi.

Questa situazione si verifica se la combinazione di maiuscole e minuscole per l'URL per il percorso di installazione è diversa. Ad esempio, questo errore viene visualizzato se è stata installata una soluzione Office dalla http://fabrikam.com/ExcelSolution.vsto prima volta e quindi è stata usata http://fabrikam.com/excelsolution.vsto la seconda volta.

Per impedire la visualizzazione del messaggio, usare la stessa combinazione di maiuscole e minuscole quando si installano soluzioni Office.

Non è possibile installare una soluzione ClickOnce aprendo il manifesto della distribuzione dal Web

Gli utenti possono installare soluzioni Office aprendo il manifesto della distribuzione dal Web. Tuttavia, alcune installazioni di Internet Information Services (IIS) bloccano l'estensione del nome file vsto . È necessario definire il tipo MIME in IIS prima di usarlo per distribuire una soluzione Office.

Per informazioni su come definire il tipo MIME in IIS 7, vedere Aggiungere un tipo MIME (IIS7).

Impostare l'estensione su .vsto e il tipo MIME su application/x-ms-vsto.

Riferimenti