Distribuzione di soluzioni Office

Articolo
08/11/2011

È possibile distribuire le soluzioni Office tramite le tecnologie di distribuzione ClickOnce o Windows Installer (MSI). Nelle soluzioni Office ClickOnce viene utilizzato secondo l'implementazione in Runtime di Visual Studio Tools per Office e .NET Framework 3.5. Si riscontra quindi una leggera differenza rispetto alla funzionalità disponibile nelle applicazioni Windows Form, in cui la funzionalità viene utilizzata solo in .NET Framework. ClickOnce è progettato per semplificare la distribuzione e la manutenzione delle soluzioni poiché le soluzioni ClickOnce vengono installate con privilegi utente.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di documento e di applicazione per Microsoft Office 2010 e Microsoft Office System 2007. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Se si utilizza Windows Installer per distribuire i file, è necessario comunque rispettare i requisiti di sicurezza di Runtime di Visual Studio Tools per Office e di ClickOnce prima che gli utenti possano eseguire le soluzioni Microsoft Office. Per ulteriori informazioni sul modello di sicurezza per le soluzioni Office, vedere Sicurezza delle soluzioni Office.

Il vantaggio principale all'utilizzo di Windows Installer è la distribuzione di soluzioni Office a tutti gli utenti, anziché solo all'utente corrente. Per ulteriori informazioni sulla distribuzione delle soluzioni Office con Windows Installer, vedere Distribuzione di una soluzione Office tramite Windows Installer.

Per informazioni generali su ClickOnce, vedere Sicurezza e distribuzione di ClickOnce.

Il processo di distribuzione include le seguenti considerazioni:

Requisiti della soluzione Office.
Distribuzione di una soluzione Office.
Installazione di una soluzione Office.
Aggiornamento di una soluzione Office.
Distribuzione durante lo sviluppo.
Cache ClickOnce.

Requisiti della soluzione Office

Per eseguire le soluzioni Microsoft Office, è necessario installare alcuni componenti nel computer, ad esempio .NET Framework 3.5 e Runtime di Visual Studio Tools per Office. È spesso possibile distribuire questi componenti insieme alla soluzione. Per l'elenco dei componenti richiesti, vedere Prerequisiti per la distribuzione delle soluzioni Office e Procedura: installare i prerequisiti nei computer degli utenti finali per l'esecuzione delle soluzioni Office.

È inoltre necessario considerare come rendere le soluzioni attendibili. Per informazioni sulla sicurezza, vedere Sicurezza delle soluzioni Office.

Distribuzione di una soluzione Office

Quando si distribuisce una soluzione Office, è possibile utilizzare la Pubblicazione guidata o la pagina delle proprietà Pubblica per configurare le seguenti impostazioni di distribuzione:

Numero versione.
Prerequisiti.
Intervalli di aggiornamento.

Dopo aver configurato queste impostazioni di distribuzione, Visual Studio consente di pubblicare i file della soluzione nel percorso di pubblicazione.

Se la distribuzione viene eseguita tramite un CD o un'unità rimovibile, lasciare vuota l'opzione Percorso di installazione e impostare l'opzione Aggiornamenti su Mai. Per ulteriori informazioni, vedere Procedura: distribuire una soluzione Office utilizzando ClickOnce e Pubblicazione di soluzioni Office.

Installazione di una soluzione Office

Una volta che la soluzione è stata copiata nel percorso di installazione, gli utenti finale possono scaricarla e installarla. È possibile installare le soluzioni in molti modi diversi: eseguendo il programma di installazione, aprendo il manifesto di distribuzione (file con estensione vsto) o aprendo il documento. Per ulteriori informazioni, vedere Procedura: installare una soluzione Office ClickOnce e Procedura: disinstallare una soluzione Office ClickOnce.

Se gli utenti installeranno la soluzione aprendo il manifesto di distribuzione, potrebbe essere necessario configurare il server IIS per riconoscere il tipo MIME di vsto. Per ulteriori informazioni, vedere Procedura: preparare IIS per la distribuzione di soluzioni Office.

Distribuzione avanzata

Se si desidera creare un programma di installazione personalizzato per la soluzione Office, è possibile eseguire direttamente il programma di installazione della soluzione Office (VSTOInstaller.exe). Per ulteriori informazioni, vedere Personalizzazione dell'installazione delle soluzioni Office.

In alternativa, è possibile distribuire i progetto a livello di documento e di applicazione in un solo pacchetto e installare e disinstallare le soluzioni combinate come un gruppo. Ad esempio, se la società Contoso Software sviluppa un componente aggiuntivo di Outlook e un foglio di lavoro di Excel, è possibile installare e disinstallare insieme questi progetti come Contoso Office Solutions tramite Installazione applicazioni in Windows XP o Programmi e funzionalità in Windows Vista. Per ulteriori informazioni, vedere Procedura dettagliata: distribuzione di più soluzioni Office in un unico programma di installazione ClickOnce per .NET Framework 4.

Se è necessario eseguire azioni aggiuntive dopo l'installazione, è possibile personalizzare l'installazione in un processo denominato azione post-distribuzione. Ad esempio, è possibile copiare documenti o cartelle di lavoro nel computer dell'utente finale, creare chiavi del Registro di sistema aggiuntive o modificare un file di configurazione. Per ulteriori informazioni, vedere Procedura dettagliata: copia di un documento nel computer dell'utente finale dopo un'installazione ClickOnce.

Aggiornamento di una soluzione Office

È possibile configurare la soluzione in modo da verificare la disponibilità di aggiornamenti a intervalli specificati e installare gli aggiornamenti automaticamente. L'impostazione predefinita per gli aggiornamenti automatici è ogni sette giorni. Dopo aver impostato questo intervallo e installato la soluzione, l'intervallo non può essere modificato senza installare un aggiornamento. Se gli utenti desiderano eseguire un aggiornamento al di fuori degli intervalli di aggiornamento normali, è possibile aggiornare manualmente la soluzione Office.

È possibile distribuire gli aggiornamenti utilizzando la Pubblicazione guidata. La Pubblicazione guidata genera un nuovo manifesto dell'applicazione e copia i file della soluzione nello stesso percorso di pubblicazione della versione precedente. Gli aggiornamenti sono facoltativi e gli utenti possono annullare qualsiasi aggiornamento della soluzione durante la fase di download continuando a eseguire il componente aggiuntivo.

L'azione di pubblicazione inoltre aggiorna il manifesto di distribuzione in modo che punti al percorso della nuova versione della soluzione. Quando la soluzione installata dall'utente finale esegue il controllo degli aggiornamenti all'intervallo specificato, scaricherà e installerà la versione distribuita più recentemente. È possibile aggiornare le versioni di una soluzione aggiornando i manifesti e i file della soluzione nel percorso di distribuzione. Per ulteriori informazioni, vedere Procedura: aggiornare le soluzioni Office distribuite.

Per eseguire il rollback a una versione precedente di una soluzione Office, vedere Procedura: Rollback di una soluzione Office ClickOnce a una versione precedente.

Per le situazioni in cui il percorso di pubblicazione è cambiato, il percorso può essere modificato nel programma di installazione senza dover ritornare a Visual Studio per utilizzare la Pubblicazione guidata o la pagina Pubblica di Progettazione progetti. Per ulteriori informazioni, vedere Procedura: modificare il percorso di installazione di una soluzione Office.

È possibile modificare manualmente i manifesti di applicazione e di distribuzione nelle soluzioni Office. Una volta modificati, i manifesti dell'applicazione e di distribuzione devono essere nuovamente firmati utilizzando lo Strumento per la generazione e la modifica di manifesti (mage.exe). Per ulteriori informazioni, vedere Procedura: modificare le proprietà di distribuzione.

Distribuzione durante lo sviluppo

Se si esegue il test del componente aggiuntivo a livello di applicazione pubblicando e installando la soluzione nel computer di sviluppo, disinstallare la soluzione prima di pubblicarla nuovamente o di apportare ulteriori modifiche al codice ed eseguirne di nuovo il test premendo F5. Quando si installa una soluzione pubblicata, l'assembly per il componente aggiuntivo viene installato nella cache ClickOnce. Il programma di installazione crea inoltre chiavi del Registro di sistema per consentire all'applicazione di Office di trovare e caricare l'assembly. Poiché la ricompilazione della soluzione comporta l'aggiornamento delle chiavi del Registro di sistema, è necessario disinstallare la prima versione prima di pubblicare o eseguire la seconda versione.

Per eseguire il test della distribuzione nel computer di sviluppo, creare un altro account utente per installare e testare il componente aggiuntivo a livello di applicazione.

Se si sviluppano più soluzioni Office, vengono eseguiti tutti i componenti aggiuntivi di Office poiché una compilazione è considerata un'installazione. Prima di chiudere una soluzione è consigliabile eseguire il comando Pulisci soluzione nel menu Compila.

Cache ClickOnce

Le soluzioni Office ClickOnce sono installate nella cache dell'applicazione ClickOnce o nella Global Assembly Cache. La cache ClickOnce è una famiglia di directory nascoste contenenti tutti i file della soluzione, inclusi gli assembly, i file di configurazione, le impostazioni dell'applicazione e dell'utente e le directory dei dati. Le soluzioni Office ClickOnce utilizzano la stessa cache delle applicazioni ClickOnce Windows Form. È possibile aprire i collegamenti ad altri indirizzi Internet o percorsi di rete mentre si utilizza la cache ClickOnce. La soluzione memorizzata nella cache può anche essere utilizzata in modalità offline. Per le personalizzazioni a livello di documento, il documento non viene installato nella cache ClickOnce e può essere posizionato nel computer di un utente o in una condivisione file di rete. Per ulteriori informazioni sulla cache ClickOnce, vedere Cenni preliminari sulla cache di ClickOnce.

È anche possibile archiviare gli assembly nella Global Assembly Cache. Se le soluzioni Office prevedono un'azione post-distribuzione (PDA) da eseguire dopo ogni installazione, è possibile archiviare tale azione nella Global Assembly Cache. Ad esempio, è possibile archiviare nella Global Assembly Cache le azioni post-distribuzione che devono essere eseguite dopo l'installazione di ogni modello Visio.

Migrazione dei dati durante l'aggiornamento delle soluzioni

Le soluzioni Office consentono di eseguire la migrazione dei dati memorizzati nella cache locale da una versione a quella successiva durante un aggiornamento.

Se si esegue un'istanza di una versione precedente di una soluzione durante un aggiornamento, non verrà eseguita la migrazione delle modifiche apportate ai dati memorizzati nella cache dell'istanza in esecuzione durante l'aggiornamento. Per assicurarsi che la migrazione dei dati venga effettuata correttamente, chiudere tutte le istanze di una soluzione prima di aggiornarla.

File di dati

I file con estensione xml, mdb e mdf vengono copiati automaticamente nella directory dei dati dell'applicazione. Non è possibile configurare questi file di dati nella finestra di dialogo File applicazione. Per individuare la directory dei dati, utilizzare la proprietà DataDirectory. Per ulteriori informazioni, vedere Accesso a dati locali e remoti in applicazioni ClickOnce.

Per individuare i file in una directory diversa tramite reflection, chiamare il metodo GetExecutingAssembly, quindi utilizzare la proprietà CodeBase o EscapedCodeBase per ottenere il percorso della directory. È quindi possibile utilizzare il percorso completo per individuare i file.