Risoluzione dei problemi relativi alla distribuzione di soluzioni Office (System 2007)
Aggiornamento: Luglio 2008
Si applica a |
---|
Le informazioni contenute in questo argomento riguardano solo i progetti Visual Studio Tools per Office e le versioni di Microsoft Office specificati. Tipo di progetto
Versione Microsoft Office
Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazione. |
In questa sezione sono contenuti suggerimenti per la risoluzione di problemi comuni che è possibile riscontrare durante la distribuzione di soluzioni Microsoft Office mediante Visual Studio Tools per Office.
Modifica del nome di assembly che 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 package di installazione in modo che contenga un file Setup.exe e due manifesti di distribuzione. La distribuzione di due file manifesto può determinare le seguenti condizioni:
Se l'utente finale installa entrambe le versioni, nell'applicazione verranno caricati entrambi i componenti aggiuntivi.
Se il componente aggiuntivo è stato installato prima della modifica del nome di assembly, l'utente finale non riceverà mai aggiornamenti.
Per evitare il verificarsi di queste condizioni, non modificare il valore Nome assembly della soluzione dopo averla distribuita.
Controllo della disponibilità di aggiornamenti che richiede molto tempo
In Microsoft Visual Studio Tools per Microsoft Office System (versione 3.0 Runtime) viene fornita una voce del Registro di sistema che consente agli amministratori di impostare il valore di timeout per scaricare i manifesti e la soluzione.
Per impostare il valore di timeout
Nel Registro di sistema passare alla seguente chiave:
HKEY_CURRENT_USER\Software\Microsoft\VSTA
Nella sottochiave AddInTimeout, impostare il valore di timeout in millisecondi.
Se la sottochiave AddInTimeout non esiste, crearla come DWORD.
Impossibilità di eseguire l'aggiornamento o la pubblicazione in una condivisione di file di rete
Le soluzioni Office situate in una condivisione di file di rete potrebbero visualizzare un messaggio fuorviante durante gli aggiornamenti se il file Setup.exe della soluzione è bloccato in un processo mentre viene pubblicato l'aggiornamento. Il messaggio potrebbe indicare che è impossibile aggiungere il file Setup.exe al sito Web, poiché tale file esiste già nel sito Web.
Per impedire il blocco del file, è possibile rendere la condivisione di sola lettura per gli utenti finali. Tuttavia, se nella condivisione sono presenti documenti, diventeranno anch'essi di sola lettura per gli utenti finali.
Prerequisiti per Microsoft Office System 2007 non installati
È possibile aggiungere Microsoft .NET Framework, Visual Studio Tools per Office Runtime e gli assembly di interoperabilità primari di Microsoft Office al package di installazione come prerequisiti distribuiti con la soluzione Visual Studio Tools per Office. Per informazioni su come installare gli assembly di interoperabilità primari, vedere Installazione di Visual Studio Tools per Office e Procedura: installare assembly di interoperabilità primari di Office.
Pubblicazione mediante "localhost" che può provocare problemi di installazione
Quando si utilizza "https://localhost" come percorso di installazione o di pubblicazione per soluzioni a livello di documento, la Pubblicazione guidata di Visual Studio Tools per Office non converte la stringa nel nome effettivo del computer. In tal caso, la soluzione può essere installata solo nel computer di sviluppo. Per fare in modo che le soluzioni distribuite utilizzino IIS nel computer di sviluppo, utilizzare il nome completo per tutti i percorsi HTTP/HTTPS/FTP invece di localhost.
Caricamento di assembly memorizzati nella cache anziché di assembly aggiornati
Fusion, caricatore di assembly di .NET Framework, carica la copia di assembly memorizzata nella cache quando il percorso di output del progetto è situato in una condivisione di file di rete, l'assembly è firmato con un nome sicuro e la versione di assembly della personalizzazione non viene modificata. Se si aggiorna un assembly che soddisfa tali condizioni, l'aggiornamento non verrà visualizzato la volta successiva che si esegue il progetto poiché viene caricata la copia memorizzata nella cache.
È possibile configurare Visual Studio in modo che Fusion scarichi assembly ogni volta che il progetto viene eseguito.
Per scaricare assembly anziché caricare copie memorizzate nella cache
Scegliere ProprietàNomeProgetto dal menu Progetto.
Nella pagina Applicazione fare clic su Informazioni assembly.
Nella prima casella Versione assembly digitare un asterisco (*).
Scegliere OK.
Dopo aver modificato la versione di assembly, è possibile continuare a firmare l'assembly con un nome sicuro e Fusion caricherà la versione più recente della personalizzazione.
Schemi XML nelle personalizzazioni a livello di documento non registrati
Se si allega uno schema XML a un documento in un progetto a livello di documento per Microsoft Office System 2007, lo schema non viene registrato nella libreria dell'utente. Per eseguire questa operazione, è necessario creare un file del programma di installazione separato. Per ulteriori informazioni, vedere la classe Schemi e dati XML (Visual Studio Tools per Office).
Esito negativo dell'installazione quando l'URI contiene caratteri non US-ASCII
Quando si pubblica una soluzione Visual Studio Tools per Office in un percorso HTTP/HTTPS/FTP, tale percorso non può contenere caratteri Unicode in formato non US-ASCII. Tali caratteri possono determinare un comportamento incoerente nel programma di installazione. Utilizzare caratteri US-ASCII per il percorso di installazione.
Richiesta di disinstallazione manuale visualizzata al momento della pubblicazione e installazione di una soluzione nel computer di sviluppo
Quando si compila una soluzione di Visual Studio Tools per Office, la versione compilata viene registrata automaticamente. Se la stessa soluzione è stata pubblicata e installata in precedenza nel computer di sviluppo, dopo la compilazione, ricompilazione o pubblicazione successiva in Visual Studio Tools per Office verrà rilevato un diverso percorso di installazione per la versione pubblicata e la versione compilata. Verrà visualizzato il messaggio di errore "Impossibile installare la personalizzazione perché ne è installata un'altra versione che non può essere aggiornata da questo percorso". Poiché la ricompilazione della soluzione comporta l'aggiornamento delle chiavi del Registro di sistema, prima di pubblicare, eseguire il debug o eseguire la seconda versione è necessario disinstallare la prima 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 della successiva pubblicazione, del successivo debug o della successiva ricompilazione della soluzione.
Errore di eccezione non intercettata o metodo non trovato durante l'installazione di una soluzione
Quando si installano soluzioni di Office sviluppate in Visual Studio 2008 Service Pack 1 (SP1) aprendo il manifesto di distribuzione (un file con estensione vsto), un'applicazione, un documento o una cartella di lavoro di Office, è possibile che vengano visualizzati messaggi di errore relativi alle condizioni seguenti:
Metodo non trovato.
MissingMethodException.
Eccezione non intercettata.
Per evitare la visualizzazione di tali messaggi di errore, installare la soluzione eseguendo il programma di installazione.
Per le soluzioni Office sviluppate utilizzando Visual Studio 2008 SP1 è necessario il Service Pack 1 nel runtime di Visual Studio Tools per Office 3.0. Il programma di installazione verifica la versione corretta dei requisiti, incluso il Service Pack 1 per il runtime, e li installa secondo le necessità. Tuttavia, se si installa la soluzione senza eseguire il programma di installazione, i prerequisiti non verranno verificati o installati.
Le chiavi del Registro di sistema del manifesto per i componenti aggiuntivi vengono modificati dopo la compilazione di un progetto di programma di installazione Windows Installer
Quando si compila il progetto di programma di installazione Windows Installer, la chiave del Registro di sistema del manifesto che fa parte di un programma di installazione di un componente aggiuntivo viene a volte modificata da file manifesto con estensione vsto a file manifesto con estensione dll.
Per risolvere questo problema, creare il progetto di programma di installazione in una soluzione diversa oppure utilizzare CompanyName.AddinName come valore della chiave del Registro di sistema che include il nome del componente aggiuntivo.
Tale procedura non è necessaria se si utilizza Visual Studio 2008 SP1.
Il programma di installazione ClickOnce per la soluzione Office creata 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 è ancora stato installato alcun assembly di interoperabilità primario.
Se gli assembly di interoperabilità primari non vengono installati correttamente dal programma di installazione, installarli manualmente eseguendo il file del programma di installazione denominato o2007pia.msi dalla directory di installazione.
Vedere anche
Concetti
Risoluzione dei problemi relativi alle distribuzioni ClickOnce
Distribuzione di soluzioni Office (2007 System)
Riferimenti
Risoluzione dei problemi (Procedure relative a Visual Studio Tools per Office)
Cronologia delle modifiche
Data |
Cronologia |
Motivo |
---|---|---|
Luglio 2008 |
Aggiunte informazioni per gli scenari di risoluzione dei problemi. |
Modifica di funzionalità in SP1. |