Procedura: creare pacchetti dei componenti per utilizzare Visual Studio Content Installer

Articolo
08/11/2011

Visual Studio Content Installer consente di distribuire macro, componenti aggiuntivi e frammenti di codice per estendere Visual Studio. Per ulteriori informazioni su altre strategie di distribuzione, vedere Visual Studio Extension Deployment.

Per rendere installabile un'estensione tramite il Content Installer di Visual Studio, comprimere l'estensione in un file con estensione vsi, che viene in genere definito componente della community. Con Visual Studio Content Installer gli elementi nei componenti della community vengono copiati automaticamente nelle directory corrette del computer dello sviluppatore, in modo che vengano visualizzati nelle finestre di dialogo appropriate di Visual Studio.

Per utilizzare Visual Studio Content Installer per l'installazione dei componenti della community, è necessario creare un file vscontent per il componente. Dopo aver creato il file vscontent, è necessario comprimere i file del componente e il file vscontent in un file ZIP e quindi modificare questa estensione in VSI. A questo punto è possibile distribuire il file VSI ad altri sviluppatori con il metodo desiderato: rendendolo disponibile per il download dal Web, inviandolo come allegato di posta elettronica o inserendolo in una condivisione di rete.

File con estensione vscontent

I file con estensione vscontent utilizzano XML basato su Riferimento allo schema di Visual Studio Content Installer per descrivere i componenti creati e che si desidera condividere. Il file con estensione vscontent identifica almeno il tipo di componenti e la versione di Visual Studio con cui devono essere utilizzati i componenti. Dopo avere creato un file con estensione vscontent, è possibile creare il file con estensione vsi che verrà utilizzato da Visual Studio Content Installer per installare i componenti nel computer di uno sviluppatore.

Per creare un file vscontent di base

Scegliere Nuovo dal menu File, quindi fare clic su File.
Nella categoria Generale selezionare File XML, quindi fare clic su Apri.
Creare un file vscontent valido utilizzando Riferimento allo schema di Visual Studio Content Installer.

Nota

Il codice XML di esempio per i file vscontent è disponibile nelle sezioni di Esempio di questo argomento.
Salvare il file vscontent nella stessa directory che contiene gli altri file correlati al componente della community.

File VSI

I file di Visual Studio Content Installer (vsi) vengono utilizzati per lo scambio di contenuto Visual Studio nella community di sviluppatori. Un file vsi è un file zip rinominato che contiene i seguenti componenti:

Un file vscontent XML che descrive il componente della community.
I file per il componente.

In Visual Studio Content Installer, i file vsi vengono utilizzati per installare i contenuti condivisi nel percorso corretto. Per ulteriori informazioni sulle modalità di installazione dei file vsi, vedere Procedura: cercare e installare componenti della community.

Per l'implementazione di alcune funzionalità di Visual Studio Content Installer sono richiesti strumenti o servizi aggiuntivi.

Per visualizzare le informazioni sull'editore per il componente della community in Visual Studio Content Installer, è necessario firmare il file vsi. Per ulteriori informazioni, vedere Servizi di crittografia.
Per visualizzare un Contratto di licenza con l'utente finale (EULA) in Visual Studio Content Installer, è necessario incorporare queste informazioni nel file zip. WinZip supporta l'inserimento di informazioni incorporate tramite la funzione Comment. Per ulteriori informazioni su WinZip, vedere http://www.winzip.com/index.htm (informazioni in lingua inglese). Per ulteriori informazioni sulla funzione Comment, vedere la Guida di WinZip.

Per creare un file vsi di base

Creare un file .vscontent valido per il componente, se non ancora creato. Per ulteriori informazioni, vedere la sezione File VSCONTENT in questo argomento.
In Esplora risorse, selezionare i file richiesti per il componente, incluso il file vscontent.
Fare clic con il pulsante destro del mouse sui file selezionati e scegliere Invia a, quindi Cartella compressa.

I file selezionati verranno compressi in un unico file zip.
Rinominare l'estensione del file zip in vsi.

Esempio

Nell'esempio riportato di seguito è visualizzato un file vscontent per un file vsi che contiene un componente aggiuntivo. L'elemento <ContentVersion> viene impostato su 2.0, vale a dire che il componente aggiuntivo è compatibile solo con le versioni 9.0 e 10.0 di Visual Studio.

I file seguenti verranno inclusi nel file vsi per questo contenuto.

File vscontent contenente l'XML mostrato in questo esempio.
File di registrazione del componente aggiuntivo MyAddin.Addin.
Il file dll compilato del componente aggiuntivo MyAddin.dll.

I file del componente aggiuntivo vengono installati nella seguente directory:

n:\... \Documenti\Visual Studio <versione>\Addins\

Per ulteriori esempi, vedere Procedura: pubblicare modelli di progetto e Procedura: pubblicare frammenti di codice.

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005"> 
    <Content>
        <FileName>MyAddin.Addin</FileName>
        <FileName>MyAddin.dll</FileName>
        <DisplayName>Example Add-in</DisplayName>
        <Description>An add-in created for this example.</Description>
        <FileContentType>Addin</FileContentType>
        <ContentVersion>2.0</ContentVersion>
    </Content>
</VSContent>

Nell'esempio seguente è mostrato un file vscontent per un file vsi contenente un progetto macro che può essere utilizzato con le versioni 8.0, 9.0 e 10.0 di Visual Studio. I file seguenti verranno inclusi nel file vsi per questo contenuto.

File vscontent contenente l'XML mostrato in questo esempio.
File di macro MyMacroProject.vsmacros.

Il file di macro viene installato nella seguente directory:

n:\... \Documenti\Visual Studio <versione>\Projects\VSMacros80\

<VSContent xmlns="https://schemas.microsoft.com/developer/vscontent/2005">
    <Content>
        <FileName>MyMacroProject.vsmacros</FileName>
        <DisplayName>My Macro Project</DisplayName>
        <Description> A macro project created for this example.</Description>
        <FileContentType>Macro Project</FileContentType>
        <ContentVersion>1.0</ContentVersion>
    </Content>
</VSContent>