Distribuzione di componenti aggiuntivi a livello di applicazione (System 2003)

Articolo
04/28/2010

Aggiornamento: novembre 2007

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 Progetti a livello di applicazione Versione Microsoft Office Microsoft Office 2003 Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

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

Progetti a livello di applicazione

Versione Microsoft Office

Microsoft Office 2003

Per ulteriori informazioni, vedere la classe Funzionalità disponibili in base ai tipi di progetto e applicazione.

La distribuzione di un componente aggiuntivo di Microsoft Office 2003 creato con Visual Studio Tools per Office implica generalmente l'utilizzo dei file seguenti:

Assembly principale del componente aggiuntivo ed eventuali assembly dipendenti, ad esempio risorse, satelliti o librerie di supporto.
Manifesto di applicazione.
Eventuale manifesto di distribuzione.

Quando si distribuisce la soluzione, considerare le seguenti linee guida di base:

Gli utenti devono disporre di .NET Framework installato. Per ulteriori informazioni, vedere Ridistribuzione di .NET Framework e Utilizzo di più versioni di .NET Framework.
Gli utenti devono disporre di Visual Studio 2005 Tools per Office Second Edition Runtime installato. Per ulteriori informazioni, vedere la classe Procedura: preparare il computer degli utenti finali per l'esecuzione delle soluzioni Office (System 2003).

Il runtime Visual Studio Tools per Office include AddinLoader.dll, il caricatore dei componenti aggiuntivi di Microsoft Office 2003 creati tramite Visual Studio Tools per Office. Per ulteriori informazioni, vedere la classe Architettura dei componenti aggiuntivi a livello di applicazione.
Ogni computer client deve presentare un insieme di voci del Registro di sistema necessarie per eseguire il componente aggiuntivo. Per ulteriori informazioni, vedere Voci del Registro di sistema per i componenti aggiuntivi a livello di applicazione.
All'assembly del componente aggiuntivo e a tutti gli assembly a cui viene fatto riferimento deve essere concessa l'attendibilità totale nei criteri di sicurezza di ciascun utente finale. Per ulteriori informazioni, vedere la classe Requisiti di sicurezza per l'esecuzione delle soluzioni Office (System 2003).

Per distribuire il componente aggiuntivo, effettuare le operazioni seguenti:

Copiare in ogni computer client il manifesto dell'applicazione generato dal processo di compilazione e le voci del Registro di sistema necessarie.
Copiare nel percorso di distribuzione gli assembly del componente aggiuntivo ed eventualmente il manifesto di distribuzione.

Il percorso di distribuzione può essere una cartella locale del computer client o un percorso remoto, ad esempio una condivisione di rete. Per ulteriori informazioni, vedere°Modelli di distribuzione (2003 System) e Procedura: distribuire le soluzioni Office (2003 System).

Nota:
Non esiste un'opzione di distribuzione che consenta agli utenti finali di utilizzare la finestra di dialogo Componenti aggiuntivi COM delle applicazioni di Microsoft Office 2003 allo scopo di installare un componente aggiuntivo creato utilizzando Visual Studio Tools per Office.

Utilizzo del progetto di installazione

Quando si crea un progetto di componente aggiuntivo utilizzando Visual Studio Tools per Office, alla soluzione viene aggiunto automaticamente un progetto di installazione. Se si desidera distribuire la soluzione direttamente nel computer client, è possibile utilizzare questo progetto di installazione per generare un file Windows Installer (con estensione MSI). Il programma di installazione copia i file della soluzione nel computer client e crea le voci del Registro di sistema necessarie per eseguire il componente aggiuntivo. Per ulteriori informazioni sul progetto di installazione, vedere Progetti di installazione dei componenti aggiuntivi a livello di applicazione (2003 System). Per ulteriori informazioni sulle voci del Registro di sistema necessarie, vedere Voci del Registro di sistema per i componenti aggiuntivi a livello di applicazione.

Limitazioni del progetto di installazione

Il progetto di installazione predefinito presenta varie limitazioni:

Per impostazione predefinita, nel progetto di installazione non vengono impostati i criteri di sicurezza. All'assembly del componente aggiuntivo e agli eventuali assembly a cui si fa riferimento deve essere concessa l'attendibilità totale affinché il componente aggiuntivo possa essere eseguito. È possibile aggiungere al progetto di installazione un passaggio che consenta la configurazione dei criteri di sicurezza. In alternativa, l'impostazione dei criteri di sicurezza appropriati può essere eseguita da un amministratore. Per ulteriori informazioni, vedere la classe Requisiti di sicurezza per l'esecuzione delle soluzioni Office (System 2003).
Per impostazione predefinita, il progetto di installazione non controlla né installa il runtime Visual Studio Tools per Office e l'assembly di interoperabilità primario per l'applicazione di Microsoft Office. Se questi componenti non sono installati nel computer dell'utente finale, il componente aggiuntivo non verrà eseguito. Per ulteriori informazioni sui prerequisiti, vedere Procedura: preparare il computer degli utenti finali per l'esecuzione delle soluzioni Office (System 2003).

Utilizzo della Pubblicazione guidata

Se si desidera abilitare gli aggiornamenti automatici dell'assembly, è possibile utilizzare la Pubblicazione guidata. La Pubblicazione guidata crea un manifesto di distribuzione per la soluzione e copia tutti i file necessari nel percorso di distribuzione.

Il comando Pubblica del menu di scelta rapida del progetto in Esplora soluzioni consente di avviare la Pubblicazione guidata. È sufficiente identificare il percorso della cartella in cui si desidera pubblicare la soluzione. Il manifesto di distribuzione verrà copiato automaticamente in tale cartella. Gli assembly e un manifesto di applicazione aggiornato vengono inoltre copiati in una sottocartella della cartella di distribuzione principale. Il nome della sottocartella contiene un numero di versione. Se si seleziona l'opzione Incrementa automaticamente revisione a ogni versione nel riquadro Pubblica di Progettazione progetti, verrà creata una nuova sottocartella ogni volta che si pubblica la soluzione. Le versioni precedenti rimangono disponibili. I manifesti dell'applicazione e di distribuzione garantiscono l'utilizzo dell'assembly corretto da parte della soluzione. Per ulteriori informazioni, vedere Manifesti dell'applicazione e di distribuzione nelle soluzioni di Office, Procedura: distribuire file di soluzione utilizzando la Pubblicazione guidata (2003 System) e Pagina Pubblica, Progettazione progetti (System 2007).

Limitazioni della Pubblicazione guidata

La Pubblicazione guidata presenta varie limitazioni:

Le voci del Registro di sistema necessarie per eseguire il componente aggiuntivo non vengono create dalla Pubblicazione guidata. Se si utilizza la Pubblicazione guidata per distribuire un componente aggiuntivo, tali voci dovranno essere create manualmente, ad esempio utilizzando un file del Registro di sistema (con estensione REG). Con la Pubblicazione guidata inoltre le voci del Registro di sistema create nel computer di sviluppo al momento della compilazione del progetto non vengono né sovrascritte né rimosse. Per ulteriori informazioni sulla compilazione di progetti, vedere Cenni preliminari sul processo di generazione delle soluzioni Office. Per ulteriori informazioni sulle voci del Registro di sistema necessarie, vedere Voci del Registro di sistema per i componenti aggiuntivi a livello di applicazione.
Con la Pubblicazione guidata non viene concessa l'attendibilità totale all'assembly del componente aggiuntivo nei criteri di sicurezza dell'utente finale. All'assembly del componente aggiuntivo e agli eventuali assembly a cui si fa riferimento deve essere concessa l'attendibilità totale affinché il componente aggiuntivo possa essere eseguito. Per ulteriori informazioni, vedere la classe Requisiti di sicurezza per l'esecuzione delle soluzioni Office (System 2003).

Aggiornamento di assembly distribuiti (controllo delle versioni)

Se si distribuisce una soluzione denominata OutlookAddin1 nella cartella C:\DeployFolder, la struttura di file sarà simile alla seguente:

C:\DeployFolder

Questa cartella contiene il file e la sottocartella indicati di seguito:

Il manifesto di distribuzione, ovvero OutlookAddin1.application.

C:\DeployFolder\OutlookAddin1_1.0.0.0

La cartella contiene i file seguenti:
- Gli assembly.
- Il manifesto di applicazione, ovvero OutlookAddin1.dll.manifest.
- Una copia del manifesto di distribuzione.

Se si aggiorna l'assembly e si ripubblica la soluzione, la struttura di directory risulterà simile alla seguente:

C:\DeployFolder

Questa cartella contiene il file e le sottocartelle indicati di seguito:

Il manifesto di distribuzione, aggiornato in modo da puntare al manifesto di applicazione in C:\DeployFolder\OutlookAddin1_1.0.0.1.

C:\DeployFolder\OutlookAddin1_1.0.0.0

La cartella contiene i file seguenti:
- Gli assembly originari.
- Il manifesto di applicazione originario.
- Il manifesto di distribuzione originario.
C:\DeployFolder\OutlookAddin1_1.0.0.1

La cartella contiene i file seguenti:
- Gli assembly aggiornati.
- Il manifesto di applicazione aggiornato.
- Una copia del manifesto di distribuzione aggiornato.

Questa struttura verrà ripetuta ogni volta che si aggiorna l'assembly del componente aggiuntivo.

Utilizzo di MSBuild dalla riga di comando

La pubblicazione della soluzione può anche essere effettuata utilizzando MSBuild a un prompt dei comandi. Quando si utilizza MSBuild a un prompt dei comandi, è possibile pubblicare i file di soluzione in un percorso e contemporaneamente modificare il manifesto di distribuzione e il manifesto di applicazione aggiornato in modo che puntino a un percorso diverso. Per eseguire MSBuild dal prompt dei comandi per pubblicare la soluzione, utilizzare la sintassi seguente:

msbuild.exe /target:Publish /property:UpdateUrl=<update location> /property:PublishDir=<publish location> <project file>

Se ad esempio si desidera pubblicare un progetto C# denominato OutlookAddin1 nella cartella condivisa \\PublishServer\PublishFolder ma si prevede di spostare in futuro il manifesto di distribuzione, il manifesto dell'applicazione aggiornato e l'assembly del componente aggiuntivo nella cartella condivisa \\DeploymentServer\DeploymentFolder, eseguire il comando riportato di seguito.

msbuild.exe /target:Publish /property:PublishDir=\\PublishServer\PublishFolder\ /property:UpdateUrl=\\DeploymentServer\DeploymentFolder\ C:\OutlookAddin1\OutlookAddin1.csproj

Per ulteriori informazioni sull'utilizzo di MSBuild a un prompt dei comandi, vedere Compilazione di applicazioni ClickOnce dalla riga di comando.

Distribuzione di componenti aggiuntivi in Windows Vista

Se gli utenti finali eseguono la soluzione in Windows Vista, è necessario prendere in considerazione le restrizioni di sicurezza di Windows Vista quando si configura la distribuzione, altrimenti gli utenti non saranno in grado di installare gli aggiornamenti.

Se si utilizza la Pubblicazione guidata per pubblicare gli aggiornamenti del componente aggiuntivo in un percorso HTTP o in un percorso di rete, gli utenti finali dei computer che eseguono Windows Vista possono caricare gli aggiornamenti dell'assembly solo se si verificano le condizioni seguenti:

Il manifesto dell'applicazione viene installato in una cartella nel computer dell'utente finale che può essere modificata da un'applicazione con le autorizzazioni standard.

-oppure-
L'utente esegue l'applicazione di Microsoft Office con le autorizzazioni di amministratore.

Quando si pubblica un aggiornamento di un componente aggiuntivo, il runtime Visual Studio Tools per Office tenta di copiare il manifesto dell'applicazione aggiornato sul computer dell'utente finale la volta successiva in cui l'utente apre l'applicazione. Il runtime utilizza quindi le informazioni del manifesto aggiornato per caricare l'assembly aggiornato. In Windows Vista, le applicazioni eseguite con le autorizzazioni standard non possono sovrascrivere i file di determinate cartelle, inclusa la cartella %ProgramFiles%. Pertanto, se il manifesto dell'applicazione viene installato in una cartella che richiede le autorizzazioni di amministratore, l'applicazione può caricare l'assembly aggiornato solo se l'utente esegue l'applicazione in qualità di amministratore. In alternativa, l'utente può eseguire l'applicazione con le autorizzazioni standard se il manifesto dell'applicazione viene installato in una cartella che non richiede le autorizzazioni di amministratore, ad esempio %UserProfile%.

Nota:
Per impostazione predefinita, il progetto di installazione creato con i progetti di componente aggiuntivo installa il manifesto dell'applicazione in %CommonProgramFiles%.

Manifesti di applicazione e di distribuzione

I manifesti di applicazione e di distribuzione consentono a un componente aggiuntivo di aggiornarsi automaticamente in base all'ultimo assembly. Per ulteriori informazioni, vedere Manifesti dell'applicazione e di distribuzione nelle soluzioni di Office.

È possibile modificare il manifesto di applicazione o di distribuzione di una soluzione più volte nel corso dell'intera durata della soluzione. I manifesti in genere vengono aggiornati per due motivi principali: