Condividi tramite

Risolvere i problemi di distribuzione della soluzione Office

  • Articolo

Si applica a: Visual Studio

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

Le informazioni contenute in questo articolo si applicano a progetti a livello di documento e Strumenti di Visual Studio per i progetti di componenti aggiuntivi di Office (VSTO). Vedere Funzionalità disponibili per app Office lication e tipo di progetto.

Risolvere i problemi relativi alle soluzioni Office usando il visualizzatore eventi

È possibile usare il visualizzatore eventi in Windows per visualizzare i messaggi di errore acquisiti dal runtime di Strumenti di Visual Studio per Office durante l'installazione o la disinstallazione di soluzioni Office. Questi messaggi del registratore eventi possono essere usati per risolvere i problemi di installazione e di 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 di Progettazione progetti 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 aggiornamenti.

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

La verifica della disponibilità di aggiornamenti richiede molto tempo

Visual Studio 2010 Tools per Office runtime fornisce una voce del Registro di sistema che gli amministratori possono usare per impostare il valore di timeout per il download dei manifesti e della 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 in una condivisione file di rete potrebbero visualizzare un messaggio fuorviante durante gli aggiornamenti se il file di Setup.exe della soluzione è bloccato in un processo durante la pubblicazione dell'aggiornamento. Il messaggio può essere analogo al seguente: "Impossibile aggiungere 'setup.exe' al sito Web. Il file 'setup.exe' esiste già nel sito Web".

Per evitare il blocco del file, si può impostare la condivisione come di sola lettura per gli utenti finali. Tuttavia, se i documenti si trovano 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 di Strumenti di Visual Studio 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 le soluzioni a livello di documento, la Pubblicazione guidata non converte la stringa nel nome computer reale. In questo caso, è necessario installare la soluzione nel computer di sviluppo. Per fare in modo che le soluzioni distribuite usino 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 invece di assembly aggiornati

Fusion, il caricatore di assembly di .NET Framework, carica la copia degli assembly memorizzata nella cache quando il percorso di output del progetto è in una condivisione file di rete, l'assembly è 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 la volta successiva che si esegue il progetto perché viene caricata la copia memorizzata nella cache.

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

Come scaricare gli assembly invece di caricare copie memorizzate nella cache

  1. Sulla barra dei menu selezionare Progetto, <Proprietà NomeProgetto>.
  2. Nella pagina Applicazione selezionare Informazioni assembly.
  3. Impostare il numero di revisione, il 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 nome sicuro e Fusion caricherà la versione più recente della personalizzazione.

Note

A partire da Visual Studio 2017, se si prova a usare caratteri jolly nella versione assembly si verificherà un errore di compilazione. Ciò è dovuto al fatto che 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 disabilitare il determinismo. Per altre informazioni sulla funzionalità deterministica, vedere: Proprietà comuni del progetto MSBuild e Personalizzare la compilazione

L'installazione ha esito negativo 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ò contenere caratteri Unicode non US-ASCII. Questi caratteri possono causare un comportamento incoerente nel programma di installazione. Usare caratteri US-ASCII per il percorso di installazione.

Viene visualizzata una richiesta di disinstallazione manuale 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, Strumenti di Visual Studio per il runtime di Office rileva che il percorso di installazione per la versione pubblicata e la versione compilata sono diversi dopo la compilazione, la ricompilazione o la 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, prima della pubblicazione, del debug o dell'esecuzione della nuova versione, occorre disinstallare la versione precedente.

Per evitare la comparsa del messaggio, creare un altro account utente nel computer di sviluppo per testare la distribuzione. In alternativa, si può disinstallare la versione dall'elenco dei programmi installati nel computer prima di procedere alla pubblicazione, al debug o alla ricompilazione della 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 con estensione vsto), app Office lication, document o cartella di lavoro, potrebbero essere visualizzati messaggi di errore per le condizioni seguenti:

  • Impossibile trovare il metodo.
  • 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, non vengono cercati o installati i prerequisiti. Il programma di installazione verifica la versione corretta dei prerequisiti e li installa, se necessario.

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

La chiave del Registro di sistema del manifesto che fa parte di un programma di installazione del componente aggiuntivo VSTO talvolta cambia 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à installati assembly di interoperabilità primari.

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 Office causa un'eccezione non compreso nell'intervallo

Quando si reinstalla una soluzione Office, è possibile che venga visualizzata un'eccezione ArgumentOutOfRangeException con il messaggio di errore seguente: Argomento specificato non compreso nell'intervallo.

Questa situazione si verifica se la combinazione di maiuscole e minuscole per l'URL del 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 evitare che venga visualizzato il 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 .vsto e il tipo MIME su application/x-ms-vsto.

Riferimenti